Wassenger Whatsapp Connector

公式 WhatsApp Business API 用 WhatsApp MCP サーバー

ホスト型の Model Context Protocol サーバーです。 Claude、Cursor、VS Code、OpenAI API、その他あらゆる MCP クライアントから、 公式 WhatsApp Business API を通じて WhatsApp を利用できます。メッセージの送受信、 承認済みテンプレートを使った返信、キャンペーンの実施、連絡先の管理、共有チーム受信トレイの 運用が可能です。

Wassenger が運営しています。インストールは不要です。 クライアントの接続先を https://api.wassenger.com/mcp に設定し、Authorization ヘッダーに Wassenger API キーを指定してください。Claude と ChatGPT のウェブ版にはヘッダーを指定する欄が ないため、接続先アドレスにキーを含めてください。

Remote URL:  https://api.wassenger.com/mcp
Transport:   Streamable HTTP
Auth:        Authorization: Bearer <WASSENGER_API_KEY>
             or https://api.wassenger.com/mcp?key=<WASSENGER_API_KEY> for clients without headers

Business API と個人アカウントのどちらを選ぶべきですか？

WhatsApp MCP サーバーには 2 種類あり、それぞれ解決する問題が異なります。

	このサーバー（Wassenger）	lharries/whatsapp-mcp などの個人アカウント用サーバー
接続方法	公式 WhatsApp Business API（Meta Cloud API）	WhatsApp Web デバイスとして個人アカウントをリンク
セットアップ	ホスト型。URL と API キーを追加	Go ブリッジと Python サーバーをローカルで実行し、QR コードをスキャン
24 時間のウィンドウ外のメッセージ	はい。承認済みテンプレートを使用	テンプレートなし
1 つの番号を複数人で利用	共有受信トレイ、チャットの割り当て、部署、ラベル	1 ユーザー
キャンペーンと一括送信	はい。配信キューで送信間隔を調整	いいえ
メッセージの保存先	Wassenger アカウント	お使いのコンピューター上の SQLite データベース
WhatsApp の規約	Meta がビジネス向けに提供する API を使用	WhatsApp の利用規約では非公式クライアントが許可されていないため、番号が制限される可能性があります
費用	Wassenger のサブスクリプション。テンプレートメッセージの料金は Meta から直接請求	無料のオープンソース

Claude で自分の個人チャットを読み取って検索するだけなら、個人アカウント用サーバーのほうが 簡単です。WhatsApp を使ってビジネスで顧客とやり取りする場合は、Business API をお使いください。

クイックスタート

1. Wassenger アカウントを作成し、WhatsApp Business 番号を接続します。
2. app.wassenger.com/apikeys から API キーをコピーします。
3. 以下の設定のいずれかを使って、クライアントにサーバーを追加します。
4. 「接続されている WhatsApp 番号を教えて」と尋ね、動作を確認します。

クライアントを接続する

Claude（ウェブ版とデスクトップアプリ）

Customize → Connectors を開き、+ をクリックして Add custom connector を選択します。 名前を付け、キーを含むアドレスを貼り付けます。

https://api.wassenger.com/mcp?key=YOUR_WASSENGER_API_KEY

Add をクリックします。チャットで + メニューを開き、Connectors を選択して有効にします。 Team プランと Enterprise プランでは、カスタムコネクターを追加できるのはオーナーだけです。 また、コネクターを使う全員でそのキーを共有します。

ChatGPT（ウェブ版）

ChatGPT のウェブアプリからカスタム MCP サーバーに接続するには、OpenAI が開発者モードを有効に しているプランが必要です。また、ワークスペース管理者が開発者モードを有効にする必要があります。 Apps → Create を開き、同じアドレスを貼り付け、No authentication を選択して Scan tools をクリックし、続けて Create をクリックします。このサーバーは OAuth メタデータを 公開していないため、OAuth を選択すると失敗します。

Claude Code

claude mcp add --transport http wassenger https://api.wassenger.com/mcp \
  --header "Authorization: Bearer YOUR_WASSENGER_API_KEY"

ローカルサーバーのみを実行するクライアント

Claude Desktop のように、claude_desktop_config.json で設定したローカルプロセスしか起動できない クライアントもあります。このリポジトリの npm ブリッジ（mcp-wassenger）を使用してください。 ホスト型サーバーに接続し、Authorization ヘッダーにキーを指定します。

{
  "mcpServers": {
    "wassenger": {
      "command": "npx",
      "args": ["-y", "mcp-wassenger", "YOUR_WASSENGER_API_KEY"]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "wassenger": {
      "url": "https://api.wassenger.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_WASSENGER_API_KEY" }
    }
  }
}

VS Code

.vscode/mcp.json。初回に VS Code がキーを尋ね、安全に保存します。

{
  "inputs": [
    { "type": "promptString", "id": "wassenger-key", "description": "Wassenger API key", "password": true }
  ],
  "servers": {
    "wassenger": {
      "type": "http",
      "url": "https://api.wassenger.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wassenger-key}" }
    }
  }
}

OpenAI API（Responses API と Agents SDK）

import OpenAI from 'openai'

const openai = new OpenAI()

const response = await openai.responses.create({
  model: 'gpt-6.1-sol',
  input: 'Summarize the unread WhatsApp chats from today',
  tools: [{
    type: 'mcp',
    server_label: 'wassenger',
    server_url: 'https://api.wassenger.com/mcp',
    headers: { Authorization: `Bearer ${process.env.WASSENGER_API_KEY}` },
    require_approval: 'always'
  }]
})

