Développeurs

Développez sur Kaption avec MCP

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/mcp

L'endpoint

Un 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.

Authentification

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.

Référence

Endpoints et documents

Outils

Outils

Le serveur cloud expose ces outils. Aucun n'envoie de message immédiatement : 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.

  • 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
  • call_recordings
Bon à savoir

Limites

  • Les outils ne fonctionnent que lorsque l'utilisateur a Kaption ouvert : WhatsApp Web avec l'extension, ou l'app de bureau.
  • L'accès est limité en fréquence. L'envoi de messages en masse ou non sollicités est contraire aux conditions.
  • Un message programmé est destiné à une seule personne et fait au maximum 800 caractères.
Développeurs

Sécurité

Signalez les vulnérabilités en privé à security@kaptionai.com. Merci de ne pas ouvrir d'issue publique.

Questions

Existe-t-il une API REST ?

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.

Puis-je lister les outils sans me connecter ?

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.

Quels clients sont compatibles ?

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.

Transcrivez un audio maintenant