AI アシスタントに本物の WhatsApp 番号を。
MCP サーバーを使うと、Claude、ChatGPT、Cursor から WhatsApp を直接利用できます。番号の一覧表示、接続状態の確認、メッセージやメッセージテンプレートの送信、自社システムへの Webhook の設定が可能です。当社のサーバーは Meta の公式 Cloud API 上で動作するため、顧客がすでにメッセージを送っている番号が危険にさらされることはありません。
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}コネクタの実際の接続先
OAuth 経由でアクセスする 1 台のリモートサーバーが、WhatsApp Business アプリで引き続き使われている番号に対して、Meta が公開している Cloud API を呼び出します。セッションはどこにも保持されず、お使いのマシンでは何も実行されません。
- 1お使いのアシスタントClaude、ChatGPT、Cursor、Claude Code から MCP 経由で接続
- 2easycoexistence.com/api/mcpリモートで動作し、OAuth で認可。キーをどこかに貼り付ける必要はありません
- 3Meta Cloud API公開されている Graph エンドポイントを、アカウント自身のトークンで利用
- 4ビジネスの電話番号Coexistence で接続し、スマートフォンのアプリもそのまま動作
多くの WhatsApp 自動化は別の方法をとっています。リンク端末としてサインインし、WhatsApp Web のセッションを操作する方法です。これは WhatsApp の規約に違反しており、Meta は送信しているコードではなくトラフィックのパターンからそれを検知します。そのため、「BAN されない」という主張は、ベンダーが管理できないことを述べているにすぎません。ここではその仕組みを一切使っていません。
インストール方法
リモートエンドポイントは 1 つだけで、アカウント上のすべての番号で共通です。インストールするパッケージも、生成するキーもありません。各クライアントは最初にツールを呼び出したときに OAuth でサインインします。
- 設定を開き、コネクタに移動します。
- カスタムコネクタを追加を選び、以下のエンドポイントを貼り付けます。
- 保存したら、Claude に番号の一覧を表示するよう依頼してください。初回はサインイン画面が開きます。
https://easycoexistence.com/api/mcp- 設定を開き、コネクタ、詳細設定の順に進んで、開発者モードをオンにします。
- 以下のエンドポイントでコネクタを追加します。
- チャットを開始し、番号の一覧を表示するよう依頼してサインインを開始します。
https://easycoexistence.com/api/mcp- 任意のターミナルで以下のコマンドを実行します。
- Claude Code で /mcp を実行し、認証します。
- 以降は、すべてのセッションでツールを利用できます。
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- 設定を開き、MCP のセクションを探します。
- 以下の設定でサーバーを追加します。
- 再読み込みしてから、Cursor に番号の一覧を表示するよう依頼してください。
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}番号の接続は、ブラウザが必要な別の 1 回限りの手順です。Meta のオンボーディングでは専用のポップアップと QR コードのスキャンを使うためです。アシスタントからリンクを受け取りたい場合は、get_connect_link がそのリンクを返します。
アシスタントが失敗から学ばなくて済むよう、ツールが守らせるルール
send_message は、受信者が過去 24 時間以内にその番号へメッセージを送っている場合に使えます。こうした返信は無料です。期間外に届くのは、承認済みテンプレートを使った send_template だけです。ツールの説明にそのことが書かれているため、アシスタントは指示されなくても正しいツールを選びます。
Coexistence の番号では、スマートフォンのアプリからテンプレートを送信できません。予約送信、取引関連、期間外のメッセージはすべて API を経由する必要があり、それが番号を接続する大きな理由の 1 つです。
マーケティングメッセージの料金は、WhatsApp Manager で設定した WhatsApp Business アカウントの支払い方法に Meta から請求されます。当社を経由することはなく、当社が API からカードを追加することもできません。
HTTPS が必須で、hub.mode=subscribe とお客様の hub.verify_token を含む GET リクエストに対して、エンドポイントは hub.challenge をそのまま返す必要があります。当社は呼び出しの前に検証するため、誤った URL は接続済みに見えることなく、すぐにエラーになります。
16 個の WhatsApp ツールと、それぞれの実際の用途
1 つのコネクタで、アカウント上のすべての番号に対してこれらのツールを利用できます。ほかのチャンネル向けのツールも併せて提供されます。ほかの WhatsApp ツールはすべて list_numbers から connection_id を受け取るため、list_numbers が最初になります。
list_numbers接続済みの番号と、そのステータス、品質評価、メッセージングティア。ほかのすべての操作の出発点です。get_number_healthMeta のリアルタイムのスナップショットと、直近の監視タイムライン。Webhook イベントとポーリングによるチェックをまとめて表示します。get_api_credentialsGraph API のベース URL、WABA id、phone number id、そして利用可能な場合はアカウント自身のアクセストークン。
send_message自由形式のテキスト。24 時間のカスタマーサービスウィンドウ内でのみ送信できます。この期間内の返信は無料です。send_template先にメッセージを送ってきていない相手との会話を始める方法です。list_templatesアカウント上のメッセージテンプレートと、その審査ステータス。create_templateMeta に審査を申請します。UTILITY、MARKETING、AUTHENTICATION のいずれかで、{{1}} 形式の変数にはサンプル値が必要です。get_template_statusテンプレート名ごとに APPROVED、PENDING、REJECTED のいずれかを返します。
set_webhook_destinationMeta からの受信メッセージと、スマートフォンのアプリからのエコーを自社システムへ直接ルーティングします。null を渡すとリセットされます。get_connect_linkオンボーディングにはブラウザが必要なため、ダッシュボードのリンクと新しい番号を接続する手順を返します。get_docs製品ドキュメント全体を Markdown で返します。アシスタントは推測せず、当社のドキュメントに基づいて回答できます。
get_partner_setupPartner API の設定状況。請求、API キー、イベント URL、そして次に行うステップを返します。create_api_keyPartner API キーを発行し、一度だけ表示します。確認なしに既存のキーを置き換えることはありません。revoke_api_key確認のうえで Partner API キーを失効させます。以降、そのキーを使ったリクエストはすべて失敗します。set_partner_events_url接続ステータスのイベントの送信先を設定し、署名用シークレットを返します。シークレットは一度だけ表示されます。create_connect_linkお客様 1 人分のホスト型接続リンクを作成します。有効期間は 1 時間で、番号の料金はご自身のアカウントに請求されます。
支払いが途絶えても使えるもの
制限されるのは、外部に対して操作を行うツールと、送信に使うアクセストークンを渡す get_api_credentials です。健全性とステータスの読み取りは意図的に開放したままにしています。
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
ブロックされた理由を確認できず、番号が正常かどうかも確認できないアカウントは、サポートチケット以外に復旧の手段がありません。この 2 つの読み取りは、接続状態の監視そのものも支えています。
ほかの企業を支援する場合に重要な 2 つのツール
get_connect_link はクライアントが自分の番号を接続するために開くリンクを返し、set_webhook_destination は番号が接続された瞬間にその番号を自社システムへ向けます。この 2 つを組み合わせれば、誰もダッシュボードを開かずに、エージェントがクライアントのオンボーディングを最初から最後まで完了できます。
1 つのアカウントに必要な数だけ番号を登録でき、各番号は個別に請求されます。list_numbers は、ほかのすべてのツールが受け取る connection_id とともに、すべての番号を返します。
読み取り、送信、テンプレート、接続設定、ドキュメント、Partner API 用のツールをすべて以下に掲載しています。
Coexistence 番号の送信スループットは Meta が定める固定値です。EasyCoexistence でもお客様でも引き上げられません。
顧客からの返信によってセッションが開いたままになる期間です。期間外は承認済みテンプレートだけ送信できます。
サーバーはリモートにあるため、お使いのマシンでは何も実行されず、どこにもセッションは保持されません。
よくある質問
この仕組みが原因で顧客の番号が BAN される可能性はありますか?
いいえ。Meta の公式 Cloud API を、Meta 独自の Coexistence 機能を通じて利用します。BAN のリスクが語られるのは、リンク端末としてサインインする非公式ゲートウェイによるもので、これはまったく別の仕組みです。
このコネクタはどのアシスタントで使えますか?
OAuth を使った HTTP 経由の MCP に対応するものであれば利用できます。現在は Claude、ChatGPT、Cursor、Claude Code、Codex に対応しています。リモートのエンドポイントは 1 つだけなので、お使いのマシンでは何も実行されません。
会話は御社のサーバーを経由しますか?
デフォルトではいいえ。受信メッセージは Meta から指定した Webhook へ直接ルーティングされ、当社は会話内容を保存しません。接続の運用と監視に必要なアカウント、番号の状態、認証情報だけを保持します。
1 つのコネクタを複数の顧客に使えますか?
はい。1 つのアカウントに必要な数だけ番号を登録でき、各番号は個別の接続として請求されます。コネクタにはすべての番号が表示され、サポートする企業での利用に制限はありません。
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める3 日間無料。トライアル終了まで料金は一切発生しません。