Qual a diferença entre ferramenta e recurso num servidor MCP?

Uma ferramenta é uma ação que o agente executa no sistema externo, como consultar um banco ou criar uma tarefa. Um recurso é um dado que ele lê, como o conteúdo de uma tarefa ou um documento. Ferramentas agem; recursos informam. É a mesma distinção do agente entre agir e explorar.

O que são os comandos de um servidor MCP?

São atalhos prontos que alguns servidores trazem e que aparecem no menu de comandos do Claude Code, aquele da barra. São um bônus da conexão: além de ferramentas e recursos, você às vezes ganha comandos úteis já feitos para tarefas comuns naquele serviço, sem precisar criá-los.

Devo conectar todos os servidores que existem?

Não. Conecte as ferramentas que você de fato usa com frequência ao lado do Claude Code. Servidores que você nunca vai usar só adicionam complexidade e ampliam a superfície de segurança sem retorno. A regra é a moderação: conecte o que agrega ao seu trabalho, não tudo que é possível.

Como sei quais ferramentas um servidor conectado tem?

O Claude Code oferece um comando próprio para gerenciar os servidores MCP e ver o que cada um disponibiliza. Assim você confere as ferramentas e os recursos de cada servidor conectado. Na prática, o agente já usa o que faz sentido automaticamente, mas dá para inspecionar quando quiser entender o que está à disposição.

Módulo 13 - MCP: conectando o Claude Code ao mundo

O que um servidor MCP oferece

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Distinguir ferramentas, recursos e comandos de um servidor MCP.
Ver exemplos de cada um.
Entender o que o agente ganha ao conectar um servidor.
Escolher servidores conforme a necessidade.

Três tipos de coisa que um servidor oferece

Quando você conecta um servidor MCP, o Claude Code ganha acesso a três tipos de coisa, e entender cada um ajuda a enxergar o valor da conexão. O primeiro são as ferramentas: ações que o agente pode executar no sistema externo. Um servidor de banco de dados oferece a ferramenta de consultar o banco; um servidor de rastreador oferece a de criar uma tarefa; um servidor de mensagens, a de enviar uma mensagem. São como as ferramentas internas que você viu no módulo do fluxo agêntico, ler, editar, rodar, só que agora atuando fora do seu projeto, no sistema externo. As ferramentas MCP são o que dá ao agente o poder de AGIR no mundo além do código.

O segundo tipo são os recursos: dados que o servidor disponibiliza para o agente LER. Enquanto uma ferramenta age, um recurso informa. Um servidor de rastreador pode oferecer o conteúdo de cada tarefa como recurso; um de documentação, o texto de cada documento; um de perfis, os dados de cada usuário. O agente consulta esses recursos para se informar antes de agir. A distinção entre ferramenta e recurso espelha a distinção do próprio agente entre agir e explorar: recursos são para explorar o sistema externo, ferramentas são para agir nele. Juntos, dão ao Claude Code tanto o conhecimento quanto a capacidade de operar fontes de fora.

Diagrama de um servidor MCP conectado ao Claude Code, oferecendo três caixas rotuladas: ferramentas (ações como consultar e criar, com um ícone de engrenagem), recursos (dados para ler, com um ícone de documento) e comandos (atalhos prontos, com um ícone de barra), cada uma alimentando o agente. — Um servidor MCP oferece ferramentas (agir), recursos (ler) e comandos prontos ao Claude Code.

Comandos prontos que vêm de graça

O terceiro tipo são os comandos. Alguns servidores MCP trazem comandos prontos, que aparecem no menu de comandos do Claude Code, aquele que você abre com a barra. São atalhos que o servidor oferece para tarefas comuns naquele serviço, sem você precisar criá-los. Por exemplo, um servidor de revisão pode trazer um comando de revisar segurança pronto para uso. É um bônus da conexão: além de ferramentas e recursos, você às vezes ganha comandos úteis já feitos. Isso conecta com o módulo de comandos: assim como você cria os seus, os servidores MCP podem contribuir com comandos prontos, expandindo o seu menu sem esforço.

