Mods ou servidores MCP no Claude Code: qual a diferença e o que cada um adiciona?

Fala aí, beleza? Se você viu os mods aparecendo no Claude Code e ficou na dúvida se é a mesma coisa que servidor MCP, se liga: os dois NÃO competem

Eles resolvem problemas diferentes 🙂

Os mods chegaram em 1º de outubro de 2026, na versão 2.1.287 do Claude Code, e a confusão é bem natural, porque tanto mod quanto servidor MCP podem chegar até você dentro de um plugin

Resumindo de cara: o MCP amplia o que o Claude consegue acessar, e o mod mexe na sessão por dentro, nos eventos e no que aparece na tela

Bora destrinchar cada um?

O que é um servidor MCP no Claude Code?

Pela documentação oficial de MCP, servidores MCP são processos ou serviços externos que dão ferramentas ao Claude

E o que é o MCP em si?

É um padrão aberto pra conectar agentes a ferramentas e fontes de dados externas, tipo bancos de dados e APIs como Slack e GitHub, sem você precisar escrever uma implementação própria de ferramenta

Pensa num adaptador universal: o serviço fala MCP, o Claude fala MCP, e os dois se entendem sem gambiarra no meio

Se quiser ir mais fundo no assunto, tem um post só sobre quando servidores MCP valem a pena

Tipos de servidor: HTTP e stdio

Existem dois tipos de servidor MCP:

• HTTP: remoto, hospedado pelo provedor do serviço
• stdio: processo local, rodando na sua máquina

Como adicionar um servidor MCP

O comando é o claude mcp add

O exemplo oficial conecta o Stripe com escopo de usuário:

claude mcp add --scope user --transport http stripe https://mcp.stripe.com

Tem o passo a passo completo de como adicionar servidor MCP pelo terminal, caso você queira detalhar cada flag

Escopos: local, user e project

Aqui mora uma pegadinha que muita gente ignora

• local (padrão): só você, só no projeto atual, gravado em ~/.claude.json
• user (--scope user): vale pra todos os seus projetos, também em ~/.claude.json, na chave mcpServers
• project (--scope project): compartilhado com o time via .mcp.json na raiz do projeto

Tome cuidado com o escopo project: quem clona o repositório precisa aprovar o servidor, então não estranhe se o colega abrir o projeto e o MCP não subir sozinho

Conferindo o status com /mcp

Dentro da sessão, o /mcp mostra o status dos servidores (aparece connected quando está tudo saudável)

Ele também cuida do login no navegador pros servidores que exigem autenticação

O que é um mod no Claude Code?

Segundo a documentação oficial de mods, um mod é um plugin que muda a aparência e o comportamento do Claude Code

Por baixo dos panos, ele é formado por handlers de eventos em JavaScript ou TypeScript, que o Claude Code chama quando algo acontece

Que eventos?

O Claude Code dispara eventos em cada ponto em que está prestes a agir:

• quando roda uma ferramenta (tool.call)
• quando envia um prompt (prompt.submit)
• quando manda uma requisição ao modelo
• quando uma sessão começa ou termina

E o handler pode fazer três coisas com o evento: observar, alterar ou assumir o controle dele

É MUITO poder, né? 😀

Onde um mod consegue desenhar na tela

A referência lista os render sites, que são os pontos da interface onde um mod pode desenhar, no Terminal e no Desktop:

• AbovePrompt
• ToolUse
• ToolResult
• ToolGroup
• AskUserQuestion
• ToolProgress
• PromptHint

Estrutura mínima de um mod

A estrutura é bem enxuta:

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

O plugin.json é o manifesto do plugin

O que transforma esse plugin em mod é a chave modules dentro do hooks.json, que aponta pro arquivo de código

E o ponto de entrada (register.js ou register.ts) exporta register(on, options)

Detalhe massa: o Claude Code carrega .js e .ts direto, sem precisar de Node.js, bundler ou etapa de build

Nada de configurar meio mundo de ferramenta antes de escrever a primeira linha haha

Pra usar mods, você precisa do Claude Code v2.1.287 ou superior

Como testar e instalar um mod

Como o mod vem dentro de um plugin, você instala e compartilha ele igual a qualquer plugin

Pra carregar o mod só numa sessão (ótimo pra testar antes de instalar de vez), usa a flag --plugin-dir:

claude --plugin-dir ./first-mod

Pra instalar, roda /plugin install nome@marketplace dentro da sessão ou claude plugin install nome@marketplace no shell

Ou seja: o --plugin-dir é o equivalente do mod a um test drive, e o plugin install é quando você leva o carro pra casa haha

Mod vs MCP: comparação lado a lado

Colocando os dois na mesma mesa:

