MCP ツールリファレンス

各ツールは何をしますか？

読み取り：list_numbers は、接続済みの電話番号、ステータス、品質評価、メッセージング階層を返します。ほかのすべての呼び出しはここから始まります。get_number_health は、Meta の最新スナップショットに加え、最近の監視タイムライン、Webhook イベント、ポーラーのチェック結果をまとめて返します。get_api_credentials は、Graph API のベース URL、WABA id、phone number id、利用可能な場合はアカウント独自のアクセストークンを返します。

送信：send_message は 24 時間のウィンドウ内で自由文を送信します。この間の返信は無料です。send_template は承認済みのテンプレートを送信します。まだメッセージを送っていない相手との会話を始める方法です。list_templates、create_template、get_template_status は、テンプレートのライフサイクルを扱います。

接続設定：set_webhook_destination は受信メッセージとアプリからのエコーをシステムへ転送します。null を渡すと設定がリセットされます。get_connect_link は、新しい番号を接続するためのダッシュボードリンクと手順を返します。get_docs は、製品ドキュメントを Markdown として返します。

connection_id が重要なのはなぜですか？

特定の番号に指示を結び付ける値であり、アシスタントが推測できないためです。

番号に作用するすべてのツールは connection_id を受け取ります。その値を取得できる場所は list_numbers だけです。実際には、メッセージの送信を頼まれたアシスタントは最初に list_numbers を呼び出します。そのため、セッションの最初のリクエストは通常、それ以降より時間がかかります。

また、複数の番号を持つアカウントでも、仕組み上あいまいさがありません。デフォルトの番号も暗黙の選択もないため、番号を特定しない指示は推測されず、どの番号についての指示か確認されます。

料金の支払いが滞るとどうなりますか？

外部に作用する 4 個のツール、send_message、send_template、create_template、set_webhook_destination は制限されます。読み取りを行うツールはすべて引き続き利用できます。

これは見落としではなく、意図した仕様です。ブロックされた理由を確認できない、または番号の接続状態を確認できないアカウントは、サポートへの問い合わせ以外に復旧の道がありません。接続状態の監視も同じ読み取り機能に依存しているため、最も必要なときに監視を止めることになります。

その結果、料金の支払いが滞ったアカウントでも、自分の状態について質問でき、監視も継続されます。停止するのは、顧客に届く処理だけです。

よくある間違い

• コネクタがメッセージを受信すると考える。MCP はリクエストとレスポンスで動作し、受信トラフィックには Webhook が必要です。
• connection_id をハードコードする。list_numbers から取得する値であり、書き留めておくものではありません。
• 料金の支払いが滞ったアカウントは完全にオフラインだと考える。読み取りと監視は意図的に継続されます。

よくある質問

続きを読む