Segurança e solução de problemas do MCP

O MCP pode falhar na rede, autenticação, descoberta ou execução. Separe essas etapas para evitar alterações aleatórias.

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”.

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.

Erros precisam de caminhos explícitos

Um tempo limite é diferente de um erro de permissão. Tente novamente apenas erros transitórios, com tentativas limitadas e atrasos crescentes. Uma operação com efeitos colaterais pode ser executada antes que sua resposta seja perdida; tentar novamente sem uma chave de idempotência pode duplicar o efeito. O streaming mostra o progresso, mas não garante a conclusão. Os pontos de verificação podem permitir que estágios com falha sejam retomados dentro dos limites de tempo de execução. Armazene o identificador de execução, estágio, duração e erro enquanto remove segredos dos logs. Meça caminhos lentos, bem como médias.

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

Uma chave errada dá acesso negado. Um endpoint errado pode retornar uma página HTML. O tempo limite da ferramenta não prova um problema de esquema de descoberta.

Experimente você mesmo

1. Teste chave errada, endpoint errado e argumentos inválidos usando dados de demonstração.
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

Classifique o erro e corrija a configuração sem copiar segredos em logs ou capturas de tela. 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

Um servidor conectado ainda pode ter uma ferramenta indisponível. 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.

Por que remover uma fonte privada depois de responder tarde demais?

Os dados já entraram no contexto do modelo e podem ser divulgados.

Que resultado este exercício deve produzir?

Classifique o erro e corrija a configuração sem copiar segredos em logs ou capturas de tela.

Termos para lembrar

• Servidor MCP: um serviço que expõe recursos por meio do Model Context Protocol.
• Autorizar / Autorização: Verificando o direito de acesso a uma operação ou recurso.
• Idempotência: Repetição controlada sem duplicar um efeito.

Fontes e sua próxima etapa

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

Para preparar: M02 — Conectando um servidor MCP na aplicação