開発者

MCP で Kaption を活用した開発を

Kaption は 1 つの MCP サーバーを通じて、WhatsApp を AI アプリやエージェントに公開しています。必要なエンドポイント、ドキュメント、リポジトリをこのページにまとめました。

MCP サーバーのアドレス

https://mcp.kaptionai.com/mcp

エンドポイント

Streamable HTTP で動作するリモート MCP サーバーです。JSON-RPC 2.0 を使用し、OAuth に対応したあらゆる MCP クライアントで使えます。ツールはユーザー自身のパソコン上の Kaption 拡張機能またはデスクトップアプリで実行されるため、ユーザーが Kaption を開いている必要があります。

認証

PKCE（S256）と動的クライアント登録に対応した OAuth 2.1 です。スコープは kaption:access の 1 つだけです。ユーザーは電話番号と WhatsApp に届くコードでログインし、接続を維持する期間を選びます。アクセストークンは 1 時間で失効します。トークンのない呼び出しには、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダー付きの HTTP 401 が返されます。

リファレンス

エンドポイントとドキュメント

ツール

ツール

クラウドサーバーは以下のツールを提供します。Kaption 0.94 以降、send_message は、ユーザーがその WhatsApp アカウントについて Kaption で「アシスタントがこのコンピューターからメッセージを送信できるようにする」をオフにしていない限り使えます。アシスタントがこの設定を変えることはできず、送信前に本文と宛先をユーザーに確認する必要があります。既存の個人チャットまたは対象となるグループ宛てに、メッセージ（添付ファイルは 8 MiB まで 1 つ）を許可される最も早い配信に向けてキューに入れます。「キューに入った」ことは配信の証明ではありません。この設定がオフのとき、AI にできるのは、下書きを残すことと、1 人宛てのメッセージを 1 件予約することです。ユーザーが WhatsApp でロックしたチャットは決して表示されません。

  • query
  • list_contacts
  • get_contact
  • get_contact_groups
  • list_groups
  • get_group
  • export_contacts
  • download_media
  • get_analytics
  • summarize_conversation
  • manage_chat
  • manage_reminders
  • manage_lists
  • manage_labels
  • manage_notes
  • manage_scheduled_messages
  • send_message
  • call_recordings
ご案内

制限

  • ツールが動作するのは、ユーザーが Kaption を開いている間だけです（拡張機能を入れた WhatsApp Web、またはデスクトップアプリ）。
  • アクセスにはレート制限があります。一斉送信や迷惑メッセージの送信は利用規約で禁止されています。
  • 予約メッセージの宛先は 1 人で、最大 800 文字です。
  • このコンピューターからの送信は 1 時間に 8 件、1 日に 20 件までで、グループにはさらに制限と待ち時間があります。また、パソコンと WhatsApp を開いたままにしておく必要があります。
開発者

セキュリティ

脆弱性は security@kaptionai.com に非公開で報告してください。公開の issue は作成しないでください。

application/problem+json

エラー

サーバーが返すエラーはすべて RFC 9457 の問題ドキュメント（application/problem+json）で、type、title、status、detail と機械可読な code を含みます。判定には code を使い、detail は人向けです。エラーが HTML になることはありません。

MCP トランスポート（/mcp と /sse）内では、MCP 仕様どおりプロトコルエラーは JSON-RPC のエラーオブジェクトで、ツール呼び出しの失敗は isError: true の結果になります。

ステータスコード
400bad_requestinvalid_jsoninvalid_inputinvalid_content_typeinvalid_phonemissing_credentialsmissing_parametersinvalid_account_idinvalid_connection_idinvalid_authorization_requestinvalid_oauth_stateinvalid_sessionotp_invalidotp_expiredotp_attempts_exceededverification_expiredconnect_code_malformedconnect_code_expired
401unauthorizedauthentication_requiredinvalid_tokenmissing_bearer_tokeninvalid_credentials
403forbidden
404not_foundnot_configuredreviewer_not_configured
405method_not_allowed
406not_acceptable
409conflict
410gone
413payload_too_large
415unsupported_media_type
422unprocessable_content
426upgrade_required
429rate_limited
500internal_errorotp_send_failedauthorization_failed
501not_implemented
502bad_gatewayupstream_errorhandshake_unavailable
503service_unavailable
504gateway_timeout
429 · Retry-After

レート制限

制限されたリクエストには Retry-After ヘッダー（秒）と code rate_limited 付きの 429 が返ります。カウント対象のレスポンスには、上限に最も近いポリシーの RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset（秒）が付き、RateLimit-Policy に適用されるすべてのポリシーが並びます。

ポリシー上限期間カウント対象
otp-send-account5060 分 (固定)/authorize/send-otp, /ext-auth/send-otp
otp-send-ip10060 分 (固定)/authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp
otp-resend-account310 分 (固定)/authorize/resend-otp
connect-code-redeem-ip2010 分 (試行ごとにリセット)/connect/remember, /authorize/connect-code
connect-code-start-account1060 分 (試行ごとにリセット)/ext/connect-code/start
reviewer-login-ip1015 分 (試行ごとにリセット)/authorize/reviewer-login

ツール呼び出しには、Kaption のプランごとに上限があります（https://kaptionai.com/ja/pricing/）。上限を超えると、料金ページへのリンク付きの MCP ツールエラーが返ります。接続は維持され、HTTP 429 ではありません。ツールの一覧取得、接続、失敗した呼び出しは数えません。一括送信や迷惑メッセージは引き続き規約で禁止されており、サービス保護のためアクセスが停止される場合があります。

Deprecation · Sunset

廃止・終了ポリシー

  • MCP エンドポイント、その HTTP 契約、またはツールへの互換性のない変更は、適用の 90 日以上前にこのページで告知します。
  • 対象のレスポンスには Deprecation ヘッダー（RFC 9745）、終了日を示す Sunset ヘッダー（RFC 8594）、移行メモへの rel="deprecation" の Link が付きます。
  • ツール、任意フィールド、エラーコードの追加は互換性のない変更ではありません。

よくある質問

REST API はありますか？

Kaption の公開インターフェースは MCP サーバーです。OpenAPI ファイルは、OpenAPI を読み取るツールが見つけられるようにこの HTTP エンドポイントを記述したものです。実際の操作は JSON-RPC で呼び出す MCP ツールです。

ログインせずにツールの一覧を取得できますか？

いいえ。initialize や tools/list を含むすべての呼び出しにトークンが必要です。ツール名はこのページとサーバーカードに記載しています。

どのクライアントで使えますか？

Claude、ChatGPT、Cursor など、OAuth 対応のリモート MCP サーバーをサポートするクライアントです。ローカルサーバーを実行するクライアントは、代わりに npm パッケージを使えます。

今すぐ音声を1件文字起こし