MCP no Claude Code e em qualquer agente: configure e inspecione servidores por repositório

O que é MCP?

MCP (Model Context Protocol) é um protocolo aberto, criado pela Anthropic, que permite a agentes de IA chamar ferramentas e fontes de dados externas por uma interface padrão. Cada integração roda como um servidor MCP: um programa pequeno ou um endpoint remoto que expõe ferramentas, como consultar um banco de dados, ler um gerenciador de tarefas ou buscar na documentação interna. O agente que suporta MCP se conecta aos servidores listados na configuração dele e chama essas ferramentas durante a tarefa.

Dois transportes cobrem quase todos os casos. No stdio, o agente inicia o servidor como um processo local e conversa com ele pela entrada e saída padrão. No HTTP, o servidor roda em outro lugar e o agente se conecta a uma URL. O glossário tem definições curtas dos termos relacionados.

Como agentes como o Claude Code usam servidores MCP?

Cada agente lê os servidores MCP dos próprios arquivos de configuração e inicia ou se conecta a eles por conta própria. Um arquivo de projeto, quase sempre o .mcp.json na raiz do repositório, garante os mesmos servidores para todo mundo que clona o repo. O agente também pode guardar servidores pessoais em configurações de usuário, fora do repositório.

O Tallos não traz servidores MCP próprios e não muda a forma como os agentes carregam os seus. Quando você inicia o Claude Code ou outro agente com suporte a MCP num workspace do Tallos, ele lê as configurações exatamente como faria em qualquer terminal. O que o Tallos acrescenta é visibilidade: para cada repositório, você vê quais servidores os agentes vão encontrar antes de iniciá-los.

Todo workspace do Tallos é uma git worktree do mesmo repositório, então um .mcp.json commitado existe em todos eles e os workspaces paralelos recebem os mesmos servidores. Um arquivo sem commit só existe no workspace em que você o criou.

O que o inspetor de Configurações MCP do Tallos mostra?

Configurações MCP é uma seção em Configurações → Projetos → *seu repositório* que inspeciona as definições de servidores MCP que os agentes podem usar naquele repositório. Ela lê a raiz do workspace ativo do repo (ou da worktree principal, quando nenhum workspace dele está ativo), verifica quatro arquivos conhecidos e lista cada servidor dentro do objeto mcpServers.

• Por arquivo: status de não encontrado, JSON inválido, ilegível, sem servidores ou a contagem de servidores, mais o botão Abrir para editar o arquivo no editor do Tallos.
• Por servidor: nome, transporte (stdio ou http), comando ou URL, o bloco env e o status enabled, disabled ou invalid.
• Servidores inválidos dizem o motivo, como falta de comando ou de URL.
• Arquivos verificados que não existem aparecem em *Verificado*, para você saber exatamente o que foi procurado.

O inspetor entende as variações mais comuns: command como texto ou lista, url ou httpUrl, e valores de type como http, remote e local. Um servidor com "disabled": true ou "enabled": false aparece como disabled. Arquivos acima de 256 KB, ou com mais de 256 servidores, são marcados como inválidos em vez de lidos.

Como configurar um servidor MCP no Claude Code no meu repositório?

Adicione o servidor num arquivo .mcp.json na raiz do repositório, confira nas Configurações MCP, faça o commit e inicie o agente num workspace. O exemplo usa o formato padrão mcpServers.

1. 1

   Abra as Configurações MCP

   No Tallos, vá em Configurações → Projetos, escolha o repositório e desça até Configurações MCP. Buscar mcp ou .mcp.json na busca das configurações também leva até lá.

2. 2

   Crie o arquivo

   Se o repo não tem configuração MCP, clique em Adicionar configuração MCP e depois em Criar configuração vazia para confirmar. O Tallos grava o .mcp.json com um objeto mcpServers vazio e abre o arquivo no editor.

3. 3

   Adicione os servidores

   Crie uma entrada por servidor dentro de mcpServers. Servidores locais usam command, args e, se precisar, env. Servidores remotos usam "type": "http" e uma url.

4. 4

   Atualize e confira

   Clique em atualizar nas Configurações MCP. Cada servidor deve mostrar o transporte certo e enabled. Corrija o que estiver como invalid antes de iniciar um agente.

5. 5

   Faça o commit e rode

   Commite o .mcp.json para que todo workspace e todo colega recebam o arquivo, e inicie o Claude Code ou outro agente com suporte a MCP num workspace. O próprio agente carrega os servidores.

{
  "mcpServers": {
    "internal-docs": {
      "command": "node",
      "args": ["./tools/mcp/docs-server.js"],
      "env": {
        "DOCS_DIR": "./docs"
      }
    },
    "issue-tracker": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Nas Configurações MCP, internal-docs aparece como stdio com o comando node, e issue-tracker como http com a URL. Os dois ficam enabled.

Veja o que seus agentes vão carregar

Instale o Tallos, adicione seu repositório e confira as Configurações MCP antes de iniciar os agentes.

Baixar o Tallos →

Como manter os segredos do MCP fora do git?

Não coloque chaves de API nem tokens em configuração MCP que vai para o repositório. Um .mcp.json commitado fica legível para todo mundo com acesso ao repo e para todo agente que trabalha nele.

• Não commite segredos em texto puro. Deixe servidores que precisam de token pessoal na configuração de usuário do agente, fora do repo, ou use referências a variáveis de ambiente se o seu agente suportar. A sintaxe está na documentação dele.
• A máscara vale para a tela, não para o arquivo. O Tallos mascara um valor do env quando a chave parece sensível (token, secret, password, api_key, auth, bearer, cookie, session, credential, private_key) ou quando o valor parece um formato de token conhecido, como sk-… ou ghp_…. Aparece ••••••••; o arquivo no disco continua igual.
• Ignore arquivos pessoais. Se você guarda um arquivo MCP pessoal dentro da pasta do repo, coloque-o no .gitignore.
• Leia antes de rodar. Um servidor stdio é um programa que o agente executa na sua máquina. Confira os comandos nas Configurações MCP antes de abrir um agente num repo que você acabou de clonar.

As Configurações MCP funcionam com repositórios SSH?

Funcionam. Num repositório em workspace remoto, o Tallos lê os arquivos pelo sistema de arquivos remoto via SSH. O repo precisa estar conectado; se não estiver, a seção pede para você conectar primeiro. Em repositórios remotos, a criação da configuração inicial fica limitada ao .mcp.json na raiz do workspace.

As Configurações MCP aparecem em repositórios git. Projetos que são só uma pasta não têm essa seção.

Qual a relação entre servidores MCP, a CLI tallos e as skills?

Resolvem problemas diferentes e convivem bem. Servidores MCP dão ao agente ferramentas de sistemas externos. A CLI tallos e as skills incluídas deixam o agente pilotar o próprio Tallos: criar workspaces, ler terminais, usar o navegador integrado. As skills de agentes são as instruções que dizem ao agente quando usar cada coisa.