ConverZAP — WhatsApp (official API)

ConverZAP MCP サーバー

AI アシスタントやエージェント（Claude、ChatGPT、Cursor、Cline、エージェントフレームワークなど）を、ConverZAP 経由で WhatsApp に接続します。Meta が認証したテックプロバイダーとして、公式の WhatsApp Business Platform（Meta Cloud API）を利用できます。

このサーバーは、ConverZAP のワークスペースを MCP ツールとして公開します。連絡先の閲覧と管理、会話の閲覧、WhatsApp メッセージや承認済みテンプレートの送信、CRM パイプラインの管理、キャンペーンの実行、連絡先の自動化への登録、レポートの閲覧が可能です。すべてのツールは内部で ConverZAP public API (v1) を通じて実行されるため、すべての操作で、アカウントと同じ権限、スコープ、レート制限が適用されます。接続がメンバーのロールを超える権限を持つことはありません。

このリポジトリには、ホスト型サーバーのドキュメントと接続設定が含まれています。サーバー自体は ConverZAP のインフラストラクチャ上で稼働するため、インストールやセルフホストは不要です。

ツール

15 個のツールがあります。読み取りツールは自由に安全に呼び出せます。書き込みツールは、実行せずに検証する dry_run モードに対応しています。また、send_message と start_campaign は破壊的操作として指定されているため、アシスタントは事前に確認を求めます。

ツール	種類	内容
whoami	読み取り	アカウント、自分のロール、付与された権限、プラン、接続済みの WhatsApp 番号
find_contacts	読み取り	電話番号、名前、メールアドレス、ラベルで連絡先を検索
get_contact	読み取り	最近の会話と進行中の取引を含む、連絡先の詳細カード
list_conversations	読み取り	受信トレイの会話を一覧表示（対応中、人間による対応待ち、返信待ちなど）
read_conversation	読み取り	会話のメッセージと状態を確認（24 時間のウィンドウを含む）
list_templates	読み取り	承認済みの WhatsApp テンプレートを一覧表示
get_results	読み取り	受信トレイのレポートとキャンペーン結果
send_message	書き込み・破壊的	テキストまたは承認済みテンプレートを送信
schedule_message	書き込み	メッセージを後で送信するようスケジュール
update_conversation	書き込み	担当者の割り当て、解決、再開、スヌーズ、ラベル付け、メモの追加、AI エージェントへの引き継ぎまたは AI エージェントからの引き継ぎ
upsert_contact	書き込み	連絡先を作成または更新
manage_deal	書き込み	CRM の取引を作成、更新、またはステージ間で移動
create_campaign_draft	書き込み	キャンペーンを下書きとして作成
start_campaign	書き込み・破壊的	キャンペーンを開始
enroll_in_automation	書き込み	連絡先を自動化に登録（または登録解除）

メッセージのレート制限： 接続ごとに 1 分あたり 30 件、1 日あたり 300 件です（プラン独自の制限に加えて適用されます）。

必要条件

• public API を利用できるプランの ConverZAP アカウント。
• アプリの Settings → Public API で作成した API キー（czk_live_…）、または OAuth でサインインするためのアカウント。アクセス範囲はメンバーのロールに応じて設定されます。無料トライアルでは読み取り専用です。

接続

これは、次の場所にあるリモート MCP サーバー（Streamable HTTP）です。

https://mcp.converzap.com

認証方法は2 種類あります。お使いのクライアントで簡単な方法を選んでください。

オプション A — OAuth（リモート MCP に対応したクライアントに推奨）

Claude（カスタムコネクターとして）など、リモート MCP に対応したクライアントは OAuth を自動的に処理します。サーバーを URL で追加してサインインするだけです。ConverZAP にログインし、ワークスペースを選択して、付与する権限を確認します。書き込み権限は最初から選択されていません。

Server URL: https://mcp.converzap.com
Auth:       OAuth (the client opens the login automatically)

コピーや保存が必要な API キーはありません。トークンはクライアントが保持します。

オプション B — API キー（stdio のみ対応するクライアントを含め、あらゆる環境で動作）

キーを bearer ヘッダーとして送信します。stdio しか扱えないクライアント（デスクトップ環境の一部など）では、mcp-remote を使ってリモートサーバーに接続します。

{
  "mcpServers": {
    "converzap": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.converzap.com",
        "--header", "Authorization: Bearer ${CONVERZAP_API_KEY}"
      ],
      "env": { "CONVERZAP_API_KEY": "czk_live_…" }
    }
  }
}

ネイティブでリモート MCP に対応しているクライアントでは、URL https://mcp.converzap.com を直接追加し、ヘッダー Authorization: Bearer czk_live_… を設定することもできます。

プロンプトの例

• 「人間の対応を待っている未解決の WhatsApp の会話を一覧表示してください。」
• 「承認済みの lembrete テンプレートを連絡先に送信してください。」
• 「連絡先を作成し、その取引を交渉ステージに移動してください。」
• 「今週、メッセージはいくつ配信されましたか？」

セキュリティ

• アクセスはメンバーのロールとスコープに制限されます。OAuth では、最小限の権限を付与してください（書き込み権限はデフォルトでオフです）。API キーでは、必要なスコープだけを設定してキーを作成してください。
• API キーはパスワードと同じように扱い、サーバー側で保管してください。Settings → Public API でいつでもキーを無効にするか、OAuth 接続を解除できます。どちらも即座に反映されます。
• 脆弱性を見つけた場合は、[email protected] までメールでご連絡ください。公開の Issue は作成しないでください。SECURITY.md をご覧ください。

リンク

• API ドキュメント：https://developers.converzap.com
• OpenAPI：https://api.converzap.com/v1/openapi.json
• SDK：https://github.com/converzap/converzap-sdk
• ウェブサイト：https://converzap.com

ライセンス

MIT