Offorte MCP Server

Offorte MCP Server

Offorte 向け MCP サーバー — AI を使って提案書を作成し、送信します。

このサーバーは、AI エージェントと Offorte の提案書エンジンをつなぐブリッジとして機能します。 外部モデルが Offorte 経由で提案書を作成し、送信できるようにします。 自動化ワークフロー向けに構築された MCP により、AI ツール、チャットインターフェース、自律システムに提案書関連の操作を簡単に統合できます。

初期段階の技術 MCP（Model Context Protocol）は、AI 統合の新しいアプローチです。 強力な一方で、まだ進化の途上にあり、予期しない結果や望ましくない結果が生じる場合があります。

目次

• Offorte について
• 目標と対象範囲
• 前提条件
• 利用可能なツール
• MCP クライアント
• 開発

Offorte について

Offorte は、魅力的でインタラクティブな提案書の作成、送信、追跡を支援する提案書作成ソフトウェアです。 スピード、柔軟性、実際の業務での使いやすさを重視して構築されており、個人的なつながりを損なうことなく、自動化とスマートなワークフローを組み合わせています。 Offorte の詳細を見る。

API

この MCP サーバーは Offorte Public API v2 を使用します。 詳しくはAPI ドキュメントをご覧ください。

デモ

提案書の未来を体験してください。音声で起動し、AI を活用して完全に自動化します。 実際のデモで、Offorte が音声とワークフローをどのように結び付けるかをご覧ください。

目標と対象範囲

このプロジェクトの目標は、このプロトコルを使って AI で提案書を作成し、送信することです。 実験的な性質上、Offorte API のすべてを網羅しているわけではなく、提案書の作成と送信に必要なツールに限定されています。 LLM によるデータの更新や削除につながる可能性のあるツールは、まだ実装されていません。 更新および削除のコマンドは、実際の利用結果とユーザーからのフィードバックに基づいて、今後追加される可能性があります。

前提条件

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

利用可能なツール

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

• 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 でのみテストされています。 クライアントの例は今後追加される予定です。

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>"
			}
		}
	}
}

Local 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>"
			}
		}
	}
}

開発

リポジトリをクローンし、依存関係をインストールして開始します。 .env ファイルがあり、適切な値が設定されていることを確認してください。

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

コマンド

すべてのコマンドについては NPM スクリプトを確認してください。以下に、特に重要なものを簡単にまとめています。

スクリプト	説明
pnpm build	本番環境用にプロジェクトをビルドします
pnpm start	本番サーバーを起動します
pnpm dev	開発サーバーを起動します
pnpm inspect	サーバーを検査します
pnpm format	Prettier と ESLint を使用してコードをフォーマットします