Entenda os três tipos de recursos que um MCP Server pode expor e quando usar cada um para criar integrações poderosas.
Tools são o tipo de recurso mais poderoso e mais utilizado no ecossistema MCP. Elas representam ações concretas que o modelo de IA pode executar — funções com parâmetros bem definidos que permitem consultar APIs, executar scripts, enviar mensagens, processar dados e interagir com sistemas externos. O modelo analisa o contexto da conversa, decide quando uma tool é necessária, seleciona a mais adequada e define os parâmetros corretos para a chamada.
Uma Tool no MCP é uma função executável que o servidor expõe ao modelo de IA. Cada tool possui um nome, uma descrição, e um esquema de parâmetros (JSON Schema) que define exatamente quais dados ela espera receber. O modelo decide quando e como chamá-las com base no contexto da conversa — sem intervenção humana obrigatória.
Tools são de longe o tipo de recurso mais utilizado no ecossistema MCP. Estima-se que cerca de 80% dos MCP Servers publicados expõem pelo menos uma tool — muitos expõem exclusivamente tools. Isso reflete o caso de uso mais comum: permitir que o modelo de IA execute ações no mundo real, desde consultas simples até operações complexas em múltiplos sistemas.
Resources representam dados e conteúdos que o servidor MCP disponibiliza para o modelo consultar. Diferente das tools, resources não executam ações — elas funcionam como arquivos virtuais que o modelo pode ler quando precisa de informação. Documentos, registros de banco de dados, configurações do sistema, logs, esquemas — tudo pode ser exposto como resource. Cada resource é identificada por um URI único que segue um esquema padronizado.
Uma Resource no MCP é um dado ou conteúdo que o servidor expõe para leitura. Cada resource possui um URI (Uniform Resource Identifier) que a identifica de forma única — por exemplo, file:///config/settings.json ou db://users/schema. O modelo lê a resource quando precisa de contexto adicional, mas não executa ações através dela. Resources são passivas — elas informam, não transformam.
Pense em Resources como uma biblioteca — o modelo vai até a estante, consulta o livro que precisa, absorve a informação e volta para a conversa com mais contexto. Ele não altera os livros, não reorganiza a estante, não escreve novas páginas. Apenas lê e consulta. Se você precisa que o modelo faça algo com os dados (alterar, enviar, processar), isso é trabalho para uma Tool — não uma Resource.
Prompts são o terceiro tipo de recurso no MCP — e o mais sutil. Eles permitem que o servidor forneça templates reutilizáveis de instruções estruturadas que guiam o comportamento do modelo em tarefas específicas. Em vez de o usuário escrever manualmente "analise este código e encontre bugs", o servidor pode expor um prompt pré-definido como code_review que já contém todas as instruções necessárias. O usuário ou o modelo pode invocar esses prompts.
Um Prompt no MCP é um template de instrução que o servidor expõe para ser invocado pelo usuário ou pelo modelo. Cada prompt tem um nome, uma descrição, e pode aceitar parâmetros (argumentos) que personalizam a instrução. Exemplos: "analise este código" (com parâmetro de linguagem), "gere relatório de vendas" (com parâmetro de período), "resuma este documento" (com parâmetro de formato). Prompts encapsulam expertise e boas práticas em instruções reutilizáveis.
A chave para dominar o MCP é entender a distinção clara entre os três tipos de recursos. Tools são ações (verbos) — elas fazem coisas. Resources são dados (substantivos) — elas informam. Prompts são instruções (templates) — elas guiam. Tools podem alterar estado no mundo real, Resources são estritamente de leitura, e Prompts moldam o comportamento do modelo sem executar nem ler diretamente.
| Aspecto | Tools | Resources | Prompts |
|---|---|---|---|
| Natureza | Ações (verbos) | Dados (substantivos) | Instruções (templates) |
| Função | Executar operações | Fornecer informação | Guiar comportamento |
| Altera estado? | Sim | Não (leitura) | Não (orientação) |
| Quem invoca? | O modelo decide | O modelo consulta | Usuário ou modelo |
| Exemplo | send_email() | file:///readme.md | code_review |
Pense assim: Tools fazem, Resources informam, Prompts guiam. Quando você quer que o modelo faça algo (enviar, criar, deletar, processar), use uma Tool. Quando quer que ele saiba algo (ler dados, consultar configurações, acessar documentos), use uma Resource. Quando quer que ele siga um padrão (analisar código de certa forma, gerar relatório em formato específico), use um Prompt.
A melhor forma de entender a distinção entre Tools, Resources e Prompts é ver como eles se manifestam em servidores MCP reais. Cada servidor combina os três tipos de acordo com seu domínio — um server de GitHub usa tools diferentes de um server de banco de dados, mas ambos seguem a mesma lógica de separação entre ações, dados e instruções.
Veja como os três tipos de recursos se aplicam em servidores MCP do mundo real:
Tools para criar, mover e deletar arquivos. Resources para ler conteúdo e listar diretórios. Prompts para organizar projetos e analisar estrutura de pastas.
Tools para enviar e responder e-mails. Resources para acessar caixa de entrada e contatos. Prompts para redigir mensagens profissionais e resumir threads.
Tools para criar alertas e escalar incidentes. Resources para acessar métricas e logs em tempo real. Prompts para diagnosticar problemas e gerar post-mortems.
Um servidor MCP verdadeiramente poderoso não se limita a um único tipo de recurso — ele combina Tools, Resources e Prompts de forma inteligente para criar uma experiência completa. A sinergia entre os três tipos é o que transforma um servidor simples em uma integração robusta e versátil, capaz de atender cenários complexos do mundo real.
Imagine um servidor MCP de e-commerce completo:
Os três tipos trabalham juntos: o Prompt de atendimento guia o modelo, as Resources informam sobre produtos e pedidos, e as Tools executam ações como processar devoluções ou aplicar descontos.
Ao projetar seu servidor MCP, comece identificando os três pilares: quais ações o modelo precisa executar (Tools), quais dados ele precisa consultar (Resources) e quais padrões de comportamento devem ser reutilizáveis (Prompts). Nem todo servidor precisa dos três — muitos funcionam perfeitamente só com Tools — mas os mais completos e úteis combinam os três tipos de forma coesa.
Na prática, a distribuição de uso dos tipos de recursos no ecossistema MCP segue um padrão claro: ~80% dos servers expõem Tools, ~40% expõem Resources, e ~20% expõem Prompts. Servidores que combinam os três tipos tendem a ser os mais completos e bem avaliados pela comunidade — eles oferecem uma experiência integrada onde o modelo pode agir, consultar e seguir padrões, tudo dentro do mesmo servidor.
Próximo Módulo: 1.6 — Transportes de Comunicação