Kaption espone WhatsApp ad app e agenti di IA tramite un unico server MCP. Questa pagina elenca tutti gli endpoint, i documenti e i repository che ti servono.
Indirizzo del server MCP
https://mcp.kaptionai.com/mcpUn server MCP remoto su Streamable HTTP. Usa JSON-RPC 2.0 e funziona con qualsiasi client MCP che supporti OAuth. Gli strumenti vengono eseguiti nell'estensione o nell'app desktop Kaption, sul computer dell'utente, quindi l'utente deve avere Kaption aperto.
OAuth 2.1 con PKCE (S256) e registrazione dinamica dei client. C'è un unico ambito, kaption:access. Gli utenti accedono con il proprio numero di telefono e un codice ricevuto su WhatsApp, poi scelgono quanto dura la connessione. I token di accesso scadono dopo un'ora. Le chiamate senza token ricevono HTTP 401 con un'intestazione WWW-Authenticate che rimanda ai metadati della risorsa protetta.
Streamable HTTP. Per i client meno recenti è disponibile anche un endpoint SSE su /sse.
mcp.kaptionai.com/mcpMetadati della risorsa protetta (RFC 9728), con il link al server di autorizzazione.
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpDescrizione OpenAPI 3.1 dell'endpoint HTTP, del suo schema OAuth e delle risposte di errore.
kaptionai.com/openapi.jsonNome, endpoint remoti, pacchetto e dettagli di autenticazione nel formato server.json del MCP Registry.
kaptionai.com/.well-known/mcp.jsonLinkset RFC 9727 che elenca i servizi di questo dominio.
kaptionai.com/.well-known/api-catalogUna guida al sito in testo semplice per gli agenti di IA: cosa fa Kaption e quando usarlo.
kaptionai.com/llms.txtIl pacchetto npm per i client che eseguono server locali. Richiede Node.js 18 o versioni successive.
www.npmjs.com/package/@kaptionai/mcp-extensionIl codice sorgente del relay cloud è pubblico. Ogni deploy è firmato e registrato in un log pubblico.
github.com/Kaption-AI/mcp-extension-remoteIl server cloud espone questi strumenti. Nessuno invia subito un messaggio: l'IA può lasciare una bozza o programmare un messaggio a una persona. Le chat che l'utente ha bloccato in WhatsApp non sono mai visibili.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagescall_recordingsSegnala le vulnerabilità in privato a security@kaptionai.com. Per favore, non aprire una issue pubblica.
Ogni errore generato dal server è un documento di problema RFC 9457, servito come application/problem+json, con type, title, status, detail e un code leggibile dalle macchine. Decidi in base a code; detail è per le persone. Gli errori non sono mai HTML.
Dentro il trasporto MCP (/mcp e /sse), gli errori di protocollo sono oggetti di errore JSON-RPC, come richiede la specifica MCP, e uno strumento che fallisce restituisce un risultato con isError: true.
| Stato | Codici |
|---|---|
| 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 |
Le richieste limitate ricevono 429 con l’header Retry-After (secondi) e code rate_limited. Le risposte conteggiate riportano RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset (secondi) per la policy più vicina all’esaurimento, e RateLimit-Policy elenca tutte quelle applicate.
| Policy | Limite | Finestra | Conteggiato su |
|---|---|---|---|
| otp-send-account | 50 | 60 min (fissa) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 min (fissa) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 min (fissa) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 min (riparte a ogni tentativo) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 min (riparte a ogni tentativo) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 min (riparte a ogni tentativo) | /authorize/reviewer-login |
Le chiamate agli strumenti MCP su /mcp non hanno un limite proprio. L’invio massivo o non richiesto resta vietato dai termini e l’accesso può essere sospeso per proteggere il servizio.
L'interfaccia pubblica di Kaption è il server MCP. Il file OpenAPI descrive quell'endpoint HTTP affinché gli strumenti che leggono OpenAPI possano trovarlo; le operazioni vere e proprie sono strumenti MCP chiamati tramite JSON-RPC.
No. Ogni chiamata, compresi initialize e tools/list, richiede un token. I nomi degli strumenti sono elencati in questa pagina e nella server card.
Claude, ChatGPT, Cursor e gli altri client che supportano server MCP remoti con OAuth. I client che eseguono server locali possono usare il pacchetto npm.