# Agenti e API Un agente è un assistente IA che lavora in LetsFindWhy per tuo conto: Claude Code, una routine pianificata di Claude, un assistente dell'editor o qualsiasi altro strumento che parli il Model Context Protocol (MCP). Dagli una chiave API e potrà impostare progetti, scrivere guide alla discussione, invitare rispondenti e leggere trascrizioni e insight da una chat, usando esattamente l'accesso che hai tu. Tutto ciò che un agente può fare, puoi farlo anche tu con semplici chiamate HTTP all'API REST. Entrambi usano la stessa chiave. ## Come creare una chiave API 1. Apri [Impostazioni](https://letsfindwhy.com/settings) e trova la scheda **Chiavi API**. 2. Crea una chiave e dalle un nome che dica quale agente la userà, come “Claude Code sul mio portatile”. Una chiave per agente rende facile revocarne una senza disturbare le altre. 3. Copia subito la chiave. Inizia con mtg_ e viene mostrata una sola volta; se la perdi, eliminala e creane un'altra. Una chiave è tua, non di un'organizzazione. Un agente che la possiede vede ogni organizzazione a cui appartieni, con il ruolo che hai lì, e tutto ciò che fa viene registrato come fatto da te. Tratta la chiave come una password e revocala nel momento in cui smetti di usare l'agente. Un collegamento creato con l'accesso ha la stessa portata di una chiave e, come una chiave, sopravvive all'uscita dall'account e al cambio di password. Scollegarlo è un passaggio a parte, descritto più sotto. ## Come collegare claude.ai claude.ai si collega tramite un URL e un accesso, senza nessuna chiave da incollare. Un collegamento creato in claude.ai copre anche Claude Desktop e le app mobili di Claude. 1. In claude.ai, apri **Impostazioni**, poi **Connettori**, e scegli **Aggiungi connettore personalizzato**. 2. Inserisci `https://letsfindwhy.com/api/mcp` come URL, esattamente come è scritto e senza barra finale, e lascia vuoti l'ID client e il segreto. 3. Scegli **Collega**. LetsFindWhy ti chiede di accedere se non l'hai già fatto, poi mostra cosa può fare il collegamento; scegli **Consenti**. Per terminare un collegamento, apri [Impostazioni](https://letsfindwhy.com/settings) in LetsFindWhy e scegli **Scollega** nella scheda **Agenti collegati**. È l'unico modo per revocarlo: rimuovere il connettore in Claude impedisce a Claude di usarlo, ma un connettore aggiunto di nuovo in seguito accede subito un'altra volta. Rimuovilo in entrambi i posti perché Claude smetta di chiederti di accedere di nuovo. ## Come collegare Claude Code Claude Code può accedere allo stesso modo. Esegui questo una volta, poi digita `/mcp` in Claude Code e scegli **Authenticate**; si apre una finestra del browser per l'accesso. È un collegamento separato da quello che ha claude.ai, e compare separatamente nelle Impostazioni. ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp ``` Per script, uso senza interfaccia o qualsiasi client che consenta di impostare un header di richiesta, incolla invece una chiave: ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp --header "Authorization: Bearer mtg_..." ``` Claude Code elenca quindi uno strumento per ogni cosa che puoi fare in LetsFindWhy, con il nome di ciò che fa: create_project, create_discussion_guide_with_questions, invite_recruited_respondents_to_session, get_session_transcript e così via. Chiedi quello che vuoi con parole semplici e sceglierà gli strumenti. Cursor, gli script e altri client che consentono di impostare un header di richiesta funzionano allo stesso modo. Le directory dei connettori di claude.ai e Claude Desktop non possono inviare un header; si collegano invece tramite URL e accesso, come descritto sopra. ## Cosa può e cosa non può fare un agente Un agente lavora come te. Prepara e legge la ricerca; non conduce interviste né gestisce il tuo team. **Può:** - Creare e aggiornare organizzazioni, progetti, processi, guide alla discussione e screener. - Gestire il reclutamento: aprire e chiudere link di iscrizione, aggiungere rispondenti a mano e invitarli alle sessioni. - Preparare le sessioni in anticipo: crearle, cambiarne le impostazioni, assegnare una guida e modificarne le domande. - Leggere i risultati: registrazioni, trascrizioni, risposte, insight IA e utilizzo. **Non può:** - Toccare un'intervista in corso. Avviare, terminare, ammettere persone, rimuoverle e convocare o congedare il moderatore IA restano alle persone nella stanza. - Cambiare chi fa parte della tua organizzazione: non può cambiare ruoli, rimuovere membri, trasferire la proprietà, uscire o eliminare l'organizzazione. - Eliminare registrazioni. Eliminare una registrazione elimina anche la sua trascrizione, quindi resta una decisione che prendi nell'app. Il confine è tracciato lì perché un agente legge ciò che i rispondenti hanno detto, e un rispondente potrebbe dire qualcosa fatto apposta per manipolarlo. Qualunque cosa legga, non può chiuderti fuori dalla tua organizzazione né cancellare la tua ricerca. Eliminare un progetto, una sessione, un processo, una guida o uno screener è consentito. Progetti e sessioni possono essere ripristinati per 30 giorni, e il tuo agente ti chiederà conferma prima di ogni eliminazione. ## Come chiamare direttamente l'API REST Sotto, ogni strumento è un endpoint REST. Invia la tua chiave come `Authorization: Bearer mtg_...` e consulta il riferimento completo, con ogni endpoint e i suoi parametri, su [/api/docs](https://letsfindwhy.com/api/docs) dopo aver effettuato l'accesso. Le chiavi sono limitate a brevi raffiche: 60 chiamate in un secondo tramite l'API REST e circa 30 tramite MCP, dove ogni chiamata a uno strumento verifica la chiave due volte. Nessun agente che ragiona raggiunge nessuno dei due limiti. Una chiamata che li supera riceve una risposta 429 che indica quanto aspettare.