** ¿Hablás español?** → Guía de inicio en español Fala português? ** Guia de início em português ** Застрял? ** Руководство по устранению неполадок ** Все документы Индекс документации

GeneXus MCP Server позволяет агентам ИИ — Claude Desktop, Claude Code, Cursor, Antigravity и любому MCP-совместимому клиенту — читать, редактировать, анализировать и рефакторировать объекты внутри базы знаний, поддерживаемой выбранным нативным драйвером совместимости SDK или устаревшим драйвером совместимости. Нативные пути SDK работают с real GeneXus SDK, а устаревшие пути используют явные адаптеры отражения / COM; ни один путь не опирается на разобранную копию KB.

На практике: вы указываете MCP в своем KB, затем просите своего помощника по ИИ такие вещи, как * «перечислить все транзакции с атрибутом CustomerId» *, * «добавить правило к транзакции Заказа, которое подтверждает общую сумму» * или * «отредактировать эту процедуру для использования нового SDT» — и он делает это.

Поддержка нескольких версий GeneXus

Тот же дистрибутив MCP поддерживает официальные местные майоры SDK. Сгенерированный документ совместимости. Он также включает в себя основные, лучшие усилия. совместимость с устаревшими версиями, перечисленными там, через отдельные драйверы; Этот путь не эквивалентен полной поддержке SDK.

GeneXus MCP Server — Multi-version GeneXus for Claude, Cursor, and AI Agents

¿Hablás español? → Guía de inicio en español Fala português? → Guia de início em português Stuck? → Troubleshooting guide All docs → Documentation index

---

GeneXus MCP Server lets AI agents — Claude Desktop, Claude Code, Cursor, Antigravity, and any MCP-compatible client — read, edit, analyze, and refactor objects inside a Knowledge Base supported by the selected native SDK or legacy compatibility driver. Native SDK paths work with the real GeneXus SDK and legacy paths use explicit reflection/COM adapters; neither path relies on a parsed copy of the KB.

In practice: you point the MCP at your KB, then ask your AI assistant things like “list all transactions with attribute CustomerId”, “add a rule to the Order transaction that validates the total”, or “refactor this procedure to use the new SDT” — and it does it.

---

Multi-version GeneXus support

The same MCP distribution supports the official native SDK majors listed in the generated compatibility document. It also includes basic, best-effort compatibility for the legacy versions listed there through separate drivers; that path is not equivalent to full native-SDK support. A process can route each declared KB to its own SDK/driver; --gx remains the convenient global default for a single-major configuration. The commands below are examples of switching the existing configuration:

npx genexus-mcp@latest init --kb "C:\KBs\KBTeste17" --gx "C:\Program Files (x86)\GeneXus\GeneXus17Trial"
# To switch this MCP configuration to GX18:
npx genexus-mcp@latest init --kb "C:\KBs\MyGX18KB" --gx "C:\Program Files (x86)\GeneXus\GeneXus18"

After switching the SDK or KB, fully restart the AI client so it reloads the MCP process and its tool schemas. If GX17 and GX18 must run simultaneously, use separate MCP configurations and ports.

Classic GX8/GX9 KBs can be opened without changing the global GX18 default by declaring their driver and installation per KB (the Gateway accepts both the list and object catalog shapes):

{
  "Environment": {
    "KBs": {
      "SECT80": {
        "Path": "D:\\GX80\\SECT",