MCP, skills e tool use

Do zero

Um modelo de linguagem, sozinho, só produz texto. Ele não abre arquivos, não consulta o sistema de processos, não roda testes. Para agir, ele precisa de ferramentas. E aqui está o ponto central: o modelo não executa nada. Ele apenas pede, num formato estruturado (“chame a ferramenta consultar_processo com o número 123”), e a aplicação em volta dele executa e devolve o resultado. Isso é tool use (uso de ferramentas).

O problema é que cada aplicação de IA ligava cada ferramenta de um jeito próprio. O MCP (Model Context Protocol) é um padrão aberto para essa ligação, como uma tomada universal: um sistema expõe as suas ferramentas e dados num servidor MCP, e qualquer aplicação compatível (um agente de codificação, um chat, uma IDE) consegue usá-los sem integração sob medida.

Já as skills resolvem outro problema: o agente sabe programar, mas não conhece o jeito do Tribunal de fazer as coisas. Uma skill é uma pasta com um manual (SKILL.md) e, se preciso, scripts e modelos. O agente só lê o manual inteiro quando a tarefa pede, como um servidor que tira da estante o procedimento certo na hora de usar.

Frase para guardar: tool use é o modelo pedir e a aplicação executar; MCP padroniza como ligar ferramentas e dados; skill empacota o “como fazer”.

Em 1 minuto

• Tool use: a aplicação descreve as ferramentas (nome, descrição e parâmetros em JSON Schema); o modelo responde com uma chamada estruturada; a aplicação executa, devolve o resultado e o ciclo continua até a resposta final.
• MCP: protocolo aberto que usa mensagens JSON-RPC 2.0 entre host (a aplicação de IA), clientes (um para cada servidor, dentro do host) e servidores (que oferecem as capacidades).
• O que um servidor oferece: ferramentas (funções que o modelo aciona), recursos (dados e contexto, identificados por URI) e prompts (modelos de mensagem que o usuário escolhe).
• Transportes: stdio (o servidor roda como processo local) e Streamable HTTP (servidor remoto, com mensagens enviadas por POST a um endpoint único). A autorização é opcional; quando usada num transporte HTTP, deve seguir o OAuth 2.1, com o servidor MCP como servidor de recursos. No stdio, as credenciais vêm do ambiente.
• Skills: pasta com SKILL.md (metadados name e description obrigatórios, mais as instruções) e, opcionalmente, scripts, referências e modelos. Carregamento por revelação progressiva: primeiro só nome e descrição; o resto quando a tarefa pede.

Exemplo concreto: um agente que analisa processos

O Tribunal ligou um agente de IA ao seu sistema de processos.

Servidor MCP “processos”, rodando na rede interna e acessado por Streamable HTTP, com autorização OAuth:

O ciclo de uma pergunta (“qual a situação do processo 123/2026?”):

1. O host envia ao modelo a pergunta e a lista de ferramentas disponíveis.
2. O modelo responde com uma chamada: consultar_processo com {"numero": "123/2026"}.
3. O host confere a permissão, executa a chamada pelo cliente MCP e recebe o resultado do servidor.
4. O host devolve o resultado ao modelo, que redige a resposta ao usuário.

Skill “relatorio-de-auditoria”, numa pasta do projeto:

---
name: relatorio-de-auditoria
description: Redige achados de auditoria de TI no formato do Tribunal. Use quando o
  usuário pedir para escrever ou revisar um achado ou um relatório de auditoria.
---

1. Para cada achado, escreva: situação encontrada, critério, causa, efeito e proposta.
2. Cite a norma de cada critério pelo número e pelo artigo.
3. Use o modelo em assets/achado.md e confira com scripts/validar_achado.py.

No início da sessão, o agente conhece só o nome e a descrição da skill. Quando alguém pede “escreva o achado sobre o backup”, ele lê o SKILL.md inteiro e segue os passos.

Comparação: tool use, MCP e skills

As duas coisas se complementam: o MCP dá acesso a sistemas; a skill ensina o procedimento. Uma skill pode, inclusive, orientar o agente a usar ferramentas de um servidor MCP.

