O que é MCP no Claude Desktop e o que muda quando você conecta um servidor?

MCP é o Model Context Protocol, um padrão aberto lançado pela Anthropic em 25 de novembro de 2024 para ligar assistentes de IA aos sistemas onde os dados vivem. Na prática, o MCP no Claude Desktop funciona assim: o app é o cliente e o servidor que você conecta expõe três coisas ao modelo, tools (funções com nome, descrição e JSON Schema), resources (contexto legível por URI) e prompts (modelos reutilizáveis). O ganho depende do servidor escolhido, e antes de qualquer ação o Claude pede sua aprovação explícita, então o freio continua na sua mão
Fala aí, beleza? A sigla MCP aparece em praticamente todo tutorial de Claude, e quase nunca alguém para pra explicar o que ela é de verdade
MCP é o que liga o Claude Desktop aos seus dados e às suas ferramentas: sem isso, o modelo só conversa com você e com aquilo que você cola na janela
Aqui eu te conto o que é o protocolo, o que muda na conversa depois que um servidor entra, como conectar um e qual o preço disso (porque tem preço, e não é só o da assinatura)
O que é o Model Context Protocol (MCP)
Pensa no MCP como a resposta pro problema do "cada integração é um cabo diferente"
Ele foi anunciado e liberado como código aberto pela Anthropic em 25 de novembro de 2024, como padrão para conectar assistentes de IA aos sistemas onde os dados vivem
Se você já mexeu com API REST, a lógica é familiar: um contrato combinado entre as duas pontas, pra que qualquer cliente fale com qualquer servidor sem gambiarra no meio
Formação Claude Code
Domine Claude Code do absoluto zero até o avançado
- 116 aulas
- 4 projetos
- 9h 23min
Quem governa o MCP hoje?
Esse ponto mudou e muita gente não percebeu
O protocolo deixou de ser exclusividade da Anthropic e foi doado à Agentic AI Foundation, um fundo dirigido sob a Linux Foundation
Segundo o anúncio dos mantenedores, MCP é projeto fundador dessa fundação, co-fundada por Anthropic, Block e OpenAI, e os mantenedores seguem com autonomia técnica
A versão vigente da especificação é a 2026-07-28, que tornou o núcleo do protocolo stateless: saíram as sessões em nível de protocolo e o header Mcp-Session-Id, e as respostas de tools/list, prompts/list, resources/list e resources/read passaram a carregar ttlMs e cacheScope pra permitir cache
Cliente e servidor: quem é quem?
Aqui mora a confusão mais comum
O cliente é o app que você usa, no nosso caso o Claude Desktop
O servidor MCP é um programa separado, que pode rodar na sua máquina ou em algum lugar da internet, e que oferece capacidades pro cliente consumir
O Claude não "aprende" nada novo sozinho: ele passa a ter um canal padronizado pra conversar com o que aquele servidor resolveu expor
O que o Claude passa a enxergar depois de conectar um servidor
Um servidor MCP expõe três primitivas ao cliente, e entender essas três já resolve a maior parte da dúvida sobre o ganho real
Tools: as funções que o modelo pode chamar
São funções chamáveis, cada uma com nome, descrição e um JSON Schema de entrada
Na conversa do dia a dia isso significa que o Claude deixa de só falar sobre a tarefa e passa a poder executar uma ação daquele servidor, respeitando o formato de entrada que a tool declarou
A descrição é o que o modelo lê pra decidir quando usar aquilo, guarda essa informação porque ela volta lá na parte de risco 👀
Resources: contexto legível identificado por URI
Resource é conteúdo que o servidor disponibiliza pra leitura, identificado por uma URI
É o caminho de "olha, esse material existe e está aqui", sem você precisar copiar e colar nada dentro do chat
Prompts: modelos reutilizáveis oferecidos pelo servidor
O servidor também pode entregar modelos de prompt prontos pra reuso
Se você já viu como funciona uma skill no Claude, a ideia de empacotar instrução repetida em algo reaproveitável vai soar bem parecida, muda só quem oferece o pacote
Resumo honesto: o Claude passa a enxergar funções, conteúdo e instruções que aquele servidor específico escolheu publicar, nada além disso
Como conectar um servidor MCP local no Claude Desktop
O caminho local é o mais direto pra entender o mecanismo, porque tudo fica visível num arquivo só
- Abra Configurações (Settings) > Developer > Edit Config dentro do próprio app: ele abre o arquivo de configuração e cria o arquivo caso ele ainda não exista
O erro comum deste passo é sair caçando o arquivo no disco antes de passar por aqui, se ele nunca foi criado você não acha coisa nenhuma
- Saiba onde esse arquivo mora, porque isso ajuda a fazer backup e a comparar máquinas
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Declare o servidor dentro da chave
mcpServers, com o comando e os argumentos que o Claude Desktop vai executar ao iniciar
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/caminho/permitido"
]
}
}
}
O erro comum deste passo é apontar o caminho permitido pra pasta inteira do usuário só pra "facilitar": esse argumento é justamente o limite do que o servidor alcança, então quanto mais estreito, melhor
- Feche o Claude Desktop por completo e abra de novo, o reinício completo é obrigatório pro app carregar a configuração e subir o servidor
O erro comum deste passo é clássico: minimizar a janela (ou fechar só a janela) e ficar bravo achando que o servidor não funcionou
- Peça algo que use o servidor e acompanhe as aprovações: antes de executar qualquer ação, por exemplo uma operação de arquivo, o Claude pede aprovação explícita
Cada ação precisa ser aceita por você, o controle fica com quem está usando, e isso é feature, não burocracia 🙂
Servidor local, conector remoto ou extensão: qual caminho usar
Existem três formas de plugar um servidor, e elas não são intercambiáveis
| Caminho | Onde o servidor roda | Como entra | Ponto de atenção |
|---|---|---|---|
| Servidor local via JSON | Na sua máquina, iniciado pelo próprio app | Editando claude_desktop_config.json na chave mcpServers |
Exige reiniciar o aplicativo por completo depois de salvar |
| Conector customizado (MCP remoto) | Fora da sua máquina, acessado pela nuvem da Anthropic | Em Connectors, botão "+", nome e URL do conector, avançado opcional com OAuth Client ID e secret, depois "Add" | Disponível no Claude, no Cowork e no Claude Desktop nos planos Free, Pro, Max, Team e Enterprise, com limite de 1 conector customizado no Free |
| Desktop Extension | Servidor empacotado, instalado no app | Arrastando o arquivo .dxt (renomeado para .mcpb) em Settings > Extensions |
Traz servidor, dependências e manifest.json juntos, sem edição de JSON, e ambas as extensões seguem aceitas |
Se o teu objetivo é mexer em coisa que só existe no teu computador, o caminho é local ou extensão
Se é integrar um serviço que vive na web, o conector remoto é o desenho certo
Para que serve na prática conectar um servidor MCP
O alcance depende inteiramente do que cada servidor expõe, então prefiro falar de cenários que os próprios exemplos oficiais sustentam
- Leitura de arquivos de uma pasta autorizada: o exemplo do
server-filesystemexiste justamente pra isso, você aponta um caminho e o Claude passa a poder operar ali dentro, com aprovação a cada ação - Contexto de sistema interno como resource: em vez de você colar documento no chat, o servidor publica aquilo por URI e o modelo lê de lá
- Prompts padronizados distribuídos pelo servidor: o time inteiro passa a usar o mesmo modelo de instrução, entregue pela ferramenta e não por um print no grupo
Ou seja: MCP não amplia o que o modelo sabe, amplia o que ele consegue alcançar
Limites e riscos: o que costuma dar errado
Agora a parte que os tutoriais de "conecta em 2 minutos" pulam
Sintoma: criei o conector remoto e ele não enxerga meu sistema interno
A causa é arquitetural e pega muita gente de surpresa
Conectores customizados são acessados a partir da infraestrutura em nuvem da Anthropic, não do seu computador, mesmo quando você está usando o Claude Desktop
O servidor precisa estar acessível pela internet pública a partir das faixas de IP da Anthropic, então servidor em rede corporativa privada, atrás de VPN ou bloqueado por firewall simplesmente não conecta
Como prevenir: se a coisa vive dentro da sua rede, escolha o caminho local desde o começo em vez de brigar com o conector
Sintoma: o Claude fez algo estranho e ninguém pediu aquilo
Existe uma classe de ataque documentada chamada tool poisoning, que é injeção indireta de prompt pela descrição da ferramenta
Como o agente lê a descrição das tools pra decidir como usá-las, instrução maliciosa escondida ali pode ser executada a cada invocação, de forma silenciosa, até alguém perceber
Não é paranoia de nicho: a Microsoft publicou orientação específica de proteção contra injeção indireta em MCP, com controles do lado do cliente e do host
E vale aqui a mesma pergunta incômoda de sempre, a de quem vê o seu código quando você pluga a IA no teu ambiente
Como prevenir: ler o que você está instalando, manter poucos servidores ligados e levar a sério cada tela de aprovação em vez de clicar no automático
Sintoma: confiei porque o servidor era oficial
Selo oficial não é atestado de segurança
Em novembro de 2025 o servidor Git MCP oficial da Anthropic teve vulnerabilidades críticas reportadas: path validation bypass, argument injection e inicialização insegura de repositório
Como prevenir: tratar servidor MCP como dependência de software normal, ou seja, atualizar, acompanhar e limitar o escopo do que ele pode tocar
Sintoma: tutorial mandando configurar HTTP+SSE
Esse transporte foi substituído por Streamable HTTP na revisão de protocolo 2025-03-26 e consta na especificação como depreciado, mantido só por compatibilidade
Como prevenir: quando o material for antigo, confira o transporte antes de copiar configuração, Streamable HTTP é o transporte atual pra servidores remotos
O freio que atravessa todos esses casos é o mesmo: a aprovação explícita por ação, antes de qualquer execução
Contexto conectado custa contexto: o que aprendi cuidando de token
Tem um efeito colateral do MCP que ninguém coloca no folheto: servidor conectado ocupa contexto, mesmo parado
Essa parte eu vivi no Claude Code, não no Claude Desktop, e faço questão de separar as duas coisas em vez de chutar que o comportamento é idêntico
No vídeo eu mostro que ao iniciar uma sessão o Claude já sobe conectado a vários servidores MCP, sem que eu tenha pedido nada naquele momento
Mostro também um caso chato: um servidor que instalei de forma global pra um teste pontual continua sendo carregado nos projetos seguintes, e o modelo acaba usando ele sem necessidade, porque a descrição parece encaixar no prompt
O custo não é só a chamada em si: cada servidor conectado joga as ferramentas dele no contexto, o contexto fica poluído e isso se paga em token
Quando abro a listagem dos servidores ativos, aparecem servidores de escopos diferentes (do usuário e do projeto), e é aí que a ficha cai de que dá pra estar carregando coisa que você nem lembra de ter ligado
Minha recomendação depois disso ficou simples: começar sem nenhum servidor conectado, ligar só quando a tarefa realmente pedir, preferir habilitar por projeto em vez de deixar tudo global e revisar no início de cada projeto o que está ativo
Traduzindo pro assunto daqui: como tools, resources e prompts entram na conversa, a pergunta certa antes de plugar mais um servidor é "eu vou usar isso hoje?"
Conclusão
MCP é padronização de acesso, não superpoder automático
O protocolo é aberto, nasceu na Anthropic em novembro de 2024, hoje é projeto fundador da Agentic AI Foundation sob a Linux Foundation e está na especificação 2026-07-28
O ganho vem do servidor que você escolhe (tools, resources e prompts que ele expõe) e o risco vem exatamente do quanto você confia nele, incluindo servidor oficial
Próximo passo que eu sugiro: conecte um servidor local simples, aprove as ações uma a uma e observe o que muda na conversa antes de sair somando conector
Depois disso a decisão de manter ou desligar fica óbvia, e o teu contexto agradece 😀
até o próximo post!
Perguntas frequentes
Dá pra instalar um servidor MCP no Claude Desktop sem editar o arquivo JSON?
Dá sim, o caminho é o Desktop Extensions: um arquivo empacotado no formato .dxt (renomeado para .mcpb) que já traz o servidor, as dependências e um manifest.json. Você instala arrastando esse arquivo em Settings > Extensions, sem tocar no claude_desktop_config.json. As duas extensões, .dxt e .mcpb, continuam sendo aceitas.
Um servidor MCP remoto conecta se estiver atrás de VPN corporativa ou firewall?
Não. Conectores customizados (servidores MCP remotos) são acessados a partir da infraestrutura em nuvem da Anthropic, e não do seu computador, mesmo dentro do Claude Desktop. O servidor precisa estar acessível pela internet pública a partir das faixas de IP da Anthropic, então servidor em rede privada, atrás de VPN ou bloqueado por firewall simplesmente não conecta.
Quantos conectores customizados um usuário do plano Free pode usar no Claude Desktop?
O usuário do plano Free fica limitado a 1 conector customizado. Nos planos Pro, Max, Team e Enterprise esse limite de 1 não se aplica, e os conectores customizados via MCP remoto ficam disponíveis também no Claude e no Cowork, além do Claude Desktop.
O que é tool poisoning num servidor MCP?
É a injeção indireta de prompt escondida na descrição de uma tool. O agente lê essa descrição pra decidir como e quando usar a ferramenta, então uma instrução maliciosa ali dentro pode ser executada a cada chamada, de forma silenciosa, até alguém perceber. É um risco documentado do modelo, e a Microsoft publicou orientação específica de proteção contra ataques de injeção indireta em MCP, com recomendação de controles do lado do cliente e do host.
Servidor MCP oficial da Anthropic é garantia de segurança?
Não é. Em novembro de 2025 o próprio servidor Git MCP oficial da Anthropic teve vulnerabilidades críticas reportadas, incluindo path validation bypass, argument injection e inicialização insegura de repositório. Ser oficial reduz risco de origem duvidosa, mas não substitui revisão e atualização do servidor.
Preciso aprovar manualmente cada ação de um servidor MCP conectado?
Sim, e isso é proposital. Antes de executar qualquer ação do servidor, como uma operação de arquivo, o Claude pede aprovação explícita do usuário. Cada ação precisa ser aceita por você, então o controle final fica sempre com quem está usando o app.
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 27min
Blog | Mais populares
O que são servidores MCP no Claude Code e quando eles valem a pena?
Servidores MCP no Claude Code conectam o agente a bancos, docs e ferramentas externas. Entenda como funcionam e quando realmente valem a pena usar.
Context7 MCP no Claude Code: como parar de receber código de uma versão antiga da biblioteca
Context7 MCP no Claude Code busca a documentação atual da biblioteca e evita código desatualizado. Veja como instalar, os comandos e os planos Free e Pro.
Supabase MCP no Claude Code: como conectar o agente ao schema do seu banco
Supabase MCP no Claude Code conecta o agente ao schema real do seu banco: veja como instalar, autenticar via OAuth e por que usar só em desenvolvimento.
