MCP Servers: Como Conectar Claude Code a Qualquer Ferramenta

MCP servers no Claude Code são pequenos programas que conectam a IA a ferramentas externas — um navegador, uma planilha, o Search Console — usando o Model Context Protocol (padrão aberto criado pela Anthropic em 2024). Na prática, eles transformam o Claude Code de “assistente que escreve código” em “assistente que executa ações” no seu Google Sheets, no seu site e na web.

Nos últimos meses montei meu fluxo de trabalho inteiro em cima disso. Hoje o mesmo terminal abre uma página no navegador, lê uma planilha de leads, consulta posições no Search Console e busca documentação atualizada — tudo sem eu trocar de aba.

Vou te mostrar como conectar cinco servers que uso de verdade: Playwright, Google Sheets, Search Console, EXA e Context7. Sem teoria solta, só o passo a passo que funciona.

O que é um MCP server e por que ele muda tudo?

Um MCP server é um conector que segue o Model Context Protocol e expõe “ferramentas” (ações que a IA pode chamar) e “recursos” (dados que ela pode ler) para um cliente como o Claude Code. Em vez de copiar e colar contexto na mão, você liga a ferramenta uma vez e a IA passa a operá-la dentro da própria conversa. O protocolo é aberto e documentado pela Anthropic na página oficial do Model Context Protocol, então o mesmo conector serve para vários clientes.

A mudança real não é técnica, é de rotina. Antes, eu pedia um relatório, exportava CSV, abria a planilha, formatava e voltava ao terminal. Agora descrevo o que quero e a IA faz o caminho inteiro.

Se você está começando no tema, vale entender antes onde os MCP servers se encaixam no fluxo de criar software com IA — eles são a ponte entre a IA e as ferramentas que você já usa no dia a dia.

Como instalar um MCP server no Claude Code?

Instalar um MCP server no Claude Code se resume a três passos — ter o Node.js instalado, declarar o server num arquivo de configuração JSON e reiniciar o terminal. O Claude Code lê esse arquivo na inicialização, sobe cada server listado e disponibiliza as ferramentas dele para a conversa. A documentação da Anthropic detalha o formato no guia oficial de MCP do Claude Code, e o padrão é sempre o mesmo independente do server.

O arquivo de configuração tem um campo mcpServers onde cada entrada define como subir o programa. O campo command diz o executável (quase sempre npx), args passa o pacote e as opções, e env carrega chaves de API quando necessário.

A estrutura mínima é esta:

{
  "mcpServers": {
    "exemplo": {
      "command": "npx",
      "args": ["-y", "nome-do-pacote-mcp"]
    }
  }
}

Depois de salvar, feche e abra o Claude Code de novo. Rode o comando que lista os servers ativos e confirme que o status aparece como conectado antes de seguir.

Como conectar o Playwright para automatizar o navegador?

O Playwright MCP conecta o Claude Code a um navegador real, permitindo que a IA abra páginas, preencha formulários, clique em botões e tire screenshots — tudo por instrução em português. Ele é mantido pela Microsoft e o repositório fica em github.com/microsoft/playwright-mcp. A grande vantagem para quem tem negócio é testar uma landing page (página de captura) ou conferir um checkout sem precisar de um QA dedicado.

A configuração é direta. Adicione o bloco abaixo ao seu arquivo de MCP servers:

"playwright": {
  "command": "npx",
  "args": ["-y", "@playwright/mcp@latest"]
}

Na primeira execução, o pacote baixa os navegadores necessários — isso pode levar um ou dois minutos. Depois disso, peça algo concreto como “abra minha landing page e verifique se o formulário envia”. A IA navega, testa e descreve o que encontrou.

Uso o Playwright para validar páginas antes de subir campanha. Em uma conta que audito, descobrimos assim que o botão de envio quebrava no celular — o que estava sangrando uns 30% dos cadastros sem ninguém perceber.

Como ligar o Google Sheets para a IA editar planilhas?

O Google Sheets MCP dá ao Claude Code permissão para ler e escrever em planilhas, o que substitui horas de trabalho manual com dados de vendas e leads. A IA passa a buscar valores, adicionar linhas, criar abas e aplicar fórmulas direto na planilha. A diferença em relação a exportar CSV é gritante, porque você pede “some os leads por origem na aba de junho” e o resultado aparece formatado, sem download nem retrabalho.

A maioria dos servers de Sheets exige autenticação via conta de serviço do Google (um tipo de credencial para acesso automatizado). O fluxo geral é:

• Criar um projeto no Google Cloud e ativar a API do Google Sheets.
• Gerar uma conta de serviço e baixar o arquivo JSON da credencial.
• Compartilhar a planilha com o e-mail dessa conta de serviço.
• Apontar o caminho do JSON no campo env do server.

Comece sempre com permissão de leitura para entender o que a IA enxerga. Só libere escrita depois de confiar no fluxo, porque um comando mal interpretado pode sobrescrever uma coluna inteira.

Para quem usa planilha como CRM improvisado, isso muda o jogo. Junto com automações de fluxo — como mostro no tutorial de n8n para WhatsApp e CRM em 30 minutos — dá para fechar o ciclo do lead inteiro.

Como conectar o Search Console para ver dados de SEO?