O que mudou na revisão 2026-07-28 do MCP

A especificação do MCP é versionada por data. Na revisão de 28/07/2026, a mais recente quando o edital saiu:

• O protocolo ficou sem estado: acabou o aperto de mão inicial (initialize); cada requisição leva a versão do protocolo e as capacidades do cliente.
• Os servidores passaram a implementar server/discover, que anuncia versões, capacidades e identidade.
• Roots, Sampling e Logging foram marcados como obsoletos (ainda funcionam, mas não devem ser adotados em implementações novas).
• As tarefas longas (Tasks) saíram do núcleo e viraram uma extensão oficial.
• O Streamable HTTP ficou sem sessão (acabou o cabeçalho Mcp-Session-Id) e sem o endpoint GET; as notificações de mudança usam subscriptions/listen, e os pedidos do servidor ao cliente (como elicitation) chegam como InputRequiredResult dentro da própria resposta.

A arquitetura (host, cliente e servidor), o JSON-RPC, as três capacidades do servidor e os dois transportes continuam existindo, e é isso que a prova mais tende a cobrar.

Segurança

A própria especificação do MCP lembra que ferramentas representam execução de código arbitrário:

• o usuário deve consentir e entender o acesso a dados e as ações;
• o host deve pedir consentimento explícito antes de acionar uma ferramenta, e deve haver sempre uma pessoa capaz de negar a chamada;
• descrições e anotações de ferramentas vindas de servidores não confiáveis não merecem confiança;
• cada servidor vê só o que precisa: o histórico completo da conversa fica com o host.

Como a FCC cobra

• O modelo executa a ferramenta? (Não: a aplicação executa.)
• Formato das mensagens (JSON-RPC 2.0) e transportes (stdio e Streamable HTTP).
• Diferença entre ferramenta, recurso e prompt.
• Estrutura de uma skill e revelação progressiva.
• Cuidados de segurança: consentimento, menor privilégio, pessoa no controle.

Pegadinhas

Explique com suas palavras

Explique a um gestor, sem jargão, o que é o MCP e o que é uma skill, e por que um não substitui o outro.

1. Escreva sem olhar a lição, com frases curtas e um exemplo seu.
2. Onde travar ou precisar de jargão, há uma lacuna: releia só essa parte.
3. Compare com a explicação-modelo e reescreva o que faltou.

Sua explicação

Fica salva neste navegador.

Comparar com uma explicação-modelo

O MCP é uma tomada padrão entre os assistentes de IA e os sistemas da organização. O Tribunal monta um “servidor” que oferece, por exemplo, a consulta de processos, e qualquer assistente compatível consegue usar essa consulta sem uma integração feita sob medida. O assistente pede a consulta, mas quem executa é o programa em volta dele, que pode exigir a aprovação de uma pessoa.

A skill é um manual guardado numa pasta: explica como fazer uma tarefa do jeito do Tribunal, como redigir um achado de auditoria. O assistente só lê o manual inteiro quando a tarefa pede. Um dá acesso aos sistemas; o outro ensina o procedimento. Por isso se completam.

Teste-se

Mais duas questões deste tópico estão em Questões.

Flashcards gerados

Ligação com o estudo de caso

Num caso sobre agentes de IA no desenvolvimento do Tribunal, proponha: servidores MCP com menor privilégio (só leitura onde bastar), autorização OAuth nos servidores remotos, aprovação humana para ações que alteram dados ou executam comandos, registro de todas as chamadas de ferramenta e skills com os procedimentos e as normas internas, revisadas como qualquer outro código.

Fontes da lição

• Especificação do Model Context Protocol, revisão 2026-07-28: visão geral, arquitetura, transportes, ferramentas, recursos, prompts, autorização e mudanças (fontes/mcp-spec-2026-07-28/mcp-spec-2026-07-28.md).
• Especificação Agent Skills: estrutura da pasta, campos do SKILL.md e revelação progressiva (fontes/agent-skills/agent-skills-spec.md).
• Edital nº 01/2026, Anexo II, Engenharia de Software Assistida por IA e Sistemas Agentivos (fontes/edital-01-2026.txt).