🧩 MCP e interoperabilidade
Este modulo coloca MCP em terreno concreto: arquitetura, capabilities, server simples e inspector para debug de integracao.
🧭 Arquitetura MCP
MCP organiza integracoes em uma forma composavel: cliente, servidor e capacidades publicadas.
Conceito principal
O protocolo separa quem consome de quem expoe ferramentas e contexto.
Dica pratica
Comece com uma capacidade minima antes de querer expor um servidor completo.
📚 Resources, prompts e tools
Cada capacidade tem uma funcao diferente: recurso para contexto, prompt para template e tool para acao.
Escolha boa
Transformar em resource o que precisa ser lido e em tool o que gera efeito.
Escolha ruim
Expor tudo como tool e perder semantica da integracao.
🤝 Capability negotiation
Cliente e servidor precisam declarar o que suportam para evitar integracao parcial ou comportamento inesperado.
Criterio tecnico
Negotiation bem feita reduz acoplamento escondido e ajuda a debugar incompatibilidades logo no inicio.
Falha comum
Assumir capacidade disponivel sem checar o handshake ou lista de exposicao.
🛠️ MCP server simples
O aluno construi uma capacidade minima para entender na pratica registro, chamada e contrato de exposicao.
Conceito principal
Server simples bem feito ensina mais que um servidor grande sem criterio.
Alerta
Nao tente modelar todas as capacidades de uma vez; comece por uma util e testavel.
🔍 Inspector e debug
Inspecao e parte do fluxo de engenharia: verificar o que esta exposto, como responde e onde a integracao quebra.
Inspecionar
Capabilities, payloads, erros de invocacao e resultados retornados.
Nao fazer
Assumir que o servidor expoe corretamente so porque “subiu sem erro”.
🧪 Laboratorio MCP
Fechamento do modulo com uma exposicao minima via MCP e validacao por inspector ou cliente simples.
Exercicio
Publicar um resource ou tool e validar a descoberta e a invocacao.
Entregavel
Servidor ou cliente MCP simples, funcional e inspecionado.
✅ Resumo final
✓ Entendeu cliente, servidor e capacidades MCP.
✓ Aprendeu a diferenciar resources, prompts e tools.
✓ Viu o valor da negotiation entre capacidades.
✓ Construiu uma exposicao minima e a inspecionou.
✓ Ganhou base concreta para interoperabilidade futura.