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
- naftiko.iofonte original
- Categoria
- CEVIU Web Dev
- Publicado
- 13 de novembro de 2026
- Editoria
- CEVIU Web Dev

