Accesso programmatico e automazione

Panoramica

Ci sono tre modi per usare Whisperer senza l'interfaccia: il server MCP per i client IA, i servizi collegati per l'automazione ricorrente e l'esportazione per portare il materiale altrove. Whisperer non pubblica un'API REST di uso generale: gli indirizzi sotto /v1/ sono il canale privato tra le nostre applicazioni e il backend, non danno alcuna promessa di compatibilità e possono cambiare in qualsiasi momento.

È un confine voluto, non una dimenticanza. Un'API pubblicata deve funzionare per anni; MCP offre lo stesso accesso con versionamento, schermata di consenso e revoca già integrati.

Quando usarlo

  • Vuoi che un assistente IA legga le riunioni e agisca sulle attività: MCP.
  • Vuoi un'azione ricorrente («nuova riunione → riga in un foglio»): Zapier.
  • Vuoi il materiale stesso in un altro strumento: esportazione.

Passo dopo passo

  1. Per i client IA collegati via MCP: MCP: collegare Claude, ChatGPT e Cursor. È la via programmatica supportata e l'unica coperta da una promessa di stabilità.
  2. Per l'automazione collega Zapier, Notion, Slack o HubSpot nel tuo account e costruisci lo scenario in quel servizio.
  3. Per trasferimenti una tantum esporta una riunione in Markdown, SRT, VTT o JSON dalla sua pagina.
  4. Per informazioni sul prodotto leggibili dalle macchine — per esempio se vuoi che un assistente IA risponda a domande su Whisperer stesso — indirizzalo a https://whisperer.one/llms.txt o al corpus completo https://whisperer.one/llms-full.txt. Entrambi sono pubblici e non richiedono autenticazione.

Cosa è pubblico

Indirizzo Che cos'è
https://whisperer.one/mcp Server MCP per client IA esterni
https://whisperer.one/.well-known/oauth-protected-resource Dove un client scopre come autenticarsi
https://whisperer.one/.well-known/oauth-authorization-server Endpoint OAuth e aree supportate
https://whisperer.one/llms.txt Indice del prodotto per i sistemi IA
https://whisperer.one/llms-full.txt Tutta la documentazione pubblica in un file
https://whisperer.one/docs/en/<pagina>.md Qualsiasi pagina della documentazione inglese in Markdown puro

Errori comuni

  • Costruire su /v1/. Quegli indirizzi sono interni: chiusi ai crawler, schema disattivato in produzione, modifiche senza preavviso.
  • Cercare una chiave API. Non esiste, perché non c'è un'API REST pubblica. L'accesso esterno è un token bearer emesso dal consenso MCP.
  • Aspettarsi i webhook. L'automazione in uscita passa da Zapier e dai servizi collegati, non da webhook nostri.

Buone pratiche

  • Leggi gli endpoint OAuth dal documento di metadati invece di fissarli nel codice: sono pubblicati lì proprio per poter cambiare senza rompere i client.
  • Crea un collegamento per ogni integrazione, così puoi revocarne uno senza toccare gli altri.

Articoli correlati