Close Crm

mcp-close-crm

Close CRM MCP パック — Close（close.com）API v1 をラップします。

Pipeworx の一部です — AI エージェントを1875以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

ツール	説明
close_me	指定されたAPIキーの現在のCloseユーザーと組織を取得します。ユーザーID、名前、メールアドレス、およびそのキーでアクセスできる組織（ID付き）を返します。キーが機能することを確認し、組織のコンテキストを特定するために使用します。
close_search_leads	Closeのクエリ言語を使用して、リード（Close内の会社／アカウント）を検索または一覧表示します。リードのdata配列（id、display_name、連絡先、ステータス、カスタムフィールド付き）に加えて、has_moreとtotal_resultsを返します。queryパラメーターはCloseの検索構文を受け付けます。例：name:"Acme"、status_label:"Potential"、email_address:@example.com、lead_created_within:7d、またはフリーテキスト。すべてのリードを一覧表示する場合はqueryを省略します。_limit（最大200）と_skipでページネーションします。
close_get_lead	CloseのリードID（形式はlead_...）で単一のリードを取得します。表示名、説明、ステータス、連絡先、住所、商談、カスタムフィールド、タイムスタンプを含む詳細を返します。
close_list_opportunities	Close内の商談（パイプラインの取引）を一覧表示します。id、lead_id、ステータス、金額、通貨、確度、予想成約日を含む商談のdata配列に加えて、has_more／total_resultsを返します。1件のリードに絞り込むにはlead_idを指定し、組織全体を一覧表示する場合は省略します。_limit／_skipでページネーションします。
close_list_contacts	Close内の連絡先（人物）を一覧表示します。id、lead_id、名前、役職、メールアドレス、電話番号を含む連絡先のdata配列に加えて、has_more／total_resultsを返します。必要に応じてlead_idで1件のリードに絞り込めます。_limit／_skipでページネーションします。
close_list_activities	リードのアクティビティ（通話、メール、メモ、SMS、会議、ステータス変更）を一覧表示します。data配列（id、_type、type、date_created、およびタイプ固有のフィールド付き）に加えて、has_more／total_resultsを返します。lead_idが必要です。_limit／_skipでページネーションし、リードのタイムラインを順に取得します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "close-crm": {
      "url": "https://gateway.pipeworx.io/close-crm/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/close-crm/mcpのtools/listは、上記の表のツールに加えて、Pipeworx共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall、その他ゲートウェイ全体で利用できるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共通ツールがおよそ30個一覧表示されます。接続時のinitializeレスポンスに正確な範囲が示されます。これはその時点での正式な回答です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うことで、ask_pipeworx経由でカタログ全体を横断してルーティングし、このパックが扱わない質問にも、MCP サーバーを追加せずに回答できます。現時点では、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングのメリットを上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworxのフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1875以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworxですべてのツールを利用できます。

MCP クライアントをお持ちでない場合：HTTP経由で呼び出す

このパックでは独自のAPIキー（_apiKey）が必要です。当方ではAPIキーを代行していないため、APIキーなしで実行できるcurlの例はありません。ツールを確認するにはGET https://gateway.pipeworx.io/v1/tools/close_meを使用します。ツールを見つけるにはPOST https://gateway.pipeworx.io/v1/tools/search_packsに{"query":"..."}を指定します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "close-crm": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-close-crm"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-close-crm

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Close Crm data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT