Offorte MCP Server

🚀 Offorte MCP Server

Offorte用のMCPサーバーです。AIを使って提案書を作成し、送信することができます。 このサーバーは、AIエージェントとOfforteの提案書エンジンの間の橋渡し役として機能します。 外部モデルがOfforteを介して提案書を作成し、送信できるようにします。 自動化ワークフロー向けに構築されたMCPにより、提案書のアクションをAIツール、チャットインターフェイス、自律システムに簡単に統合できます。

⚠️ 重要提示

MCP（Model Context Protocol）はAI統合の新しいアプローチです。 強力ですが、まだ進化段階にあり、時々予期せぬ結果や望ましくない結果を生み出すことがあります。

🚀 クイックスタート

このセクションでは、Offorte MCPサーバーの概要と始め方を説明します。

✨ 主な機能

• AIを使って提案書を作成し、送信することができます。
• 外部モデルとOfforteの提案書エンジンを接続します。
• 提案書のアクションをAIツールや自律システムに簡単に統合できます。

📦 インストール

前提条件

• Node.js (Node.js 20.x.xでテスト済み)
• Offorte API Key（Offorte API Docsの認証セクションを参照）
• 開発用にPNPM
• TRANSPORT_TYPE (オプション): Server-Sent Events (SSE)モードを有効にするにはsseに設定し、未設定またはデフォルトの場合はstdio (デフォルト: stdio)。

インストール手順

git clone https://github.com/offorte/offorte-mcp-server.git
cd offorte-mcp-server
pnpm install
pnpm dev

💻 使用例

基本的な使用法

Claude Desktopの設定

Claude > Settings > Developer > Edit Configからclaude_desktop_config.jsonを見つけ、以下のいずれかを追加してください（1つだけ）。

NPX

npmレジストリから直接実行する場合：

{
    "mcpServers": {
        "offorte-proposals": {
            "command": "npx",
            "args": ["-y", "@offorte/mcp-server"],
            "env": {
                "OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
                "OFFORTE_API_KEY": "<YOUR_TOKEN>"
            }
        }
    }
}

ローカルNode

依存関係をインストールし、プロジェクトをビルドしてから使用する場合（pnpm install）：

{
    "mcpServers": {
        "offorte-proposals": {
            "command": "node",
            "args": ["/path/to/directory/offorte-mcp-server/dist/server.js"],
            "env": {
                "OFFORTE_ACCOUNT_NAME": "<YOUR_ACCOUNT_NAME>",
                "OFFORTE_API_KEY": "<YOUR_TOKEN>"
            }
        }
    }
}

📚 ドキュメント

Offorteについて

Offorteは自動化提案書ソフトウェアで、企業が美しいインタラクティブな提案書を作成、送信、追跡するのを支援します。 速度、柔軟性、実際の使用を重視して構築され、個人的なタッチを損なうことなく自動化とスマートなワークフローを組み合わせています。 Offorteについて詳しく学ぶ

API

MCPサーバーはOfforte Public API v2を使用しています。 詳細についてはAPIドキュメントを読んでください。

デモ

音声トリガー、AI駆動、完全自動化された提案書の未来を体験してください。 この実際のデモでOfforteが音声とワークフローをどのように接続するかを確認してください。

目標と範囲

このプロジェクトの目標は、プロトコルを介してAIを使って提案書を作成し、送信することです。 実験的な性格上、完全なOfforte APIはカバーされておらず、提案書の作成と送信に必要なツールに限定されています。 LLMが内容を更新したり削除したりする可能性のあるツールはまだ実装されていません。 更新と削除コマンドは、実際の結果とユーザーフィードバックに基づいて将来追加される可能性があります。

利用可能なツール

コンテキストとセットアップ

• get_initial_context – 重要: 他のツールを使用する前に必ず呼び出して、コンテキストを初期化し、使用方法の説明を取得してください。

アカウント

• get_users – 現在のアカウントのすべてのアカウントユーザーをリストします。

自動化

• get_automation_sets – 新しい提案書を作成するためのオプション入力として使用される自動化セットをリストします。

連絡先

• create_contact – 新しい連絡先（組織または個人）を作成します。
• get_contact_details - IDで連絡先のすべての詳細を取得します。
• search_contact_organisations - 連絡先の中から名前で組織を検索します。
• search_contact_people - 連絡先の中から名前で個人を検索します。

お気に入り

• get_proposal_templates – 新しい提案書を作成するための起点として使用される提案書テンプレートをリストします。

提案書

• create_proposal – 新しい提案書を作成します。
• get_proposal_directories – ステータス別にグループ化されたすべての提案書ディレクトリを取得します。
• search_proposals – クエリで提案書を検索します。
• send_proposal – 提案書を割り当てられた連絡先に送信します。

設定

• get_design_templates – 新しい提案書を作成するために使用される利用可能なデザインテンプレートをリストします。
• get_email_templates – 提案書を送信するために使用される利用可能なメールテンプレートをリストします。
• get_text_templates – 新しい提案書を作成するために使用される利用可能な言語テキストテンプレートをリストします。

MCPクライアント

現在、このMCPサーバーはClaude Desktopでのみテストされています。 将来的には、より多くのクライアント例が追加されます。

🔧 技術詳細

開発

コマンド

NPMスクリプトを確認することで、すべてのコマンドを確認できます。以下は最も重要なコマンドの概要です。