A linha que mais importa é a primeira: o mod está DENTRO do Claude Code, o MCP está fora entregando ferramenta

Todo o resto é consequência disso

Onde mod e MCP se encontram: tool.call e plugins

Agora vem a parte que desfaz de vez a confusão

O evento tool.call de um mod enxerga cada ferramenta que o Claude está prestes a usar e pode recusar a chamada, alterar os argumentos ou deixar passar

E ele dispara também em chamadas a ferramentas MCP e em chamadas feitas por subagentes

Ou seja: um mod pode vigiar o que o MCP faz 🙂

O MCP traz a ferramenta, o mod decide se aquela chamada específica passa ou não

Outro ponto de encontro: plugins também podem empacotar servidores MCP, que funcionam igual aos que você configura na mão

O Claude Code inicia esses servidores quando você habilita o plugin, e dá pra desligá-los no /mcp sem remover o plugin

Então um mesmo plugin pode trazer os dois juntos, e é daí que vem boa parte do nó na cabeça

Mod, hook de settings e skill: não são a mesma coisa

Se você já usa hooks, provavelmente pensou: "mod é só um hook novo, né?"

Não é

Os hooks de settings são comandos de shell, requisições HTTP ou prompts que o Claude Code executa em eventos do ciclo de vida

Eles agem de fora, no mesmo time que skills, status lines e servidores MCP: rodam um script ou entregam texto e ferramentas ao Claude

Já o mod é um conjunto de funções dentro de um plugin, que o Claude Code chama no próprio processo

A diferença parece sutil, mas é ela que permite ao mod mexer na interface e segurar um evento por dentro

Quando usar MCP e quando usar um mod

Use MCP quando:

• o Claude precisa acessar algo que ele não alcança hoje
• você quer conectar um banco de dados ou uma API
• o serviço é tipo Stripe, GitHub ou Slack

Use um mod quando:

Você quer mudar como a sessão se comporta ou aparece

Os exemplos que a própria Anthropic cita:

• previsão de quanto a janela de contexto vai encher
• bloqueio de comandos arriscados como rm -rf ou force push (adeus aos rm -rf da vida xD)
• um comando /replay que percorre as edições do último turno
• um painel desenhado ao lado da conversa
• um estilo diferente pro spinner
• pausar uma chamada de ferramenta pra fazer uma pergunta ao usuário
• mandar uma requisição pra outro modelo

E dá pra ir além: reescrever um prompt, adicionar UI nova, substituir um recurso nativo ou criar funcionalidade nova

O caso combinado

O cenário mais interessante é usar os dois

O MCP traz a ferramenta (o Stripe, por exemplo), e o mod controla o uso dela via tool.call, recusando, alterando argumentos ou liberando cada chamada

Segurança: o que um mod pode fazer com a sua máquina

Aqui é sério, beleza?

Um mod roda com as suas permissões e NÃO fica em sandbox

Na prática, ele pode:

• ler seus arquivos e suas chaves de API
• ver todos os seus prompts
• aprovar chamadas de ferramenta
• gastar o seu uso

A recomendação oficial é instalar mods só de autores e marketplaces confiáveis

E faz sentido: rodar dentro do processo é justamente o que dá poder ao mod, e é o mesmo motivo pelo qual um mod mal-intencionado pode fazer estrago

Se você administra o Claude Code numa empresa, existe uma página oficial chamada Manage mods for your organization, voltada pra gerenciar mods na organização

Veredito: mod ou MCP, qual você precisa?

Na real, não é uma escolha entre um ou outro

O MCP amplia o alcance do Claude

O mod muda a sessão por dentro

A regra prática que resolve a maioria das dúvidas:

• se a pergunta é "o Claude consegue acessar X?", é MCP
• se a pergunta é "quero controlar ou ver diferente o que o Claude faz", é mod

Só lembra do custo de confiança: o mod roda in-process, sem sandbox, então a régua pra instalar um mod de terceiro tem que ser bem mais alta do que pra conectar um MCP de um serviço que você já usa

Próximo passo

Se quiser colocar a mão na massa, o caminho é esse:

1. Confere se o seu Claude Code está na v2.1.287 ou superior, sem isso os mods nem aparecem
2. Pra experimentar um mod, carrega ele numa sessão isolada antes de instalar de vez:

claude --plugin-dir ./first-mod

3. Gostou? Instala como plugin, dentro da sessão com /plugin install token-chart@your-org ou no shell:

claude plugin install token-chart@your-org

4. Pra MCP, adiciona um servidor com claude mcp add e checa no /mcp se ele aparece como connected

E se não estiver a fim de escrever o mod do zero, dá pra pedir ao próprio Claude Code que escreva pra você 😛

Só não esquece de ler o código antes, afinal ele vai rodar com as suas permissões

Até o próximo post!