Kaption macht WhatsApp über einen einzigen MCP-Server für KI-Apps und -Agenten zugänglich. Auf dieser Seite findest du alle Endpunkte, Dokumente und Repositorys, die du brauchst.
MCP-Serveradresse
https://mcp.kaptionai.com/mcpEin Remote-MCP-Server über Streamable HTTP. Er spricht JSON-RPC 2.0 und funktioniert mit jedem MCP-Client, der OAuth unterstützt. Die Tools laufen in der Kaption-Erweiterung oder der Desktop-App auf dem eigenen Computer der Nutzer, deshalb muss Kaption geöffnet sein.
OAuth 2.1 mit PKCE (S256) und dynamischer Client-Registrierung. Es gibt einen einzigen Scope, kaption:access. Nutzer melden sich mit ihrer Telefonnummer und einem Code an, den sie per WhatsApp erhalten, und wählen dann, wie lange die Verbindung bestehen bleibt. Zugriffstokens laufen nach einer Stunde ab. Aufrufe ohne Token erhalten HTTP 401 mit einem WWW-Authenticate-Header, der auf die Metadaten der geschützten Ressource verweist.
Streamable HTTP. Für ältere Clients gibt es außerdem einen SSE-Endpunkt unter /sse.
mcp.kaptionai.com/mcpMetadaten der geschützten Ressource (RFC 9728) mit Verweis auf den Autorisierungsserver.
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpOpenAPI 3.1-Beschreibung des HTTP-Endpunkts, seines OAuth-Schemas und seiner Fehlerantworten.
kaptionai.com/openapi.jsonName, Remote-Endpunkte, Paket und Auth-Details im server.json-Format der MCP Registry.
kaptionai.com/.well-known/mcp.jsonEin Leitfaden zur Website in reinem Text für KI-Agenten: was Kaption macht und wann man es nutzt.
kaptionai.com/llms.txtDas npm-Paket für Clients, die lokale Server ausführen. Benötigt Node.js 18 oder neuer.
www.npmjs.com/package/@kaptionai/mcp-extensionDer Quellcode des Cloud-Relays ist öffentlich. Jedes Deployment wird signiert und in einem öffentlichen Log festgehalten.
github.com/Kaption-AI/mcp-extension-remoteDer Cloud-Server stellt diese Tools bereit. Keines davon sendet sofort eine Nachricht: Die KI kann einen Entwurf hinterlassen oder eine Nachricht an eine Person planen. Chats, die Nutzer in WhatsApp gesperrt haben, sind nie sichtbar.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagescall_recordingsMelde Sicherheitslücken vertraulich an security@kaptionai.com. Bitte eröffne dafür kein öffentliches Issue.
Jeder Fehler, den der Server selbst erzeugt, ist ein RFC-9457-Problemdokument (application/problem+json) mit type, title, status, detail und einem maschinenlesbaren code. Entscheide anhand von code; detail ist für Menschen. Fehler sind nie HTML.
Im MCP-Transport (/mcp und /sse) sind Protokollfehler JSON-RPC-Fehlerobjekte, wie es die MCP-Spezifikation verlangt, und ein fehlgeschlagener Tool-Aufruf ist ein Ergebnis mit isError: true.
| Status | Codes |
|---|---|
| 400 | bad_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 |
| 401 | unauthorizedauthentication_requiredinvalid_tokenmissing_bearer_tokeninvalid_credentials |
| 403 | forbidden |
| 404 | not_foundnot_configuredreviewer_not_configured |
| 405 | method_not_allowed |
| 406 | not_acceptable |
| 409 | conflict |
| 410 | gone |
| 413 | payload_too_large |
| 415 | unsupported_media_type |
| 422 | unprocessable_content |
| 426 | upgrade_required |
| 429 | rate_limited |
| 500 | internal_errorotp_send_failedauthorization_failed |
| 501 | not_implemented |
| 502 | bad_gatewayupstream_errorhandshake_unavailable |
| 503 | service_unavailable |
| 504 | gateway_timeout |
Gedrosselte Anfragen erhalten 429 mit einem Retry-After-Header (Sekunden) und code rate_limited. Gezählte Antworten tragen RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset (Sekunden) für die Richtlinie, die am nächsten am Limit ist; RateLimit-Policy nennt alle geltenden Richtlinien.
| Richtlinie | Limit | Zeitfenster | Gezählt auf |
|---|---|---|---|
| otp-send-account | 50 | 60 Min. (fest) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 Min. (fest) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 Min. (fest) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 Min. (beginnt bei jedem Versuch neu) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 Min. (beginnt bei jedem Versuch neu) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 Min. (beginnt bei jedem Versuch neu) | /authorize/reviewer-login |
MCP-Tool-Aufrufe auf /mcp haben kein eigenes Anfragelimit. Massen- oder unerwünschte Nachrichten bleiben laut Nutzungsbedingungen verboten, und der Zugang kann zum Schutz des Dienstes gesperrt werden.
Die öffentliche Schnittstelle von Kaption ist der MCP-Server. Die OpenAPI-Datei beschreibt diesen HTTP-Endpunkt, damit Tools, die OpenAPI lesen, ihn finden können; die eigentlichen Operationen sind MCP-Tools, die über JSON-RPC aufgerufen werden.
Nein. Jeder Aufruf, auch initialize und tools/list, braucht ein Token. Die Namen der Tools stehen auf dieser Seite und in der Server-Card.
Claude, ChatGPT, Cursor und andere Clients, die Remote-MCP-Server mit OAuth unterstützen. Clients, die lokale Server ausführen, können stattdessen das npm-Paket nutzen.