Voltar
Coloque o MCP ao lado da sua API, não por cima dela

Coloque o MCP ao lado da sua API, não por cima dela

Aprofundamento CEVIU

Aprofundamento

O texto da naftiko.io parte de um padrão comum: pegar o servidor de API que já existe, colocar um servidor MCP na frente e mapear cada tool para um endpoint. Entrega rápido, mas cria duas camadas para operar, dois contratos para manter alinhados (a descrição OpenAPI e as descrições de tool que a parafraseiam) e um salto de rede extra em cada chamada do agente. O caminho vira agente, servidor MCP, servidor de API, sistemas upstream.

A alternativa é a capability do Ikanos, que declara o que consome (as APIs upstream), os fluxos que agregam essas chamadas e o que expõe. REST e MCP são dois adapters na mesma lista exposes, ambos apontando para o mesmo fluxo via ref. Chamadas, credenciais, mapeamentos e lógica de etapas são escritos uma vez. A migração é incremental: o recurso ainda não migrado passa por um forward que repassa a requisição à API existente, o migrado vira operação sobre um fluxo, e o mesmo fluxo vira tool MCP com um ref. O texto separa o que existe hoje do que está em revisão: elicitation (uma etapa elicit pausa o fluxo e pergunta ao usuário via MCP) e tasks duráveis (fluxo com mode: task que sobrevive a reinício). Em REST, esse mesmo fluxo responde 501 Not Implemented e indica a etapa que precisava de entrada.

Por que isso importa

Para quem opera uma API e pensa em abrir uma interface para agentes, a leitura é que o wrapper MCP é o caminho mais curto, mas fixa o teto do protocolo novo no que o REST já faz. Se você espera precisar de perguntas no meio da chamada ou de tarefas longas, vale avaliar a lógica de negócio em um só lugar desde o início. É a tese do autor, que também vende a ferramenta, e parte dos recursos citados ainda está em revisão.

Perguntas frequentes

Qual o problema de colocar um servidor MCP na frente de uma API existente?

Segundo o artigo, você passa a ter duas camadas para operar, dois contratos para manter alinhados e um salto HTTP extra em cada chamada de agente. Além disso, o servidor MCP só consegue oferecer o que a API de baixo já oferece.

O que significa expor REST e MCP lado a lado?

Na capability do Ikanos, REST e MCP são adapters na mesma lista exposes e referenciam o mesmo fluxo com ref. A lógica e as credenciais ficam em um lugar só, e a chamada do agente vai direto ao fluxo, sem passar pelo REST.

Como migrar uma API legada de forma incremental?

Coloque a capability onde está o servidor atual. Recursos não migrados seguem por um forward que repassa a requisição sem mudança. Ao migrar, o recurso vira operação sobre um fluxo e, quando estiver pronto para agentes, ganha uma tool MCP com um ref.

Elicitation e tasks já funcionam no Ikanos?

Segundo o artigo, o suporte aos dois está em revisão. A ideia é que uma etapa elicit pause o fluxo e pergunte via MCP, e que um fluxo com mode: task rode como tarefa durável. Em REST, o mesmo fluxo devolve 501 Not Implemented.

Fontes

Avalie este artigo:
Categoria
CEVIU Web Dev
Publicado
13 de novembro de 2026
Editoria
CEVIU Web Dev

Quer receber mais sobre CEVIU Web Dev?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser