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

conexão de servidor MCP no Claude Desktop
Resposta rápida

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
Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

  • 120 aulas
  • 4 projetos
  • 9h 45min

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ó

  1. 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

  1. 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
  1. 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

  1. 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

  1. 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-filesystem existe 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.




Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 27min

Blog | Mais populares