rdstation-crm-mcp

rdstation-crm-mcp

ブラジルおよびラテンアメリカを代表する CRM、RD Station CRM 向けのオープンソース MCP サーバーです。Claude や MCP 互換クライアントから、連絡先、商談、タスク、メモを管理し、パイプラインの健全性レポートを取得できます。

「今月の営業パイプラインはどうなっていますか？」→ ステージごとの合計、成約率、停滞しつつある商談を表示します。

導入の理由

RD Station CRM はラテンアメリカ市場で広く利用されていますが、オープンソースの MCP サーバーはありませんでした。このプロジェクトは RD Station CRM を MCP エコシステムに接続し、AI エージェントが見込み客の評価、商談の進行、フォローアップの予定設定、営業データに関する質問への自然言語での回答などを行えるようにします。

クイックスタート

1. RD Station CRM でインスタンストークンを取得します：プロフィール → 製品と連携 → インスタンストークン。
2. MCP クライアントにサーバーを追加します。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "rdstation-crm": {
      "command": "npx",
      "args": ["-y", "rdstation-crm-mcp"],
      "env": {
        "RDSTATION_CRM_TOKEN": "your-instance-token"
      }
    }
  }
}

Claude Code：

claude mcp add rdstation-crm -e RDSTATION_CRM_TOKEN=your-instance-token -- npx -y rdstation-crm-mcp

これで完了です。「未完了の商談を一覧表示して」や「パイプラインの概要を教えて」のように Claude に尋ねてみてください。

ツール

ツール	説明
rdcrm_search_contacts	名前、メールアドレス、電話番号で連絡先を検索します
rdcrm_get_contact	関連する商談を含む連絡先の詳細を取得します
rdcrm_upsert_contact	連絡先を作成します。メールアドレスが既に存在する場合は更新します
rdcrm_list_deals	ステータス、パイプライン、ステージ、担当者、日付で絞り込んで商談を一覧表示します
rdcrm_get_deal	ステージ、金額、担当者、連絡先、製品などの商談詳細を取得します
rdcrm_create_deal	商談を作成します — ステージは名前で指定でき、自動的に解決されます
rdcrm_update_deal	ステージの変更、担当者や評価、終了日の変更、一時停止／再開を行います
rdcrm_close_deal	成約または失注にします（失注理由は名前で解決されます）
rdcrm_list_tasks	商談、担当者、ステータス、種類、期限でタスクを一覧表示します
rdcrm_create_task	商談にタスク（電話、メール、会議、WhatsApp など）を作成します
rdcrm_add_note	商談のタイムラインにメモを追加します
rdcrm_pipeline_overview	パイプラインの健全性レポート：ステージごとの合計、成約率、停滞している商談

設計上のポイント

これらのツールは、1 対 1 の API ラッパーではなく、LLM 向けに設計されています。

• ID ではなく名前を使用。 ステージ、パイプライン、ユーザー、失注理由は名前で指定できます。サーバーはアカウント内で名前を解決し、一致するものがない場合は有効な選択肢を一覧表示します。
• 簡潔なレスポンス。 一覧表示ツールは、重要なフィールドを含むレコードごとの 1 行と、明示的なページネーションのヒントを返します。大きなレスポンスはコンテキストウィンドウを埋め尽くす代わりに、案内を添えて切り詰められます。
• 次の行動につながるエラー。 401 エラーでは確認すべき環境変数が示され、不明なステージが指定された場合は、すべてのパイプラインの全ステージが一覧表示されます。
• 重要な場面での集計。 rdcrm_pipeline_overview を 1 回呼び出すだけで、「商談が停滞しているのはどこか？」といった、人が実際に尋ねる質問に答えられます。

リモートデプロイ（Streamable HTTP）

デフォルト（rdstation-crm-mcp）は、単一のローカルユーザー向けに stdio 経由で実行され、トークンは RDSTATION_CRM_TOKEN から一度だけ読み込まれます。チームでホストするデプロイやレジストリに掲載するデプロイ（例：Smithery）では、代わりに Streamable HTTP 版を実行してください。

npx -y rdstation-crm-mcp-http

これにより、デフォルトで http://127.0.0.1:8080/mcp を使用する HTTP サーバーが起動し、適切なセッションライフサイクル（initialize → Mcp-Session-Id → 終了時の DELETE）を備えた MCP Streamable HTTP トランスポートを実装します。

ホスト型サーバーは複数のユーザーにサービスを提供できるため、暗黙的に使用される単一のトークンはありません。各セッションは initialize 時に、それぞれの Authorization: Bearer <token> ヘッダーを送信します。RDSTATION_CRM_TOKEN 環境変数は、すべての呼び出し元が同じ CRM アカウントを共有する、単一テナントのセルフホスト構成では、引き続きフォールバックのデフォルトとして使用できます。

環境変数：

変数	デフォルト	用途
PORT	8080	リッスンするポート
HOST	127.0.0.1	バインドアドレス — コンテナ／クラウドでは 0.0.0.0 を使用します
ALLOWED_HOSTS	(未設定)	Host ヘッダーの許可リスト（カンマ区切り）（DNS リバインディング対策）。前段にリバースプロキシを置かずに 0.0.0.0 にバインドする場合に推奨されます
RDSTATION_CRM_TOKEN	(未設定)	セッションが Authorization ヘッダーを送信しない場合に使用するデフォルトのトークン

curl http://127.0.0.1:8080/health
# {"status":"ok","server":"rdstation-crm-mcp","sessions":0}

開発

git clone https://github.com/fernandoludvig/rdstation-crm-mcp.git
cd rdstation-crm-mcp
npm install
npm test              # unit tests (API mocked with msw)
npm run typecheck
npm run build
RDSTATION_CRM_TOKEN=xxx npx @modelcontextprotocol/inspector node dist/index.js

HTTP レイヤー（src/client/）はツールから分離されており、429／5xx エラーに対する再試行と指数バックオフが組み込まれています。

ロードマップ

• 組織および製品向けツール
• 同じツールインターフェースでの RD Station CRM API v2（OAuth）対応
• リモートデプロイ向け Streamable HTTP トランスポート
• MCP レジストリ（Glama、PulseMCP、Smithery）への公開

コントリビューションを歓迎します。大きな変更については、まず issue を作成してください。

ライセンス

MIT © Fernando Ludvig

RD Station とは提携しておらず、同社の承認も受けていません。公開されている RD Station CRM API v1 を使用しています。