O Search Console MCP traz para dentro do Claude Code as métricas de busca do seu site — cliques, impressões, posição média e consultas — sem você abrir o painel do Google. A IA consulta os dados e cruza com pedidos analíticos, tipo “quais páginas perderam posição no último mês”. Para quem trabalha com SEO, é a diferença entre olhar gráfico e receber um diagnóstico pronto.

A conexão também usa conta de serviço do Google, com a propriedade do site liberada para aquele e-mail. O modo leitura já cobre 90% dos casos de uso e elimina o risco de alterar configurações sem querer.

Server	O que faz	Autenticação	Risco principal
Playwright	Automatiza navegador real	Nenhuma	Ações em sites logados
Google Sheets	Lê e escreve planilhas	Conta de serviço	Sobrescrever dados
Search Console	Consulta métricas de busca	Conta de serviço	Baixo (modo leitura)
EXA	Busca e pesquisa na web	Chave de API	Custo por consulta
Context7	Documentação atualizada	Opcional	Baixo

Em 15 anos de mercado, o que mais vejo é gente tomando decisão de SEO no achismo. Ter o Search Console respondendo perguntas em linguagem natural acelera o diagnóstico de forma que poucas ferramentas conseguem. Se SEO é prioridade no seu negócio, o pacote de 10 recursos de Claude Code para empreendedores complementa bem o que esses servers entregam.

Como usar EXA e Context7 para pesquisa e documentação?

EXA e Context7 resolvem o ponto fraco mais comum de qualquer IA de código, que é o contexto desatualizado. O EXA dá ao Claude Code uma busca na web pensada para máquinas, ótima para pesquisa de concorrência e dados recentes. O Context7 injeta documentação atualizada de bibliotecas e frameworks direto na conversa, o que reduz drasticamente as respostas inventadas sobre código.

O EXA precisa de uma chave de API, que vai no campo env. O Context7 funciona sem chave para uso básico, e o projeto fica em github.com/upstash/context7.

A configuração dos dois fica assim:

"exa": {
  "command": "npx",
  "args": ["-y", "exa-mcp-server"],
  "env": { "EXA_API_KEY": "sua-chave-aqui" }
},
"context7": {
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp"]
}

Uso o Context7 toda vez que peço código com uma biblioteca que mudou de versão recente. Em vez de a IA chutar a sintaxe antiga, ela consulta a doc atual e acerta de primeira — economiza um vai e volta enorme de correção.

O EXA entra quando preciso de dado de fora. “Pesquise os preços atuais de três concorrentes” vira um relatório em minutos, com fontes para conferir.

Quais erros mais atrapalham quem configura MCP servers?

O erro que mais trava iniciantes não é técnico, e sim de escopo — liberar permissão de escrita antes de entender o que a IA vai fazer com ela. Um server de Sheets com acesso total parece prático até a IA interpretar mal um pedido e reescrever uma aba de dados reais. A segunda armadilha é colar chave de API direto no arquivo de configuração e versionar isso por engano no Git, expondo a credencial.

Os tropeços mais comuns que vejo:

• Conceder escrita logo de cara, em vez de começar com leitura.
• Esquecer de compartilhar a planilha com o e-mail da conta de serviço.
• Deixar chave de API em arquivo versionado no Git.
• Não reiniciar o terminal depois de editar a configuração.
• Configurar cinco servers de uma vez sem testar nenhum isolado.

A regra que evita metade dos problemas é simples: suba um server por vez, teste com um pedido pequeno e só então adicione o próximo. Quem quer um ambiente mais robusto pode combinar isso com um editor dedicado — o guia do Cursor AI para desenvolvimento mostra outra forma de orquestrar IA e ferramentas no mesmo lugar.

Perguntas frequentes

O que é um MCP server no Claude Code?

É um conector que dá ferramentas externas para a IA usar durante a conversa, seguindo o Model Context Protocol. Pense nele como um adaptador entre dois lados, o Claude Code de um e o navegador, a planilha ou a busca na web do outro. Você instala o adaptador uma vez e a IA passa a operar aquela ferramenta sozinha.

Preciso saber programar para configurar um MCP server?

Para os servers prontos, não. O trabalho se resume a editar um arquivo de texto no formato JSON e rodar um comando. Programar só vira pré-requisito quando você quer construir um server próprio para um sistema interno da empresa — aí sim entra desenvolvimento de verdade.

MCP server é seguro? A IA não vai fazer besteira na minha conta?

A segurança depende do escopo que você concede, não do protocolo em si. Em modo leitura, o pior caso é a IA consultar um dado que você não queria mostrar. Em modo escrita, ela pode alterar registros — por isso a recomendação é começar restrito e aprovar manualmente qualquer ação que apague ou sobrescreva informação.

Qual a diferença entre MCP server e um plugin comum?

Plugin costuma ser fechado dentro de um app e morre ali. MCP é padrão aberto, então o mesmo server roda no Claude Code, no Cursor e em qualquer cliente compatível. Na prática, você configura a integração de Google Sheets uma vez e reaproveita em todas as ferramentas, sem refazer o trabalho a cada troca.

---

Se você quer parar de pular entre abas e deixar a IA operar suas ferramentas, comece configurando um único MCP server hoje — sugiro o Playwright, que não exige chave e mostra resultado na primeira tentativa. Depois adicione os outros conforme a necessidade, sempre testando um de cada vez. Quando o fluxo crescer e a automação começar a sustentar parte da operação, vale estruturar isso com critério, então entre em contato para desenhar um setup de IA que economize tempo de verdade, sem virar gambiarra.