Sviluppatori

Sviluppa su Kaption con MCP

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

L'endpoint

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

Autenticazione

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.

Riferimenti

Endpoint e documenti

Strumenti

Strumenti

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

  • 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
Da sapere

Limiti

  • Gli strumenti funzionano solo mentre l'utente ha Kaption aperto: WhatsApp Web con l'estensione, oppure l'app desktop.
  • L'accesso ha un limite di frequenza. I messaggi di massa o non richiesti violano i termini.
  • Un messaggio programmato va a una sola persona ed è lungo al massimo 800 caratteri.
Sviluppatori

Sicurezza

Segnala le vulnerabilità in privato a security@kaptionai.com. Per favore, non aprire una issue pubblica.

Domande

Esiste un'API REST?

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.

Posso elencare gli strumenti senza accedere?

No. Ogni chiamata, compresi initialize e tools/list, richiede un token. I nomi degli strumenti sono elencati in questa pagina e nella server card.

Quali client funzionano?

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.

Trascrivi un audio ora