任意の MCP クライアントの WhatsApp: Gemini CLI、VS Code、Cursor、Devin Desktop (Windsurf) ほか
Streamable HTTP と OAuth に対応する任意の MCP クライアントは、WhatsApp Business 番号で利用できます。サーバーの URL を追加し、ブラウザで一度サインインすると、WhatsApp のツールが表示されます。違いは設定だけです。Cursor と Zed は url、Gemini CLI は httpUrl、Antigravity は serverUrl を使い、VS Code と Cline では転送方式を HTTP に設定する必要があります。
easyCoexistence は、1 つのリモート MCP サーバー https://easycoexistence.com/api/mcp を運用しています。
Gemini CLI で Streamable HTTP サーバーに使う設定キーです。ここでの url は SSE エンドポイントを指します。
Antigravity でリモートサーバーに使うキーです。url も使えますが、httpUrl と従来の SSE 転送方式はサポートされていません。
無料利用枠と Google One ユーザーについて、Gemini CLI が Antigravity CLI に置き換えられた日付。
Cline でリモートサーバーに設定する種類です。省略すると、Cline は従来の SSE 転送方式を既定とします。
Windsurf の新しい名称です。FAQ では、変わるのは名称とブランディングだけだとされています。
easyCoexistence の MCP サーバーは、ステートレスモードの Streamable HTTP で動作し、SSE ストリームを開きません。
リモート WhatsApp MCP サーバーに接続するには、クライアントに何が必要ですか?
必要なものは 3 つで、現在のほとんどのクライアントはこれをすべて備えています。Streamable HTTP とは、クライアントが 1 つの URL に POST する MCP の転送方式です。このサーバーはステートレスモードで動作し SSE ストリームを開かないため、SSE に設定されたクライアントは失敗します。OAuth ディスカバリー:最初の呼び出しでサーバーはメタデータへの参照を含む 401 を返します。クライアントは動的クライアント登録で自身を登録し、ブラウザを開きます。サインインには PKCE が使われます。そして、クライアントが動作しているマシン上のブラウザです。
設定にヘッダー、API キー、トークンは不要です。サーバーはプロトコルバージョン 2025-06-18、2025-03-26、2024-11-05 を受け付けます。ご自身のマシンで起動したローカルサーバーだけに対応するクライアントでは、接続できません。
各クライアントはどの設定を使いますか?
以下の各設定は、2026 年 11 月 11 日にそれぞれのクライアントの公式ドキュメントで確認したものです。どのクライアントも同じパターンで、名前と URL https://easycoexistence.com/api/mcp を指定します。ただし URL を保持するキーと、エントリを置く場所はクライアントごとに異なり、キーを誤ると失敗が静かに起きるクライアントもあります。各エントリに必要なのは名前と URL だけで、ヘッダーもトークンも不要です:
設定ファイルはどのような形式ですか?
ここに示すのは、サーバーをファイルに保存するクライアント向けのエントリで、各クライアントのドキュメントに掲載されている形式です。お使いのクライアント用のエントリを、上に記載されたファイルに貼り付け、既存のサーバーとマージしてください。その後クライアントを再読み込みし、開かれたサインインを完了させてください。コマンドやフォームを提供するクライアントでは、その操作で同じエントリが自動的に書き込まれます:
// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// VS Code with Copilot: ~/.copilot/mcp-config.json
{ "mcpServers": { "easycoexistence": { "type": "http", "url": "https://easycoexistence.com/api/mcp" } } }
// Gemini CLI: ~/.gemini/settings.json
{ "mcpServers": { "easycoexistence": { "httpUrl": "https://easycoexistence.com/api/mcp" } } }
// Antigravity: ~/.gemini/config/mcp_config.json
{ "mcpServers": { "easycoexistence": { "serverUrl": "https://easycoexistence.com/api/mcp" } } }
// Zed: settings.json
{ "context_servers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// Cline: cline_mcp_settings.json
{ "mcpServers": { "easycoexistence": { "type": "streamableHttp", "url": "https://easycoexistence.com/api/mcp" } } }VS Code にはどのように追加しますか?
Copilot を選択した状態で、「Chat: Open Customizations」を実行し、「MCP Servers」を選んで、User グループの「Add Server (+)」を選択します。または、コマンドパレットから「MCP: Add Server」を実行すると、同じガイド付きの流れになります。HTTP (HTTP or Server-Sent Events) を選び、URL を貼り付け、サーバー ID として easycoexistence を入力したら、「Global」と「Copilot Global」を選びます。これは、そのマシン上のすべてのワークスペースで共有される個人用の設定です。VS Code から求められたら認可を完了してください。
Microsoft のリファレンスでは、servers キーを持つ従来の .vscode/mcp.json ファイルは非推奨のエディター管理形式とされ、新しい設定では Copilot 向けのファイルが推奨されています。ワークスペースルートの .mcp.json はサーバーをチームメンバーと共有できます。エントリにシークレットは含まれないため、コミットしても安全です。
Gemini CLI と Antigravity にはどのように追加しますか?
Gemini CLI では、「gemini mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp -s user」を実行します。-s user を付けないと、サーバーはプロジェクト内の .gemini/settings.json に保存されます。その後 /mcp auth easycoexistence を実行してサインインします。トークンの期限が切れた場合も、同じコマンドで再度サインインできます。Google によると、無料利用枠と Google One のユーザーについて、Gemini CLI は 2026 年 6 月 18 日に Antigravity CLI へ置き換えられました。
Antigravity では、serverUrl を含むエントリを、すべてのプロジェクト向けに ~/.gemini/config/mcp_config.json へ、または 1 つのワークスペース向けに .agents/mcp_config.json へ記述します。CLI では /mcp を実行すると、各サーバーの状態を表示する MCP Manager が開きます。IDE では、エージェントパネルの … を選択し、「MCP Servers」、「Manage MCP Servers」、「View raw config」の順に選びます。このサーバーは動的クライアント登録に対応しているため、クライアント ID は不要です。
Zed、Cline、Devin にはどのように追加しますか?
Zed では、Settings > AI > MCP Servers を開き、「Add Server」をクリックして「Add Remote Server」を選びます。エントリに Authorization ヘッダーがない場合、Zed は標準の MCP OAuth フローを実行します。Cline では、MCP Servers アイコン、続いて「Remote Servers」タブを開き、名前と URL を入力して「Streamable HTTP」を選び、「Add Server」をクリックします。Cline CLI からは、cline mcp add easycoexistence に URL と --transport http を付けて実行し、ウィザードの「Authorize OAuth」アクションを選びます。
Devin Desktop は Windsurf の新しい名称で、Agents ウィンドウの Customize > MCPs からサーバーを管理します。設定は ~/.config/devin/mcp_config.json またはプロジェクトの .devin フォルダーに保存されます。保存された認証情報が期限切れになると、サーバーに「Needs authentication」と表示されるので、「Authenticate」でサインインし直します。Devin CLI では、URL と -s user を付けて devin mcp add easycoexistence を実行します。既定のスコープはローカルのため、-s user を付けます。その後 devin mcp login easycoexistence を実行します。
すべてのクライアントで共通のことは何ですか?
URL の背後にあるすべてです。どのクライアントも同じ easyCoexistence アカウントにサインインし、list_numbers で同じ番号を確認でき、30 を超える同じツールを利用できます。Meta のルールも共通です。フリーテキストのメッセージが届くのは、過去 24 時間以内に連絡してきた相手だけです。テンプレートは API 経由でのみ送信され、Coexistence 番号は毎秒最大 20 件のメッセージを送信できます。送信系ツールには、すべてのクライアントで有効なプランが必要ですが、読み取り系ツールは引き続き利用できます。
異なるのは、クライアント側でのツール呼び出しの制御です。たとえば Cursor は既定では MCP ツールを使う前に承認を求めます。サーバーはクライアント接続時にツール一覧を送信し、変更は通知しません。そのため、アカウントで新機能が利用可能になったら、クライアントを再読み込みするか再接続してください。
設定方法
- Connect your numberSign up at easycoexistence.com and connect the number through Meta's Embedded Signup; the WhatsApp Business app keeps working on the phone.
- Add the serverUse your client's command or form, or paste its entry into the right file, with https://easycoexistence.com/api/mcp as the URL.
- Reload and sign inReload the client, then approve the browser sign-in it opens with your easyCoexistence account.
- Try a requestAsk "Which WhatsApp numbers do I have, and are they healthy?" and check that the client calls list_numbers.
よくある間違い
- Gemini CLI の settings.json に url と書くことです。そこでの url は SSE エンドポイントを意味し、このサーバーは SSE を開きません。httpUrl を使うか、gemini mcp add --transport http を使ってください。
- Cline のエントリで type を省くことです。Cline は従来の SSE 転送方式を使うため接続に失敗します。type を streamableHttp に設定してください。
- Gemini CLI や Devin CLI でスコープを指定せずにサーバーを追加し、別のフォルダーで見つからなくなることです。Gemini は既定でプロジェクトスコープ、Devin は既定でローカルスコープです。-s user を付けてください。
- ヘッドレスサーバーや SSH セッションからサインインすることです。Gemini CLI のドキュメントでは、その OAuth フローにはローカルのブラウザと localhost コールバックが必要とされています。サインインはご自身のマシンで実行してください。
OAuth サインインと、Coexistence で接続する WhatsApp Business 番号向けの 30 を超えるツールを備えています。接続状態の確認、メッセージ、テンプレート、ルーティング、自動化に対応し、Streamable HTTP に対応する任意のクライアントから利用できます。アプリはスマートフォンに残ります。すべての番号は 24 時間体制で監視され、アラートも届きます。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
ローカル版をインストールする必要はありますか?
いいえ。サーバーはリモートのみで提供されるため、インストールするパッケージも、実行し続ける npx コマンドやプロセスもありません。クライアントを閉じても、接続された番号には何も影響しません。
サインインの代わりに、ヘッダーに API キーを入れることはできますか?
いいえ。MCP サーバーが受け付けるのは、easyCoexistence 自身のサインインで発行された OAuth トークンだけです。create_api_key で発行された ec_live_ キーは、お客様の番号を接続するソフトウェア向けの REST API である Partner API のものです。MCP サーバーは開きません。
サインインの有効期間はどれくらいですか?
アクセストークンの有効期間は 1 時間で、クライアントはリフレッシュトークンを使って自動的に更新します。更新のたびに新しいリフレッシュトークンが発行され、リフレッシュトークンは 60 日間使われないと失効します。その期間を過ぎると、クライアントはサインインし直すよう求めます。
同じアカウントを複数のクライアントで同時に使えますか?
はい。各クライアントは個別にサインインするため、Cursor、VS Code、ターミナルのエージェントが同じ番号で並行して動作できます。1 つを削除しても、他の接続はそのまま維持されます。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日