Collegati con MCP

Annota AI mette a disposizione un server remoto per il Model Context Protocol (MCP). Collega una volta il tuo assistente AI, poi chiedigli di lavorare con dataset, annotazioni, documenti, modelli e knowledge base dalla stessa conversazione. Un solo collegamento copre Annota Studio e Annota Brain.

Prima di iniziare

Ti servono:

Un account Annota AI. Vedi Crea il tuo account.
Un client AI che supporti server MCP remoti con Streamable HTTP e OAuth, come Codex, Claude o OpenCode.

L’integrazione MCP è inclusa in tutti i piani.

Trova l’URL del server

Accedi ad Annota AI e seleziona l’organizzazione.
Nel menu laterale di Annota Studio, seleziona Integrazioni.
In Server MCP, copia l’URL del server con Copia URL.

L’URL del server è:

https://api.annota.ai/mcp

La pagina Integrazioni contiene anche un prompt di configurazione per ogni client. Seleziona Copia prompt, incollalo nel tuo assistente e ti guiderà nella configurazione e nell’accesso.

Configura il tuo client

Scegli il client e segui i passaggi. Corrispondono alle istruzioni di Configurazione manuale della pagina Integrazioni. I nomi dei menu dei client restano in inglese, come nelle rispettive app.

In Codex, apri Settings > MCP servers > Add server. Assegna il nome annota-ai, scegli Streamable HTTP e incolla l’URL del server.
Salva il server e riavvia Codex quando richiesto. Seleziona Authenticate accanto ad annota-ai, poi accedi con il tuo account Annota AI nel browser.
Apri una nuova conversazione e usa /mcp per verificare che annota-ai sia collegato.

Se hai installato la CLI di Codex, puoi aggiungere il server e accedere da un terminale:

codex mcp add annota-ai --url 'https://api.annota.ai/mcp'
codex mcp login annota-ai

Per altre opzioni, consulta la documentazione MCP di Codex.

Per Claude sul web o nell’app desktop:

In Claude, apri Customize > Connectors. Seleziona +, poi Add custom connector. Assegna il nome Annota AI, incolla l’URL del server e seleziona Add.
Trova Annota AI nell’elenco dei connettori e seleziona Connect. Completa l’accesso con il tuo account Annota AI nel browser.
Avvia una nuova conversazione. Apri + > Connectors e attiva Annota AI per rendere disponibili i suoi strumenti a Claude.

Su Claude Team ed Enterprise, un proprietario deve prima aggiungere il connettore da Organization settings > Connectors.

Per Claude Code, copia il prompt di configurazione dalla scheda Claude della pagina Integrazioni e incollalo in Claude Code. Aggiunge il server annota-ai e ti guida nell’accesso dal browser tramite /mcp.

Per maggiori dettagli, consulta la documentazione di Claude sui connettori personalizzati.

Con OpenCode installato, aggiungi questa voce a opencode.json nella cartella principale del progetto, oppure a ~/.config/opencode/opencode.json per tutti i progetti. Se il file esiste già, integra la voce annota-ai nella sezione mcp.
```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "annota-ai": {
      "type": "remote",
      "url": "https://api.annota.ai/mcp",
      "enabled": true
    }
  }
}
```
Dalla cartella del progetto, esegui questo comando, poi accedi con il tuo account Annota AI nel browser che si apre:
Finestra del terminale
```
opencode mcp auth annota-ai
```
Esegui opencode mcp list per controllare lo stato del server, poi apri OpenCode nel progetto e chiedigli di usare annota-ai.

Per altre opzioni, consulta la documentazione MCP di OpenCode.

Funzionano anche altri client, purché supportino server MCP remoti con Streamable HTTP e OAuth. Aggiungi l’URL come server remoto e segui la procedura di accesso del client.

Accedi e autorizza

Al primo collegamento, il client apre il browser. Accedi con il tuo account Annota AI. La schermata Autorizza l’accesso mostra poi il nome del client e cosa chiede:

Permesso	Cosa significa
Consultare, creare, modificare ed eliminare i dati a cui hai accesso, e avviare elaborazioni che possono consumare crediti.	Il client può usare tutti gli strumenti MCP sui dati a cui il tuo account accede.
Identificare il tuo account.	Il client sa quale account Annota AI ha effettuato l’accesso.
Leggere le informazioni del tuo profilo.	Il client può leggere il tuo nome e i dati del profilo.
Leggere il tuo indirizzo email.	Il client può leggere l’indirizzo email del tuo account.
Mantenere l’accesso anche quando non stai usando l’app.	Il client resta collegato senza chiederti di accedere ogni volta.

L’elenco mostra solo ciò che il client richiede. Seleziona Autorizza per collegarlo oppure Nega per annullare.

Verifica il collegamento

Parti da una richiesta di sola lettura. Chiedi al tuo assistente:

Mostrami i dataset disponibili nelle mie organizzazioni Annota AI.

Se elenca i tuoi dataset, il collegamento funziona.

Cosa può fare il tuo assistente

L’assistente lavora sugli stessi dati che vedi nell’app. Ad esempio, può:

Elencare organizzazioni, dataset, contenuti ed etichette.
Caricare immagini e documenti e creare, modificare o eliminare annotazioni.
Leggere e correggere il testo OCR delle pagine dei documenti e impostare lo stato di revisione.
Stimare e avviare l’annotazione automatica.
Creare versioni dei dataset ed esportazioni.
Gestire modelli e addestramenti Beta privata, nelle organizzazioni in cui l’addestramento è abilitato.
Creare knowledge base, cercare al loro interno e leggere le pagine trovate, per rispondere con le fonti usando il proprio modello.

Il server MCP non ha strumenti di chat di Brain: le risposte arrivano dal tuo assistente, non da Annota Brain. Per l’elenco completo, vedi il riferimento degli strumenti MCP.

Permessi

Il collegamento può accedere alle organizzazioni di cui fai parte, con i tuoi permessi. L’assistente vede e modifica solo ciò che puoi vedere e modificare nell’app.

Ciò che l’assistente crea appartiene a te e resta privato finché non lo condividi nell’app. Vedi Condivisione e accesso.

Crediti

Le operazioni a pagamento usano gli stessi crediti dell’app, dal saldo condiviso della tua organizzazione. Ad esempio:

Caricare documenti avvia l’OCR.
L’annotazione automatica viene addebitata per immagine dopo l’elaborazione e prosegue solo finché il saldo crediti è positivo. L’assistente può prima mostrarti una stima.
Le knowledge base usano crediti per indicizzare le pagine nuove o modificate.
Cercare in una knowledge base consuma pochi crediti. Leggerne i documenti è gratuito.

Vedi Utilizzo dei crediti per sapere come viene conteggiata ogni operazione e i prezzi per le quote del tuo piano.

Revoca l’accesso

Puoi scollegare un client in qualsiasi momento.

Apri il menu utente e, in Account, seleziona Impostazioni.
Seleziona Sicurezza.
In Applicazioni autorizzate, trova il client e seleziona Revoca accesso.

Il client perde l’accesso, inclusi i token già emessi. Per collegarsi di nuovo dovrà richiedere la tua autorizzazione.