MCP, ou Model Context Protocol, organiza como um assistente descobre e utiliza capacidades expostas por um servidor. A API de negócio continua sendo o contrato do sistema que consulta um pedido, registra uma tarefa ou atualiza um cadastro. Em muitas integrações, o servidor MCP chama essa API por trás.
A distinção importa porque conectar uma ferramenta ao modelo não resolve automaticamente identidade, autorização, limites de dados ou confirmação de escrita. O protocolo facilita a interface com o assistente. A implementação precisa preservar as regras do sistema de origem e fornecer ao usuário informação suficiente para compreender o efeito de uma ação.
Quem faz o quê em uma integração
Considere um assistente que consulta pedidos de compra. A aplicação hospedeira conduz a interação com o usuário. Um cliente MCP conversa com o servidor. O servidor expõe uma ferramenta, valida a entrada e usa a credencial adequada para consultar o sistema empresarial. A API desse sistema retorna dados conforme suas permissões.
A especificação de ferramentas do MCP descreve descoberta, esquemas de entrada e chamadas de ferramentas. Esses recursos fornecem um contrato de interação. A regra sobre quais pedidos uma pessoa pode consultar continua dependendo da identidade e das verificações aplicadas na integração.
| Componente | Responsabilidade | Erro de interpretação |
|---|---|---|
| Assistente | Interpretar pedido e apresentar resultado | Tratar intenção inferida como autorização |
| Ferramenta MCP | Expor capacidade com entrada definida | Oferecer comando genérico sem limites de negócio |
| Servidor MCP | Validar, autorizar e executar a integração | Confiar em identificador de empresa enviado pelo modelo |
| API de negócio | Aplicar contrato e efeitos do sistema | Supor que acesso técnico concede toda permissão comercial |
Escolha capacidades compreensíveis
Uma ferramenta chamada consultar_pedido, com identificador de pedido e campos de saída definidos, facilita entender o que será feito. Uma ferramenta que recebe qualquer URL, qualquer método HTTP e qualquer corpo transfere muita decisão para o modelo e dificulta verificar o escopo. Flexibilidade pode ser necessária em ferramentas de administração; nesse caso, o acesso precisa corresponder a essa função.
Descrições ajudam o modelo a selecionar a ferramenta, mas não são controles de acesso. A validação deve existir no servidor. Parâmetros precisam ser verificados quanto a tipo, tamanho e semântica. Um identificador bem formado ainda pode apontar para recurso de outra organização. Confirmar posse ou autorização exige consultar a fonte que controla o recurso.
Uma consulta e uma escrita exigem percursos diferentes
- Usuário pede o estado do pedido 427.
- Ferramenta identifica usuário e verifica acesso ao pedido.
- API retorna estado, versão e dados necessários.
- Usuário pede alteração de centro de custo.
- Aplicação apresenta pedido, campo, valor atual e novo valor.
- Após autorização, servidor revalida acesso e versão e executa a alteração.
- Aplicação consulta ou interpreta o resultado confirmado e informa o novo estado.
O número 427 é fictício. O exemplo mostra uma distinção essencial: ler o estado não autoriza alterá-lo. Se outra pessoa muda o pedido enquanto a confirmação está aberta, a integração precisa identificar o conflito. Uma versão ou outro mecanismo de concorrência permite evitar que a alteração use uma condição já ultrapassada.
A confirmação deve estar vinculada à ação concreta. “Autorizar acesso ao sistema” não informa qual campo mudará em qual pedido. Também não basta colocar uma recomendação de confirmação na descrição da ferramenta. A aplicação e o servidor precisam aplicar a decisão de autorização onde a escrita acontece.
Autenticação do transporte e permissão de negócio
MCP admite cenários locais e remotos. Para o transporte HTTP, a especificação de autorização define o fluxo aplicável quando implementado. O uso de credenciais no sistema empresarial deve ser desenhado separadamente, mantendo destinatário, escopo e identidade corretos.
Um token aceito pelo servidor MCP não deve ser tratado como autorização universal para APIs de terceiros. As práticas de segurança do protocolo proíbem o repasse indiscriminado de tokens e discutem fronteiras de confiança. Na arquitetura concreta, registre qual credencial é usada em cada lado e como o usuário se relaciona com a ação final.
Dados retornados podem conter instruções indevidas
Um campo de observação em um pedido pode conter texto que parece uma ordem para o assistente. Esse texto é conteúdo do sistema, não instrução autorizada da aplicação. A integração precisa impedir que dados consultados alterem ferramentas disponíveis, destino de exportação ou permissão de escrita.
Teste esse caso com dados sintéticos: uma observação pede para exportar todos os pedidos para um endereço externo. O resultado esperado é tratar a observação como dado, preservar a consulta original e não executar a exportação. O servidor deve recusar ações fora do escopo mesmo se o modelo tentar chamá-las.
Timeout não prova que a escrita falhou
Uma atualização pode ser aceita pela API e ter sua resposta perdida. Repetir a chamada sem consultar o estado pode duplicar um efeito. Para operações que alteram dados, defina como reconhecer repetição, reconciliar resultado desconhecido e registrar o identificador da operação. Uma mensagem de erro da rede descreve comunicação; não demonstra o estado final do pedido.
Consultas costumam admitir repetição com menor risco, mas também podem consumir cota ou devolver estado diferente. Defina limites, timeout e mensagens específicas. Mostre indisponibilidade técnica quando ela ocorreu, em vez de gerar uma resposta plausível para preencher o espaço.
Quando MCP agrega valor
MCP pode ser útil quando a mesma capacidade deve ser acessada por aplicações compatíveis, com descoberta e contrato padronizados. Uma integração direta pode ser suficiente quando existe um consumidor e um fluxo fixo. Compare compatibilidade, manutenção, autenticação e observabilidade, sem assumir que o protocolo torna a operação mais segura por si.
Para liberar uma ferramenta, verifique leitura autorizada, tentativa em recurso sem acesso, entrada inválida, escrita confirmada, alteração concorrente e resultado desconhecido. A integração está pronta para avaliação quando esses comportamentos são explícitos. O modelo pode conduzir a conversa; a regra de negócio continua protegida por código e pelo sistema que registra o efeito.
Continue a leitura
- model context protocol