Come aggiungere un connettore MCP (server MCP) a Tesseract

Tesseract supporta qualsiasi server MCP tramite stdio, HTTP o SSE, oltre ai server del registro ufficiale MCP. Aggiungilo una volta sola in Impostazioni → Estensioni → Connettori, specificando l'indirizzo, il comando per avviarlo o le impostazioni in JSON. Tutti i 14 framework degli agenti disponibili in Tesseract potranno usare i suoi strumenti.

Verificato con Tesseract 0.12.5.

Come aggiungo un server MCP a Tesseract?

Apri Impostazioni → Estensioni → Connettori e fornisci a Tesseract le informazioni sul server in uno dei tre formati. Tesseract ti mostra i dettagli prima di aggiungerlo.

  1. Apri Impostazioni → Estensioni, poi la scheda Connettori.
  2. Incolla uno dei seguenti elementi nella casella in alto, poi premi Aggiungi:
    • Un indirizzo, per un server sul web: un link http(s) come https://mcp.example.com/mcp.
    • Un comando, per un server che viene eseguito sul tuo computer tramite stdio, ad esempio npx -y @acme/notes-mcp.
    • Le impostazioni in JSON: un comando, i relativi argomenti e l'ambiente.
  3. Controlla le informazioni mostrate da Tesseract. Per un comando, puoi vedere tutto quello che verrà eseguito e non verrà avviato nulla finché non dai il permesso.
  4. Per aggiungerlo, usa il pulsante in basso: Consenti e aggiungi per un comando, Aggiungi connettore per un indirizzo. L'elemento non viene aggiunto finché non premi il pulsante.

Posso incollare una configurazione JSON, come quella nel README di un server?

Sì. Tesseract legge le impostazioni di un singolo server, con url o command, oppure un intero blocco sotto mcpServers. Rileva anche i server indicati sotto servers, mcp o mcp_servers.

Ad esempio, per un server che viene eseguito sul tuo computer:

{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }

Se le impostazioni indicano più server, Tesseract li elenca tutti e puoi scegliere quali aggiungere.

Come aggiungo un server dal registro ufficiale MCP?

Premi Sfoglia directory, accanto alla casella nella scheda Connettori, e aggiungi un server da lì.

  1. Apri Impostazioni → Estensioni → Connettori.
  2. Premi Sfoglia il registro. Vedrai i server presenti nel registro ufficiale MCP e potrai cercarli per nome.
  3. Premi Aggiungi sull’elemento che vuoi. Vedrai gli stessi passaggi previsti per un indirizzo o un comando incollato; non verrà aggiunto nulla finché non lo dici.

È compatibile con Claude Code, Codex, Gemini CLI e OpenCode?

Sì. Nella pagina di ciascuno dei 14 framework su questo sito, tra le funzionalità supportate trovi «gli strumenti di Tesseract e i tuoi server MCP». Sono inclusi Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity CLI, Kimi Code, Qwen Code, MiniMax Code, CodeBuddy, Grok Build, Cursor, Hermes Agent, OpenClaw e NanoClaw. Aggiungi un connettore una sola volta in Tesseract, non una volta per ogni framework. Ogni conversazione usa il framework che scegli, quindi puoi usare framework diversi in conversazioni diverse.

Come creo un pulsante «Aggiungi a Tesseract» per il mio connettore?

Usa lo strumento gratuito su tesseract.dev/connect/. Crea un badge in Markdown per il README e un link semplice.

  1. Apri tesseract.dev/connect/.
  2. Inserisci il nome del connettore.
  3. Incolla l'indirizzo del server o le sue impostazioni in JSON.
  4. Copia il Markdown nel tuo README oppure copia il link.

Il badge rimanda a una pagina su tesseract.dev, non direttamente all’app, perché GitHub rimuove i link che non usano http(s). L’indirizzo può contenere al massimo 2.048 caratteri. Le impostazioni devono essere un unico oggetto JSON di massimo 20.000 caratteri. Le impostazioni sono incluse direttamente nel link in forma codificata (base64url), quindi non inserirci chiavi o token reali.

Cosa succede quando qualcuno fa clic sul pulsante?

Vedono prima il tuo connettore su tesseract.dev e non si apre nulla da solo.

  1. La pagina descrive il connettore: mostra per intero l’indirizzo web che raggiunge o il comando che esegue.
  2. Propone Apri in Tesseract e Ottieni Tesseract per chi non ha l’app.
  3. Apri in Tesseract apre Impostazioni → Estensioni → Connettori, con il connettore già inserito nel campo e contrassegnato come «Questo elemento proviene da un link».
  4. Tesseract te lo mostra di nuovo prima di aggiungerlo e chiede conferma prima di eseguire qualsiasi cosa.

Se non riesce a leggere url= o config= nel link, mostra «Questo link non specifica un connettore».

È come usare Tesseract in Claude o ChatGPT?

No. Questa guida aggiunge altri server MCP a Tesseract; Tesseract in Claude e ChatGPT fa il contrario: aggiunge Tesseract alla tua app di chat usando un solo indirizzo.

Domande

Tesseract può usare qualsiasi server MCP?

Può usare qualsiasi server MCP tramite stdio, HTTP o SSE.

Devo configurare il server separatamente per Claude Code e Codex?

No. Lo aggiungi una sola volta in Impostazioni → Estensioni → Connettori e tutti i framework di Tesseract possono usarlo.

Posso incollare il JSON mcpServers da un README?

Sì. Tesseract legge le impostazioni di un singolo server o un intero blocco mcpServers.

Dove trovo i server del registro MCP ufficiale?

In Impostazioni → Estensioni → Connettori, nella sezione Esplora directory.

Un link «Aggiungi a Tesseract» aggiunge il connettore automaticamente?

No. Tesseract te lo mostra di nuovo prima di aggiungerlo e chiede conferma prima di eseguire qualsiasi cosa.

Altre guide