Nos artigos anteriores desta série, exploramos por que o desenvolvimento
baseado apenas em prompts
tem limitações estruturais e por que a Knowledge Base do GeneXus é a fonte de verdade ideal para os agentes de Inteligência Artificial. Mas como um agente de IA interage concretamente com a KB? Que mecanismo torna possível essa conversa entre o mundo dos LLMs e o mundo do GeneXus?

A resposta é o GeneXus MCP Server
.

Para entender por que isso importa, primeiro precisamos entender o que é o
GeneXus for Agents
e qual papel o MCP Server desempenha dentro deste produto da GeneXus.

Convido você a continuar lendo para revisar ou aprender esses conceitos.

O que é o GeneXus for Agents?

GeneXus for Agents
é a camada que permite aos agentes de IA trabalhar diretamente na Knowledge Base do GeneXus – o lugar onde todo o conhecimento do sistema está armazenado – com acesso ao contexto completo do sistema e com a validação do motor do GeneXus como garantia de consistência.

Em vez de gerar código a partir de prompts isolados, os agentes propõem mudanças na KB, o motor as valida e o GeneXus gera o código de forma determinista.

Tudo isso é possível graças ao GeneXus MCP Server
.

O que é o Model Context Protocol (MCP)?

Antes de aprofundar no GeneXus MCP Server, precisamos entender o que é o Model Context Protocol, ou MCP.

MCP é um padrão aberto projetado para resolver um problema concreto: como conectar agentes de IA com fontes de dados e ferramentas externas de forma padronizada.

Antes do MCP, cada ferramenta que queria se integrar com modelos de linguagem precisava desenvolver sua própria integração, com sua própria API, seu próprio formato de dados e sua própria lógica de autenticação. Para os desenvolvedores de agentes, isso significava ter que aprender e manter uma integração diferente para cada ferramenta que queriam usar.

O MCP define um protocolo comum: uma forma padrão para qualquer ferramenta expor suas capacidades e dados a qualquer agente de IA compatível. O resultado é um ecossistema onde as integrações são construídas uma vez e funcionam com qualquer agente que respeite o padrão.

Para os agentes de IA, o MCP é um padrão que permite conectar qualquer ferramenta com qualquer agente sem a necessidade de integrações personalizadas.

O que é o GeneXus MCP Server?

GeneXus MCP Server
é a implementação deste protocolo para a Knowledge Base do GeneXus. É o componente que expõe a KB ao mundo dos agentes de IA por meio de uma interface padrão, controlada e segura.

O GeneXus MCP Server permite que qualquer agente de IA compatível com MCP possa:

• Ler objetos da Knowledge Base: transações, procedimentos, objetos de dados, telas e regras.
• Consultar relações entre objetos: quais atributos uma transação possui, com quais outras transações ela se relaciona, quais regras se aplicam.
• Propor alterações em objetos existentes ou a criação de novos objetos.
• Acionar a compilação e a validação sobre as mudanças propostas.
• Receber feedback do motor do GeneXus sobre erros ou inconsistências detectadas.

Tudo isso ocorre por meio da interface MCP padrão, o que significa que o agente não precisa saber nada específico sobre o funcionamento interno do GeneXus para interagir com a KB. O GeneXus MCP Server traduz entre a linguagem do agente e a linguagem da KB.

O fluxo de uma interação típica

Para tornar isso mais concreto, vejamos como seria uma interação típica entre um agente de IA e a KB por meio do GeneXus MCP Server.

Suponha que um desenvolvedor peça ao agente: “Adicionar um módulo de gestão de fornecedores que inclua aprovação de faturas com níveis de autorização de acordo com o valor.”

Neste caso, o fluxo seria o seguinte:

1. O agente recebe a instrução e, antes de propor qualquer mudança, consulta o GeneXus MCP Server para entender o estado atual da KB: quais transações existem relacionadas a fornecedores ou faturas, quais atributos já estão definidos, quais padrões de aprovação existem em outros módulos.
2. Com esse contexto, o agente raciocina sobre como implementar o requisito de forma consistente com o sistema existente. Usa as
   GeneXus Skills
   para entender as convenções de nomenclatura, os padrões de design recomendados e a estrutura típica de módulos semelhantes.
