Como adicionar um conector MCP (servidor MCP) ao Tesseract

O Tesseract aceita qualquer servidor MCP, por stdio, HTTP ou SSE, além de servidores do registro oficial do MCP. Adicione-o uma única vez em Configurações → Extensões → Conectores, usando o endereço, o comando para iniciá-lo ou as configurações em JSON. Depois, todos os 14 frameworks de agentes do Tesseract podem usar as ferramentas dele.

Verificado com o Tesseract 0.12.5.

Como adiciono um servidor MCP ao Tesseract?

Abra Configurações → Extensões → Conectores e informe o servidor de uma destas três formas. O Tesseract mostra o que será adicionado antes de qualquer coisa ser adicionada.

  1. Abra Configurações → Extensões e depois a aba Conectores.
  2. Cole uma destas opções na caixa na parte superior e clique em Adicionar:
    • Um endereço, para um servidor na web: um link http(s), como https://mcp.example.com/mcp.
    • Um comando, para um servidor que roda no seu computador por stdio, como npx -y @acme/notes-mcp.
    • As configurações em JSON: um comando, seus argumentos e seu ambiente.
  3. Confira o que o Tesseract mostra. Para um comando, você vê o comando completo que será executado, e nada é executado antes de você permitir.
  4. Clique no botão na parte inferior para adicioná-lo: Permitir e adicionar para um comando ou Adicionar conector para um endereço. Nada é adicionado até você clicar nele.

Posso colar uma configuração JSON, como a que está no README de um servidor?

Sim. O Tesseract lê as configurações de um servidor, com url ou command, ou um bloco inteiro em mcpServers. Ele também encontra servidores em servers, mcp ou mcp_servers.

Por exemplo, um servidor que roda no seu computador:

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

Quando as configurações listam vários servidores, o Tesseract mostra cada um deles e você escolhe quais adicionar.

Como adiciono um servidor do registro oficial do MCP?

Clique em Explorar diretório, ao lado da caixa na aba Conectores, e adicione um servidor por ali.

  1. Abra Configurações → Extensões → Conectores.
  2. Clique em Explorar diretório. Ele mostra os servidores do registro oficial do MCP, e você pode buscá-los pelo nome.
  3. Clique em Adicionar naquele que você quer. Você verá as mesmas etapas de quando cola um endereço ou comando, e nada será adicionado antes de você dizer.

Funciona com Claude Code, Codex, Gemini CLI e OpenCode?

Sim. A página de cada framework neste site lista “as ferramentas do Tesseract e seus servidores MCP” entre os recursos compatíveis — todos os 14. Isso inclui Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity CLI, Kimi Code, Qwen Code, MiniMax Code, CodeBuddy, Grok Build, Cursor, Hermes Agent, OpenClaw e NanoClaw. Você adiciona um conector uma única vez no Tesseract, não uma vez para cada framework. Cada conversa usa o framework escolhido para ela, então conversas diferentes podem usar frameworks diferentes.

Como faço um botão “Adicionar ao Tesseract” para meu conector?

Use o criador gratuito em tesseract.dev/connect/. Ele gera um selo em Markdown para o seu README e um link simples.

  1. Acesse tesseract.dev/connect/.
  2. Digite o nome do seu conector.
  3. Cole o endereço do seu servidor ou as configurações dele em JSON.
  4. Copie o Markdown para o seu README ou copie o link.

O selo leva a uma página do tesseract.dev, não direto ao app, porque o GitHub remove links que não sejam http(s). O endereço pode ter no máximo 2.048 caracteres. As configurações devem ser um único objeto JSON com até 20.000 caracteres. As configurações ficam no próprio link, apenas codificadas (base64url), então não inclua chaves nem tokens reais.

O que acontece quando alguém clica no botão?

A pessoa vê primeiro seu conector no tesseract.dev, e nada abre automaticamente.

  1. A página explica o que é o conector: o endereço da web que ele acessa ou o comando que executa, mostrado por inteiro.
  2. A página oferece Abrir no Tesseract e Baixar o Tesseract para quem não tem o app.
  3. Abrir no Tesseract leva a Configurações → Extensões → Conectores, com o conector já preenchido e identificado como "Isso veio de um link".
  4. O Tesseract mostra isso novamente antes de adicionar qualquer coisa e pergunta antes de qualquer coisa ser executada.

Se não for possível ler url= ou config= no link, a mensagem exibida será "Este link não identifica um conector".

Isso é igual a usar o Tesseract dentro do Claude ou do ChatGPT?

Não. Este guia traz outros servidores MCP para o Tesseract; Tesseract no Claude e no ChatGPT faz o caminho inverso: adiciona o Tesseract ao seu app de conversa usando um único endereço.

Perguntas

O Tesseract funciona com qualquer servidor MCP?

Ele aceita qualquer servidor MCP por stdio, HTTP ou SSE.

Preciso configurar o servidor separadamente para o Claude Code e para o Codex?

Não. Você adiciona isso uma vez em Configurações → Extensões → Conectores, e todos os frameworks do Tesseract podem usar isso.

Posso colar o JSON mcpServers de um README?

Sim. O Tesseract lê as configurações de um servidor ou um bloco mcpServers completo.

Onde encontro servidores do registro oficial do MCP?

Em Configurações → Extensões → Conectores, na opção Explorar diretório.

Um link "Adicionar ao Tesseract" adiciona o conector automaticamente?

Não. O Tesseract mostra isso de novo antes de qualquer coisa ser adicionada e pergunta antes de qualquer coisa ser executada.

Mais guias