- URL:
http://<host>:3000<APP_BASE_PATH>/mcp(デフォルトhttp://localhost:3000/mcp) - デフォルトで有効になっています。無効にするには、
MCP_ENABLED=falseまたは--mcp-enabled=falseを使用します。 - Stateless: 呼び出し間を生き続けるためのセッションハンドシェイクはありません。
古いリリースからアップグレードする場合、独立した
./whatsapp mcp コマンドと、ポート 8080 の SSE エンドポイント(/sse)は廃止されています。./whatsapp rest を実行し、クライアントの接続先を /mcp に設定してください。操作ごとに個別のツールを用意していた従来の構成は、以下の統合ツールに置き換えられました。クライアントに接続
/mcp は REST API と同じ Basic 認証の後ろに座っています。複数のデバイスを実行する場合は、Authorization ヘッダーを送信し、X-Device-Id を追加します。
YWRtaW46Y2hhbmdlbWU= は base64("admin:changeme"); echo -n 'user:pass' | base64 であなたのものを生成します。 Basic 認証がオフの場合は Authorization を、デバイスが 1 つだけの場合は X-Device-Id を省略します。
正確な設定形式はクライアントによって異なります。クライアントが stdio サーバーのみを起動できる場合は、mcp-remote などのブリッジを使用します。
ツール
GOWAは7つのツールを公開します。それぞれのツールはtype (send) または action (全ての他の) 引数をとり、操作を選択します。
引数に関する注意事項:
whatsapp_sendは常にtypeとphoneを必要とします。メディアは URL のみで送信されます (image_url,video_url,audio_url,file_url,sticker_url); MCP はローカルファイルをアップロードできません。linkにはlinkとcaptionが必要です。forwardにはmessage_idが必要です。whatsapp_sendは schedule fields (scheduled_at,timezone,recurrence,weekdays,day_of_month,end_at,occurrence_limit)を受け付けます。whatsapp_schedule(get、pause、resume、cancelはschedule_id)で結果を管理します。whatsapp_messageはphone(チャット)とmessage_id;editはmessageも必要です。- v9.9.0以降の GOWA
mainで、whatsapp_messageでaction: "edit"はmedia_type: "image"またはmedia_type: "document"でキャプションを置き換えます。 元のメディアタイプと一致し、linkを省略します。Edit a caption を参照してください。 whatsapp_chat:get_messagesはchat_jid;archiveはchat_jidとarchivedを必要とします。whatsapp_app:login_codeにはphoneが必要です。
HTTP_PROXY または HTTPS_PROXY なしで直接接続します。 ローカルファイルからのアップロードには、REST API が必要です。
MCP クライアントは各ツールの完全な入力スキーマを表示します。HTTP エンドポイントは POST と DELETEを受け付けます。GET SSEストリーミングは無効になります。
デバイス選択
各通話はこの順序でデバイスを解決します。- ツール呼び出しの
device_id引数。 - MCP 接続の
X-Device-Idヘッダー。 - 唯一の登録済みデバイスが存在する場合。
device identification required: set the X-Device-Id header or pass device_id を渡します。 Multi-device を参照してください。
OAuth を持つリモートクライアント
Claude カスタムコネクタなどのホストされたクライアントは、Basic 認証ヘッダーをアタッチできません。 そのため、GOWAは/mcpのOAuth2.1認証サーバーを実行することができます。デフォルトではオフです。
APP_BASIC_AUTHを設定する必要があります。認証ページは同じアカウントのユーザに署名します。起動に失敗します。- 発行者とリソースは、
http://gowa:3000のような内部アドレスではなく、クライアントが参照しているパブリックHTTPS URLでなければなりません。 - OAuth をオンにすると、
/mcpはベアラートトークンまたは Basic 認証を受け付けます。REST または UI ルートではトークンは受け付けられません。 - クライアントは自分自身を登録します(RFC 7591動的クライアント登録)。登録ボディは16 KiBに制限され、各リダイレクトURIは2 KiBに制限されます。 登録は1時間あたり40と1,000の保存されたクライアントに制限されています。未使用のものは24時間後に削除されます。
- PKCE
S256は必須です。 コードは5分後に期限切れになり、1時間後にトークンにアクセスします。トークンを更新し、古いものを再利用するとトークンファミリー全体が無効になります。MCP_OAUTH_DB_URI(デフォルトのfile:storages/oauth.db)には、SHA-256ハッシュのトークンのみが格納されます。
localhost コールバックは、明示的なポートと完全に一致する必要があります。 他のリダイレクトにはHTTPSが必要です。OAuth resource は正規の MCP URLにバインドされます。トークン要求は省略できますが、指定された値が一致する必要があります。 正常に承認された iss が含まれます。
期限切れのコードとトークンは、OAuth 書き込み中に削除されます。 更新されたリフレッシュトークンハッシュは、ライブファミリーに対するリプレイを検出するために必要な間、30日間のリフレッシュトークンのライフタイムを最大1回まで維持します。 OAuth データベースを削除または置き換えると、既存のクライアントと助成金が無効になります。
発行者に対するエンドポイント: /oauth/authorize, /oauth/token, /oauth/register. ディスカバリーメタデータはドメインルートでパス挿入よく知られているURLを使用します。そのためAPP_BASE_PATH=/gowaを使用すると、プロキシはルートする必要があります。
https://gowa.example.com/mcp を追加し、APP_BASIC_AUTH アカウントでサインインします。
