Objetivo: ao final, o consultor distingue os três primitivos do MCP, sabe como referenciar cada um numa sessão, e entende por que adicionar servidor hoje custa pouco contexto.
@servidor:caminho. Prompts são instruções prontas que você invoca como slash command.@ junto dos arquivos, com busca aproximada, e são anexados automaticamente quando referenciados. Prompts aparecem no /, com namespace do servidor.| Primitivo | Quem usa | O que é | Como se aciona |
|---|---|---|---|
| Tool | O modelo decide chamar | Ação executável | O Claude chama sozinho, quando a tarefa pede |
| Resource | Você referencia | Dado que o servidor compartilha | @servidor:caminho no prompt |
| Prompt | Você invoca | Instrução pronta que o servidor oferece | /servidor:nome, como slash command |
A pergunta que resolve qualquer dúvida de classificação: quem aciona, e isso executa algo? Se o modelo aciona e executa, é tool. Se você aciona e é dado, é resource. Se você aciona e é instrução, é prompt.
Qual o status dos itens em @catalogo:ricefw://fase-2 ?
Compare @catalogo:ricefw://fase-2 com @drive:file://plano-projeto.xlsx
Digite @ para ver os recursos disponíveis de todos os servidores conectados — eles aparecem junto dos arquivos no autocomplete, com busca aproximada no caminho. O conteúdo é buscado e anexado automaticamente, e pode ser texto, JSON ou dado estruturado.
Antes, conectar um servidor MCP significava carregar a definição de todas as ferramentas dele no contexto, sempre. Cinco servidores com dez ferramentas cada custavam caro antes de você digitar qualquer coisa.
Hoje, com tool search ligado por padrão:
| Carrega no início da sessão | Carrega sob demanda | |
|---|---|---|
| Nomes das ferramentas | ✅ | — |
| Instruções do servidor | ✅ | — |
| Definição completa da ferramenta | — | ✅ quando o Claude precisa |
O que isso muda para a Wayon: o custo de contexto deixa de ser argumento contra ter vários servidores da Faixa 1 disponíveis. O que continua custando contexto é o resultado das chamadas — a aula 2.2.1 segue certa nessa parte.
Para quem constrói servidor (aula 3.1.6), há uma consequência: as instruções do servidor ficam mais importantes, porque são elas que ajudam o Claude a decidir buscar suas ferramentas. Elas são truncadas em 2KB — seja conciso e ponha o essencial no começo.
📖 Usar resources de MCP · Contexto é o recurso escasso — módulo 2.2
buscar_ricefw, que consulta e devolve o status de um item. O Claude decide chamar isso sozinho quando a tarefa pede. Que primitivo é?Correto — é o modelo que aciona, e executa ação.
Resource é dado que você referencia com @, não algo que o modelo chama para executar.
Prompt é instrução pronta que você invoca como slash command.
@ no prompt e vê, junto dos arquivos, uma entrada catalogo:ricefw://fase-2. Que primitivo é?Tool não aparece no autocomplete do @; ela é chamada pelo modelo, não referenciada por você.
Prompt aparece no /, não no @.
Correto. Resources aparecem no autocomplete do @, junto dos arquivos, com busca aproximada.
/. Que primitivo é?O que aparece no / e é invocado por você não é tool — tool é acionada pelo modelo.
Correto. Prompts do servidor aparecem como slash command, com namespace do servidor.
Resource é dado referenciado com @; aqui se trata de instrução invocada com /.
Correto — modelo aciona e executa: tool. Você aciona e é dado: resource. Você aciona e é instrução: prompt.
Resource pode ser texto, JSON ou dado estruturado; o formato não distingue os primitivos.
Transporte não tem relação com qual primitivo está sendo exposto.
Era verdade antes; hoje as definições são diferidas por padrão.
Não existe esse limite numérico, e a premissa de custo por servidor conectado é a que está desatualizada.
Correto.
A descrição de cada ferramenta continua existindo e importando; as instruções do servidor são outra camada.
Correto. Seja conciso e ponha o essencial no começo.
/mcp como documentação do servidorO /mcp mostra servidores e contagem de ferramentas; o papel das instruções é orientar a busca de ferramentas pelo modelo.