Conectando um servidor MCP no aplicativo

Uma conexão bem-sucedida precisa de endpoint, transporte e autenticação compatíveis. Em seguida, selecione ferramentas úteis para o agente.

Estas etapas referem-se aos recursos identificados no código do aplicativo. Este material não foi validado em uma instância ativa; verifique a documentação e as opções da sua versão.

Como funciona, passo a passo

Host, cliente e servidor

MCP é um protocolo que conecta aplicativos de IA a recursos externos. O host fornece a experiência, o cliente gerencia a conexão e o servidor expõe ferramentas, recursos ou prompts de acordo com o suporte. As ferramentas executam operações; os recursos fornecem conteúdo endereçável; prompts fornecem modelos. Nem todo servidor implementa todos os três. O transporte transporta mensagens, a autenticação identifica os chamadores e a autorização controla o acesso. Verifique a revisão do protocolo e as extensões suportadas em ambas as extremidades. A compatibilidade não pode ser inferida apenas a partir de um rótulo “MCP”.

O modelo propõe, a ferramenta executa

A chamada da ferramenta produz uma solicitação de chamada com nome e argumentos. A aplicação valida o esquema, as permissões e os limites antes da execução. O resultado retorna ao contexto para a próxima etapa. Por exemplo, get_product_stock pega um SKU e retorna uma quantidade; sua descrição deverá explicar que não reserva produtos. Distinguir resultados vazios, erros de validação, falta de acesso e tempos limite. JSON válido não prova que os argumentos estão corretos ou que a ação está autorizada. Para efeitos externos, considere também a execução duplicada.

Verifique o acesso antes de usar

As permissões devem ser aplicadas pelos servidores e pela camada de dados. Não deixe o modelo decidir se um usuário pode ver um documento. Filtre as fontes antes que elas entrem no contexto, não depois de gerar a resposta. Use credenciais de acesso mínimo, mantenha-as fora de prompts, capturas de tela e códigos do navegador e alterne as chaves expostas. Uma lista de permissões de domínio de widget não substitui a autenticação de API. A autenticação identifica você; a autorização determina as operações e os dados que você pode usar. Teste o acesso negado também.

O esquema explicativo

Siga as setas sólidas para o fluxo principal. As setas azuis tracejadas fornecem dados ou contexto; setas rosa tracejadas mostram feedback ou retorno de resultados. Cores e formas distinguem modelos, lojas, decisões e resultados. Em telas pequenas, role na horizontal para acompanhar o esquema completo.

Um exemplo completo

Em Servidores MCP configurem identidade e URL, escolha AUTO ou transporte e autenticação do servidor. Teste, inspecione ferramentas e anexe apenas get_product_stock ao agente.

Experimente você mesmo

1. Conecte um servidor de teste somente leitura e verifique uma chamada de SKU válida.
2. Registre a entrada, a fonte e o resultado esperado antes de executar o experimento. Use apenas os dados fictícios do exemplo.
3. Siga as etapas do diagrama. A cada passo registre quais informações são recebidas e produzidas; não confunda o resultado intermediário com o resultado final.
4. Repita após remover as informações necessárias ou tornar a entrada ambígua. Verifique se o sistema esclarece, interrompe ou inventa uma resposta.
5. Compare com a solução explicada. Guarde a configuração, data, resultado e explicação das diferenças. Mude uma coisa e teste novamente.

Uma solução explicada

A conexão é verificada, a ferramenta é descoberta e uma chamada permitida é bem-sucedida. Um exercício bem-sucedido permite mostrar a conexão entre entradas, etapas e resultados. Quando falta informação, uma resposta cautelosa é mais útil do que detalhes inventados. Compare mais do que estilo: verifique também as condições, fontes e operações.

Quando esta abordagem ajuda e quais são seus limites

stdio é um conceito geral, não uma opção implícita de formato remoto. Escolha esta abordagem quando ela melhorar uma necessidade medida. Mantenha uma linha de base simples e compare os resultados usando dados idênticos. Um exemplo de sucesso não estabelece confiabilidade em todas as situações.

Verifique o que aprendeu

Um servidor com ferramentas oferece recursos e prompts automaticamente?

Não. Os recursos são opcionais e devem ser descobertos e verificados.

Quem executa uma chamada proposta pelo modelo?

O aplicativo ou serviço de host após a validação. O modelo não obtém automaticamente acesso irrestrito.

Que resultado este exercício deve produzir?

A conexão é verificada, a ferramenta é descoberta e uma chamada permitida é bem-sucedida.

Termos para lembrar

• Servidor MCP: um serviço que expõe recursos por meio do Model Context Protocol.
• Chamada de ferramenta: uma solicitação estruturada para usar um recurso externo.
• Autorizar / Autorização: Verificando o direito de acesso a uma operação ou recurso.

Fontes e sua próxima etapa

• Model Context Protocol — Specification
• LangGraph — Fluxos de trabalho e agentes
• OWASP — Injeção de prompt

Para preparar: M01 — O que é um servidor MCP?