Kaption expone WhatsApp a apps y agentes de IA a través de un único servidor MCP. Esta página reúne todos los endpoints, documentos y repositorios que necesitas.
Dirección del servidor MCP
https://mcp.kaptionai.com/mcpUn servidor MCP remoto sobre Streamable HTTP. Habla JSON-RPC 2.0 y funciona con cualquier cliente MCP que admita OAuth. Las herramientas se ejecutan en la extensión o la app de escritorio de Kaption, en la computadora del propio usuario, así que el usuario debe tener Kaption abierto.
OAuth 2.1 con PKCE (S256) y registro dinámico de clientes. Hay un único scope, kaption:access. Los usuarios inician sesión con su número de teléfono y un código que reciben por WhatsApp, y luego eligen cuánto dura la conexión. Los tokens de acceso caducan al cabo de una hora. Las llamadas sin token reciben HTTP 401 con un encabezado WWW-Authenticate que apunta a los metadatos del recurso protegido.
Streamable HTTP. También hay un endpoint SSE en /sse para clientes más antiguos.
mcp.kaptionai.com/mcpMetadatos del recurso protegido (RFC 9728), que enlazan con el servidor de autorización.
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpDescripción OpenAPI 3.1 del endpoint HTTP, su esquema OAuth y sus respuestas de error.
kaptionai.com/openapi.jsonNombre, endpoints remotos, paquete y datos de autenticación en el formato server.json del MCP Registry.
kaptionai.com/.well-known/mcp.jsonLinkset RFC 9727 que enumera los servicios de este dominio.
kaptionai.com/.well-known/api-catalogUna guía del sitio en texto plano para agentes de IA: qué hace Kaption y cuándo usarlo.
kaptionai.com/llms.txtEl paquete npm para clientes que ejecutan servidores locales. Necesita Node.js 18 o posterior.
www.npmjs.com/package/@kaptionai/mcp-extensionEl código fuente del relay en la nube es público. Cada despliegue se firma y queda registrado en un log público.
github.com/Kaption-AI/mcp-extension-remoteEl servidor en la nube expone estas herramientas. Ninguna envía un mensaje al instante: la IA puede dejar un borrador o programar un mensaje para una persona. Los chats que el usuario bloqueó en WhatsApp nunca son visibles.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagescall_recordingsInforma de vulnerabilidades en privado a security@kaptionai.com. Por favor, no abras una issue pública.
Todo error que genera el servidor es un documento de problema RFC 9457, servido como application/problem+json, con type, title, status, detail y un code legible por máquinas. Decide según code; detail es para personas. Los errores nunca son HTML.
Dentro del transporte MCP (/mcp y /sse), los errores de protocolo son objetos de error JSON-RPC, como exige la especificación MCP, y una herramienta que falla devuelve un resultado con isError: true.
| Estado | Códigos |
|---|---|
| 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 |
Las solicitudes limitadas reciben 429 con la cabecera Retry-After (segundos) y code rate_limited. Las respuestas contadas llevan RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (segundos) de la política más cerca de agotarse, y RateLimit-Policy enumera todas las que aplican.
| Política | Límite | Ventana | Se cuenta en |
|---|---|---|---|
| otp-send-account | 50 | 60 min (fija) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 min (fija) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 min (fija) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 min (se reinicia en cada intento) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 min (se reinicia en cada intento) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 min (se reinicia en cada intento) | /authorize/reviewer-login |
Las llamadas a herramientas MCP en /mcp no tienen un límite propio. El envío masivo o no solicitado sigue prohibido por los términos, y el acceso puede suspenderse para proteger el servicio.
La interfaz pública de Kaption es el servidor MCP. El archivo OpenAPI describe ese endpoint HTTP para que las herramientas que leen OpenAPI puedan encontrarlo; las operaciones en sí son herramientas MCP que se llaman por JSON-RPC.
No. Cada llamada, incluidas initialize y tools/list, necesita un token. Los nombres de las herramientas aparecen en esta página y en la tarjeta del servidor.
Claude, ChatGPT, Cursor y otros clientes que admiten servidores MCP remotos con OAuth. Los clientes que ejecutan servidores locales pueden usar el paquete npm.