Kaption ouvre WhatsApp aux apps et agents d'IA via un seul serveur MCP. Cette page recense tous les endpoints, documents et dépôts dont vous avez besoin.
Adresse du serveur MCP
https://mcp.kaptionai.com/mcpUn serveur MCP distant en Streamable HTTP. Il parle JSON-RPC 2.0 et fonctionne avec tout client MCP qui prend en charge OAuth. Les outils s'exécutent dans l'extension ou l'app de bureau Kaption, sur l'ordinateur de l'utilisateur : Kaption doit donc être ouvert.
OAuth 2.1 avec PKCE (S256) et enregistrement dynamique des clients. Il n'y a qu'une seule portée, kaption:access. Les utilisateurs se connectent avec leur numéro de téléphone et un code reçu sur WhatsApp, puis choisissent la durée de la connexion. Les jetons d'accès expirent au bout d'une heure. Les appels sans jeton reçoivent une réponse HTTP 401 avec un en-tête WWW-Authenticate qui pointe vers les métadonnées de la ressource protégée.
Streamable HTTP. Un endpoint SSE est aussi disponible sur /sse pour les clients plus anciens.
mcp.kaptionai.com/mcpMétadonnées de la ressource protégée (RFC 9728), avec un lien vers le serveur d'autorisation.
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpDescription OpenAPI 3.1 de l'endpoint HTTP, de son schéma OAuth et de ses réponses d'erreur.
kaptionai.com/openapi.jsonNom, endpoints distants, paquet et détails d'authentification au format server.json du MCP Registry.
kaptionai.com/.well-known/mcp.jsonLinkset RFC 9727 qui recense les services de ce domaine.
kaptionai.com/.well-known/api-catalogUn guide du site en texte brut pour les agents d'IA : ce que fait Kaption et quand l'utiliser.
kaptionai.com/llms.txtLe paquet npm pour les clients qui exécutent des serveurs locaux. Nécessite Node.js 18 ou une version plus récente.
www.npmjs.com/package/@kaptionai/mcp-extensionLe code source du relais cloud est public. Chaque déploiement est signé et consigné dans un journal public.
github.com/Kaption-AI/mcp-extension-remoteLe serveur cloud expose ces outils. Depuis Kaption 0.94, send_message fonctionne sauf si l'utilisateur a désactivé « Autoriser les assistants à envoyer des messages depuis cet ordinateur » dans Kaption pour ce compte WhatsApp ; un assistant ne peut pas modifier ce réglage, et il doit quand même confirmer le texte et le destinataire avec l'utilisateur. Il met en file d'attente un message, avec au plus une pièce jointe de 8 Mio, vers une discussion existante avec une personne ou un groupe éligible, pour la première livraison autorisée, et « en file d'attente » ne prouve pas la livraison. Réglage désactivé, l'IA peut laisser un brouillon ou programmer un message à une personne. Les discussions que l'utilisateur a verrouillées dans WhatsApp ne sont jamais visibles.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagessend_messagecall_recordingsSignalez les vulnérabilités en privé à security@kaptionai.com. Merci de ne pas ouvrir d'issue publique.
Chaque erreur produite par le serveur est un document de problème RFC 9457, servi en application/problem+json, avec type, title, status, detail et un code lisible par machine. Décidez selon code ; detail est destiné aux personnes. Les erreurs ne sont jamais en HTML.
Dans le transport MCP (/mcp et /sse), les erreurs de protocole sont des objets d’erreur JSON-RPC, comme l’exige la spécification MCP, et un outil en échec renvoie un résultat avec isError: true.
| Statut | 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 |
Les requêtes limitées reçoivent 429 avec un en-tête Retry-After (secondes) et le code rate_limited. Les réponses comptées portent RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset (secondes) pour la politique la plus proche de l’épuisement, et RateLimit-Policy liste toutes celles qui s’appliquent.
| Politique | Limite | Fenêtre | Compté sur |
|---|---|---|---|
| otp-send-account | 50 | 60 min (fixe) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 min (fixe) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 min (fixe) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 min (repart à chaque tentative) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 min (repart à chaque tentative) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 min (repart à chaque tentative) | /authorize/reviewer-login |
Les appels d’outils ont un quota fixé par le forfait Kaption (https://kaptionai.com/fr/pricing/). Au-delà, l’appel reçoit une erreur d’outil MCP avec un lien vers les tarifs ; la connexion reste ouverte et ce n’est pas un HTTP 429. Lister les outils, se connecter et les appels en échec ne comptent pas. L’envoi massif ou non sollicité reste interdit par les conditions, et l’accès peut être suspendu pour protéger le service.
L'interface publique de Kaption est le serveur MCP. Le fichier OpenAPI décrit cet endpoint HTTP pour que les outils qui lisent OpenAPI puissent le trouver ; les opérations elles-mêmes sont des outils MCP appelés via JSON-RPC.
Non. Chaque appel, y compris initialize et tools/list, nécessite un jeton. Les noms des outils figurent sur cette page et dans la fiche serveur.
Claude, ChatGPT, Cursor et les autres clients qui prennent en charge les serveurs MCP distants avec OAuth. Les clients qui exécutent des serveurs locaux peuvent utiliser le paquet npm.