その他のクライアント

Streamable HTTP と Authorization ヘッダーを使用してリモート URL に接続します。クライアントにヘッダーを指定する欄がない場合は、?key= 付きのアドレスを使用します。ローカルサーバーしか実行できない場合は、npm ブリッジを使用します：npx -y mcp-wassenger YOUR_WASSENGER_API_KEY。

質問できること

• 「今日の未読チャットを表示して、それぞれへの返信案を作成してください。」
• 「『invoice』に言及しているすべてのチャットを請求部門に割り当ててください。」
• 「追跡番号 1Z999 を添えて、+1 555 555 0100 に order_shipped テンプレートを送信してください。」
• 「今週、料金について問い合わせて返信がなかった顧客は誰ですか？」
• 「『VIP』のラベルが付いた連絡先を対象に、spring_offer テンプレートを使ってキャンペーンを作成してください。」
• 「Acme の案件を『Proposal sent』に移動し、今日の通話の要約をメモに追加してください。」
• 「この20件の番号が WhatsApp に登録されているか、インポートする前に確認してください。」
• 「今週、開始、解決、保留にしたチャットはそれぞれ何件ですか？」

ツール

50種類を超えるツールがあり、操作対象ごとに分類されています。

分野	ツールでできること
メッセージ	テキスト、メディア、位置情報、連絡先、予約済みメッセージの送信、返信、リアクション、転送
テンプレート	テンプレートの一覧表示、作成、削除、24時間のウィンドウ外での承認済みテンプレートの送信
チャット	ステータス、ラベル、エージェント、日付、未読でチャットを検索・絞り込み、メッセージ履歴の閲覧、チャットのエクスポート、チャット統計の確認
連絡先とラベル	連絡先の作成、検索、更新、インポート、ラベルの作成と適用
チーム受信トレイ	エージェントと部門の管理、チャットのチームメイトまたは部門への引き継ぎ、解決または再開、内部メモの追加、既読または未読への設定
キャンペーン	キャンペーンの作成、開始、停止、受信者の管理、配信キューの監視
セールスパイプライン	パイプラインとステージの作成、案件の追跡、案件へのメモとタスクの追加
WhatsApp Flows	フローの一覧表示、フローの送信、返信の確認
ファイル	URL からのファイルのアップロード、送受信ファイルの検索、メディアのダウンロード
電話番号とデバイス	接続済みの電話番号とそのステータスの一覧表示、電話番号が WhatsApp に登録されているかの確認

グループ、チャンネル、ステータス更新は、QR コードで接続された電話番号でのみ利用できます。公式の Business API ではこれらを利用できないためです。

セキュリティ

• クライアントに指定欄がある場合は、常に Authorization ヘッダーを使用してください。アドレス内のキー（?key=）はアクセスログ、プロキシログ、エラーレポート、ブラウザー履歴に残るため、漏えいしたものとして扱ってください。ウェブ版の Claude と ChatGPT では、そこでのみ使用するキーを作成し、アドレスが漏えいした場合はそのキーを失効させてください。
• このサーバーを使うエージェントは、顧客のメッセージを読んだり、あなたの名前でメッセージを送信したりできます。信頼できないメッセージの内容は信頼できない入力として扱ってください。上記の OpenAI の例と同様に、送信や削除を行うツールでは承認を有効にしておいてください。
• app.wassenger.com/apikeys から、いつでもキーを失効させることができます。

FAQ

Claude で使える WhatsApp MCP サーバーはありますか？ はい。公式 WhatsApp Business API を基盤とするこのサーバーは、ウェブ版とデスクトップアプリ版の Claude ではカスタムコネクターとして、Claude Code や任意の MCP クライアントでは利用できます。セットアップに必要なのは URL と API キーだけです。

AI エージェントとして WhatsApp を Claude や ChatGPT に接続するにはどうすればよいですか？ 電話番号を Wassenger に接続し、上記の設定を使って、このサーバーを Claude のカスタムコネクター、ChatGPT の開発者モードのアプリ、または OpenAI API を使用して構築したエージェントの MCP ツールとして追加します。すると、エージェントはチャットを読んだり、返信したり、テンプレートを送信したり、会話をチームの担当者に引き継いだりできます。

電話やコンピューターの電源を入れたままにする必要がありますか？ いいえ。Business API の電話番号は Meta のクラウド上で稼働し、MCP サーバーもホストされています。

過去 24 時間にメッセージを送っていない顧客にもメッセージを送れますか？ はい。Meta の承認を受けたテンプレートを使えば送信できます。自由形式のメッセージを送信できるのは、顧客からの最後のメッセージから 24 時間以内に限られます。これはすべてのプロバイダーに適用される WhatsApp のルールです。

無料ですか？ ホスト型サーバーは Wassenger アカウントに含まれています。また、このリポジトリの npm ブリッジは MIT ライセンスのオープンソースです。電話番号を接続した Wassenger アカウントが必要です。詳しくは料金をご覧ください。テンプレートメッセージの料金は Meta から直接請求されます。

リンク

• Wassenger · 料金 · API ドキュメント
• WhatsApp を Claude に接続する：ステップバイステップガイド
• Model Context Protocol

ライセンス

MIT