3. O agente propõe as mudanças: novas transações, atributos, regras de negócio e lógica de aprovação. Essa proposta é enviada ao GeneXus MCP Server em formato de texto estruturado.
4. O GeneXus MCP Server recebe a proposta e a passa para o motor do GeneXus para validação. O motor verifica se os objetos propostos estão corretos, se as relações são válidas e se não há conflitos com objetos existentes.
5. Se a validação for bem-sucedida, as mudanças são integradas à KB.
6. Se houver erros, o GeneXus MCP Server retorna o feedback ao agente com detalhes sobre o que está errado, e o agente pode tentar corrigir a proposta.
7. Uma vez integradas as mudanças à KB, o GeneXus gera o código para a tecnologia de destino de forma determinista.

Por que a padronização importa: sem lock-in de LLM

Um dos benefícios mais importantes do GeneXus MCP Server é que, ao implementar um protocolo padrão, torna o GeneXus for Agents independente do modelo de linguagem usado pelo agente.

A integração com a KB funciona da mesma forma em todos os casos, porque o GeneXus MCP Server expõe uma interface padrão que nenhum desses modelos precisa entender em detalhe.

Isso tem implicações importantes para as equipes, permitindo que elas:

• Escolham o modelo de IA mais adequado para cada tarefa sem ficarem presas a um único fornecedor.
• Atualizem ou troquem de modelo à medida que a tecnologia evolui, sem modificar a integração com o GeneXus.
• Mantenham o controle do sistema na KB e no motor do GeneXus, não no fornecedor de IA.
• Combinem diferentes modelos no mesmo fluxo, se fizer sentido para o seu caso de uso.

A partir do IDE ou da CLI

O GeneXus MCP Server foi projetado para funcionar nos dois contextos em que as equipes de desenvolvimento modernas trabalham.

A partir do IDE do GeneXus, os desenvolvedores podem interagir com agentes de IA de forma visual, integrada ao ambiente que já conhecem. O agente tem acesso à KB por meio do MCP Server, propõe mudanças e o desenvolvedor pode revisá-las antes de serem integradas.

A partir da CLI (Command Line Interface ou Interface de Linha de Comandos), as equipes podem incorporar agentes de IA em pipelines de CI/CD, scripts de automação ou fluxos de trabalho que já utilizam ferramentas de linha de comandos. Isso é fundamental para equipes que trabalham com branching, pull requests e revisões de código, pois permite que o agente faça parte do fluxo de desenvolvimento sem necessidade de intervenção manual em cada etapa.

Ambos os modos de trabalho são compatíveis com Git e com os fluxos modernos de colaboração em equipe. As mudanças que o agente propõe podem passar por revisão de código como qualquer outra mudança, mantendo o controle humano sobre o que entra no sistema.

O GeneXus MCP Server no ecossistema mais amplo

O GeneXus MCP Server não opera de forma isolada. Faz parte de um conjunto de componentes que juntos tornam o GeneXus for Agents possível:

• As GeneXus Skills
  fornecem ao agente o contexto especializado sobre como trabalhar com o GeneXus: convenções, padrões e melhores práticas.
• A representação textual da KB
  permite que qualquer LLM leia e raciocine sobre os objetos da KB.
• O motor do GeneXus
  atua como validador final: nada chega à KB sem passar pela sua validação.

O GeneXus MCP Server é a cola que une essas peças. É a camada que torna possível que um agente externo, usando qualquer LLM, participe do ciclo de desenvolvimento de um sistema GeneXus com a mesma confiabilidade e controle que um desenvolvedor teria ao fazê-lo a partir do IDE.

Você também pode estar interessado em ler:

O problema do desenvolvimento baseado em prompts

GeneXus for Agents: Desenvolvimento com GenAI Sem Perder o Controle

GeneXus na era do desenvolvimento agêntico