Tipo	O que é	Exemplo
Ferramenta	Uma ação num sistema externo	Consultar um banco, criar uma tarefa
Recurso	Um dado para o agente ler	O conteúdo de uma tarefa, um documento
Comando	Um atalho pronto no menu	Um comando de revisão que o servidor traz

Os três tipos de coisa que um servidor MCP oferece: agir, ler e atalhos prontos.

🎮 Jogo da aula

Ferramenta, recurso ou comando?

Classifique cada oferta de um servidor MCP conforme ela é uma ferramenta (agir), um recurso (ler) ou um comando (atalho).

Na prática, você não precisa memorizar o que cada servidor oferece; ao conectar um, o Claude Code passa a saber o que ele traz, e você pode ver as ferramentas e recursos disponíveis por um comando próprio. O importante é entender o modelo: conectar um servidor MCP é como contratar um serviço especializado que passa a poder agir e informar em nome do agente naquele domínio. Um servidor de banco de dados vira o especialista em banco; um de mensagens, o especialista em mensagens. Cada conexão amplia o alcance do Claude Code numa direção, e você escolhe as direções que fazem sentido para o seu trabalho.

Escolher os servidores certos

Com centenas de servidores disponíveis, a escolha certa é a que reflete o seu trabalho real. Não faz sentido conectar tudo que existe; faz sentido conectar as ferramentas que você de fato usa com frequência ao lado do Claude Code. Se o seu dia envolve um certo rastreador de tarefas, um certo banco e um certo serviço de mensagens, esses três são os candidatos naturais. Conectar servidores que você nunca vai usar só adiciona ferramentas e complexidade sem retorno, e ainda amplia a superfície de segurança, tema da próxima aula. A regra é a mesma da moderação que atravessa o curso: conecte o que agrega, não tudo que é possível.

Com o que um servidor oferece entendido, você já enxerga o valor de conectar uma fonte externa: ferramentas para agir, recursos para ler, comandos de brinde. A próxima aula mostra o lado prático, como de fato conectar um servidor ao Claude Code, com os tipos de conexão e onde a configuração vive. Você vai ver que, para servidores prontos, conectar é um comando simples, e que a lógica de escopo, do projeto ou pessoal, é a mesma que você já domina de outros recursos. O mundo externo está cada vez mais perto, e conectá-lo é mais fácil do que parece.

Teste rápido

Quais são os três tipos de coisa que um servidor MCP oferece ao Claude Code?

Perguntas frequentes

Qual a diferença entre ferramenta e recurso num servidor MCP?: Uma ferramenta é uma ação que o agente executa no sistema externo, como consultar um banco ou criar uma tarefa. Um recurso é um dado que ele lê, como o conteúdo de uma tarefa ou um documento. Ferramentas agem; recursos informam. É a mesma distinção do agente entre agir e explorar.
O que são os comandos de um servidor MCP?: São atalhos prontos que alguns servidores trazem e que aparecem no menu de comandos do Claude Code, aquele da barra. São um bônus da conexão: além de ferramentas e recursos, você às vezes ganha comandos úteis já feitos para tarefas comuns naquele serviço, sem precisar criá-los.
Preciso memorizar o que cada servidor oferece?: Não. Ao conectar um servidor, o Claude Code passa a saber o que ele traz, e você pode ver as ferramentas e recursos disponíveis por um comando próprio. O importante é entender o modelo: cada servidor conectado vira um especialista que pode agir e informar naquele domínio em nome do agente.
Devo conectar todos os servidores que existem?: Não. Conecte as ferramentas que você de fato usa com frequência ao lado do Claude Code. Servidores que você nunca vai usar só adicionam complexidade e ampliam a superfície de segurança sem retorno. A regra é a moderação: conecte o que agrega ao seu trabalho, não tudo que é possível.
Como sei quais ferramentas um servidor conectado tem?: O Claude Code oferece um comando próprio para gerenciar os servidores MCP e ver o que cada um disponibiliza. Assim você confere as ferramentas e os recursos de cada servidor conectado. Na prática, o agente já usa o que faz sentido automaticamente, mas dá para inspecionar quando quiser entender o que está à disposição.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← O que é o MCP Concluir e avançar →