WhatsApp ビジネス API と MCP で AI エージェントをすぐに連携させる方法

概要

AI アシスタントが WhatsApp の受信箱をチェックし、注文を確認・顧客へ返信できるようになる仕組みは、モデルコンテキストプロトコル（MCP）によって実現できます。MCP は主要な LLM エコシステム（Claude、ChatGPT、Gemini、Cursor、Windsurf、VS Code Copilot）でサポートされ、ほとんどのエージェントフレームワークでも利用可能です。本稿では、MCP 対応クライアントをライブ WhatsApp Business プラットフォームに 2 分以内で接続する手順を紹介します。SDK や自前サーバーは不要で、リモート MCP サーバーを利用します。

サーバー概要

Tokolaku は Meta の公式 WhatsApp Business API（クラウド API）を基盤にした、インドネシアの中小企業向け WhatsApp Business プラットフォームです。公開されたリモート MCP サーバーを提供しています。

接続手順 – オプション 1：OAuth 対応クライアント

最新の MCP クライアント（Claude、ChatGPT、Gemini、LibreChat など）は OAuth ディスカバリーに対応しており、URL を貼り付けるだけで接続できます。
1. クライアントの設定画面で「コネクタ」→「カスタムコネクタの追加」を開く。
2. 以下の URL を入力：`https://api.tokolaku.id/mcp`
3. Tokolaku アカウントでサインインし、アクセス許可を承認するとリダイレクトされます。

この操作で、アシスタントに 6 つの読み取り専用ツール（list_channels、list_conversations、get_conversation、list_products、list_orders、get_order）が追加されます。背後では PKCE、動的クライアント登録（RFC 7591）、標準検出メタデータ（RFC 8414/9728）が使用され、トークンはユーザー単位で短命かつダッシュボードから失効可能です。

接続手順 – オプション 2：API キー（コーディングエージェント・CLI・SDK）

書き込みアクセス（メッセージ送信）を行う場合は、開発者ダッシュボードから取得したシークレット API キーを使用します。ほとんどのコーディングエージェントやフレームワーク（Claude Code、Cursor、Windsurf、Cline、VS Code、OpenAI Agents SDK、LangChain 等）は同一の MCP サーバー構成規則を共有します。
* 任意の MCP クライアント SDK を `https://api.tokolaku.id/mcp` のストリーミング可能 HTTP URL に指定し、ヘッダー `x-api-key`（または `Authorization: Bearer`）でキーを渡す。
* キーのスコープに応じて利用可能なツールが決まり、`send_message` などの書き込みツールは REST API と同様の課金・クォータ・レートリミットが適用されます。

活用例

– 「今週の未払いの注文はありますか？誰にフォローアップすればよいかまとめてください。」
– 「昨日のチャットで最も質問が多かった製品はどれか？」
– 「今朝、+62812xxxx の顧客から注文について問い合わせがありました。会話を確認し、注文ステータスを見つけて、丁寧な最新情報を送信してください。」

なぜこのパターンが面白いのか

従来の「AI＋WhatsApp」構成では、デスクトップアプリのスクレイピングや独自のボットパイプライン構築が必要でした。リモート MCP サーバーを導入することで、プラットフォーム側が MCP をネイティブに扱い、エージェントは会話・カタログ・注文といった実際のビジネス状態に構造化されたアクセス権を取得できます。また、同一エンドポイントは従来の REST（POST `/api/v1/messages`、HMAC 署名付き Webhook）や公式 SDK（npm、PyPI、Packagist）も提供しているため、MCP 層は単なるデモではなく本格的な機能として位置付けられます。

参考リンク

– サーバーメタデータ: `https://github.com/Rustam335/tokolaku-mcp`
– API リファレンスと MCP ドキュメント: `https://tokolaku.id/api-docs`
– プラットフォーム（WhatsApp Business API、月額 Rp99,000）: `https://tokolaku.id/whatsapp-api`

お問い合わせ

ご質問や特殊なケースがございましたら、ぜひお知らせください。エージェントが WhatsApp の受信箱をどのように活用できるか、お話を伺えることを楽しみにしています。

元記事: https://dev.to/rustam335/give-your-ai-agent-whatsapp-superpowers-with-mcp-official-business-api-3f9l

概要