API pubblica

Collegare un assistente IA (MCP)

Crea una chiave API con i soli ambiti che servono all’assistente e dai al client l’indirizzo https://api.mosaqo.app/v1/mcp con quella chiave come token bearer. L’assistente può esattamente ciò che la chiave consente e nulla di più, e puoi scollegarlo quando vuoi in Bulk & API.

Verificato il 20 agosto 2026

Passaggi

1. Apri Bulk & API → API keys e crea una chiave. Concedi prima ambiti di sola lettura; ne emetterai una seconda con scrittura quando saprai cosa fa l’assistente.
2. Copia l’indirizzo dal riquadro AI assistants (MCP) nella stessa schermata.
3. Nell’assistente aggiungi un server con quell’indirizzo e invia la chiave nell’intestazione Authorization: Bearer. La maggior parte dei client accetta un blocco JSON con url e headers.
4. Alcuni connettori chiedono di accedere a Mosaqo invece di incollare una chiave. Quel percorso mostra chi sta chiedendo, quale spazio sarebbe coinvolto e cosa potrebbe fare, prima che venga concesso alcunché — solo un proprietario o un amministratore può approvare.
5. Chiedi all’assistente cosa sa fare. Elencherà gli strumenti che la tua chiave consente: la conferma più rapida che il collegamento è stretto quanto volevi.

Come verificare il risultato

Chiedi qualcosa che solo questo spazio sa: quanti codici hai, o come sta andando un sondaggio. Una risposta con i tuoi nomi e numeri veri significa che il collegamento funziona; un rifiuto che nomina un ambito significa che la chiave è più stretta della domanda.

Che cosa va storto di solito

• Dare la scrittura già alla prima chiave. Parti in sola lettura e allarga quando sai cosa ne fa.
• Aspettarsi che legga ciò che le persone hanno scritto in un sondaggio. Quelle risposte non vanno né a una chiave né a un assistente — punteggi e conteggi sì, le frasi restano nella posta in arrivo.
• Aspettarsi che cancelli un codice. Non può: distruggere il reindirizzamento dietro un codice stampato è irreversibile, quindi gli si offre l’archiviazione, che è reversibile.
• Dimenticare un collegamento. Un assistente collegato tramite accesso mantiene i permessi finché non lo si scollega in Bulk & API, come una chiave vale finché non viene revocata.