Servidor MCP para
Enterprise Architect

Requisitos del sistema

• Microsoft Windows 11 y Windows 10. Linux y macOS no son compatibles.
• Todas las versiones de Enterprise Architect, excepto la versión 17.2. Se admiten las ediciones de 64 y 32 bits. Las pruebas se realizaron con Enterprise Architect 17.1, compilación 1716 (x64/x86).
• Cualquier edición de Enterprise Architect, excepto EA Lite (Viewer).
• Un cliente MCP compatible con el método STDIO. Se probó con Claude para Windows, Visual Studio Code (GitHub Copilot Chat) y Antigravity CLI.
• Microsoft .NET Desktop Runtime 10.0.x. Se recomienda instalar la versión más reciente.

Se recibieron informes de usuarios que indican que los siguientes entornos funcionan, aunque no fueron probados por Sparx Systems Japan:

• Codex.
• OpenCode.

Conectarse a un cliente MCP

Primero, establece una conexión con el cliente MCP. Esta guía utiliza la aplicación de escritorio Claude para Windows y describe los pasos iniciales para comprobar que funciona correctamente.

1. Confirma que Enterprise Architect funciona correctamente.
2. Instala .NET Desktop Runtime 10.0.0 o una versión posterior, si aún no está instalado.
3. Instala el servidor MCP para Enterprise Architect. El instalador está disponible en la sección Descargar instalador. Los archivos del complemento se instalan en el directorio de instalación de Enterprise Architect.
4. Inicia Claude y selecciona el menú de la esquina superior izquierda. Selecciona Archivo > Configuración….
   
5. Selecciona el grupo Desarrollador y pulsa Editar configuración. Abre el archivo claude_desktop_config.json con un editor de texto.
6. Agrega la información del servidor MCP. Más abajo se incluye un ejemplo de configuración.
7. Reinicia Claude y comprueba si aparecen errores relacionados con el servidor MCP. Con la configuración inicial, Claude puede seguir ejecutándose después de cerrar la ventana; detén el proceso o cierra la sesión de Windows.
8. Confirma que aparecen las herramientas relacionadas con el servidor MCP.
   
9. Inicia Enterprise Architect, abre un proyecto y luego un diagrama.
10. En Claude, por ejemplo, solicita un resumen del diagrama actual. La primera vez que se ejecute cada herramienta, Claude mostrará cuadros de confirmación para conectarse al servidor MCP; permite las conexiones.
11. En Enterprise Architect podrás consultar información relacionada con el diagrama actual.

Sparx Systems Japan no puede brindar soporte para problemas de configuración, salvo los que estén estrictamente relacionados con su servidor y complemento MCP.

Ejemplo de claude_desktop_config.json (Claude para Windows)

Si no tienes otros servidores MCP, copia el siguiente contenido en el archivo. Si ya tienes otros servidores, agrega únicamente la sección «Enterprise Architect». Ajusta la ruta si Enterprise Architect está instalado en una ubicación diferente a la predeterminada.

Ejemplo para la versión de 64 bits:

{
  "globalShortcut": "",
  "mcpServers": {
    "Enterprise Architect": {
      "command": "C:\\Program Files\\Sparx Systems\\EA\\MCP_Server\\MCP3.exe",
      "args": [""]
    }
  }
}

Ejemplo para la versión de 32 bits:

{
  "globalShortcut": "",
  "mcpServers": {
    "Enterprise Architect": {
      "command": "C:\\Program Files (x86)\\Sparx Systems\\EA\\MCP_Server\\MCP3.exe",
      "args": [""]
    }
  }
}

Ejemplo de mcp.json (Visual Studio Code)

La información del servidor MCP se guarda en el archivo mcp.json, dentro de la carpeta %APPDATA%\Code\User. Si no tienes otros servidores MCP, crea el archivo y copia el ejemplo. Si ya los tienes, agrega únicamente la sección «Enterprise Architect». Ajusta la ruta si la instalación de Enterprise Architect no está en la ubicación predeterminada. Cuando la conexión se establezca, podrás consultar «Enterprise Architect» mediante el comando de VS Code MCP: List Servers.

La extensión GitHub Copilot Chat se utiliza habitualmente para conversar con servidores MCP desde VS Code. El complemento MCP de Enterprise Architect no tiene una función específica para otras configuraciones que utilicen LLM.

Ejemplo para la versión de 64 bits:

{
  "servers": {
    "Enterprise Architect": {
      "command": "C:\\Program Files\\Sparx Systems\\EA\\MCP_Server\\MCP3.exe",
      "args": [""]
    }
  }
}

Ejemplo de mcp_config.json (Antigravity CLI)

La información del servidor MCP se guarda en el archivo mcp_config.json, dentro de la carpeta .gemini del perfil de usuario (por ejemplo, C:\Users\TuUsuario\.gemini\config). Si no tienes otros servidores MCP, crea el archivo y copia el ejemplo. Si ya los tienes, agrega únicamente la sección «Enterprise Architect». Ajusta la ruta si es necesario. Cuando la conexión se establezca, podrás consultar «Enterprise Architect» mediante el comando de Antigravity CLI /mcp list.

Ejemplo para la versión de 64 bits:

{
  "mcpServers": {
    "enterprise-architect": {
      "command": "C:\\Program Files\\Sparx Systems\\EA\\MCP_Server\\MCP3.exe",
      "args": [""]
    }
  }
}

Diferencias entre las funciones de IA de Enterprise Architect

Enterprise Architect ofrece actualmente distintas funciones relacionadas con IA, entre ellas el chat de IA integrado y el producto externo Kernaro. La siguiente tabla resume las diferencias principales entre esas opciones y el complemento de servidor MCP.

Características del servidor MCP

El servidor MCP ofrece las siguientes herramientas. No es necesario especificar cuáles se utilizan: el LLM selecciona automáticamente las herramientas adecuadas.

Algunas herramientas son interactivas con Enterprise Architect. Permiten abrir diagramas, seleccionar elementos en diagramas y seleccionar elementos en la ventana del navegador desde el cliente MCP.

• Diagramas:
  • get_current_diagram
  • get_diagrams_information
  • get_opened_diagrams
  • open_diagrams — abre un diagrama en Enterprise Architect.
  • get_diagram_image
  • reload_diagrams
• Elementos:
  • get_elements_information
  • select_element_in_browser
  • select_element_in_diagram
  • find_element_in_diagrams — busca todos los diagramas en los que se utiliza el elemento indicado.
  • find_elements_by_name — admite coincidencia exacta o búsqueda de texto incluido en los nombres.
  • export_element_linked_documents
• Conectores:
  • get_connectors_information
• Paquetes:
  • get_packages_information
  • get_root_packages
  • find_packages_by_name
• Selección:
  • get_current_selected — obtiene los elementos seleccionados en el diagrama activo, el navegador u otras ubicaciones.

Funciones de creación y modificación

Las siguientes herramientas para crear y modificar modelos están deshabilitadas de forma predeterminada. Para habilitarlas, hay que especificar argumentos al ejecutar MCP3.exe. Consulta la sección Argumentos de inicio.

• Diagramas: create_or_update_diagram, place_elements_on_diagram, remove_elements_from_diagram, layout_connectors, change_connector_visibility.
• Elementos: create_or_update_elements, create_or_update_operations, create_or_update_attributes, clone_elements, import_element_linked_documents.
• Conectores: create_or_update_connectors, create_or_update_messages.
• Paquetes: create_or_update_package, clone_package, create_baseline, apply_baseline.

Funciones de eliminación

Las siguientes herramientas para eliminar elementos están deshabilitadas de forma predeterminada. Para habilitarlas, hay que especificar argumentos al ejecutar MCP3.exe. Consulta la sección Argumentos de inicio.

• delete_from_model
• delete_taggedvalue_from_model

Información adicional y notas sobre el servidor MCP

Archivos de registro

Los archivos de registro son útiles para resolver problemas. Si consideras que un problema está relacionado con el servidor MCP para Enterprise Architect, envía los siguientes archivos:

• El complemento MCP registra errores en %APPDATA%\Sparx Systems\EA\MCP_EA.log y MCP_EA_Errors.log.
• La aplicación Claude genera el registro %APPDATA%\Claude\logs\mcp-server-Enterprise Architect.log.
• En VS Code, los registros de comunicación con el servidor MCP aparecen en la ventana Output siguiendo este método.
• Si utilizas otros clientes MCP, envía también los archivos de registro relacionados con el servidor MCP, si están disponibles.

El archivo mcp-server-Enterprise Architect.log registra todas las solicitudes enviadas al servidor MCP y las respuestas recibidas; por lo tanto, puede contener información confidencial de los modelos. Para evitar enviar información confidencial innecesaria, elimina el archivo antes de reproducir el problema y envía el registro que contenga únicamente la información pertinente.

Argumentos de inicio

Los argumentos para ejecutar MCP3.exe son:

-enableEdit

Habilita las funciones de edición. Se recomienda hacer una copia de seguridad del proyecto de destino antes de utilizar funciones de creación o edición.

-enableDelete

Habilita las funciones de eliminación. La IA no siempre actúa según la intención humana. Durante las pruebas, al solicitar la eliminación de valores etiquetados de un paquete, en una ocasión se eliminó el paquete completo. Se recomienda encarecidamente hacer una copia de seguridad del proyecto antes de utilizar funciones de eliminación.

-setTimeout N

De forma predeterminada, se produce un tiempo de espera si Enterprise Architect no está en ejecución o si la comunicación con Enterprise Architect no se completa en 3 segundos. El tiempo puede ajustarse entre 3 y 600 segundos. Aumentarlo puede ayudar cuando la comunicación o el procesamiento son más lentos, por ejemplo al utilizar Pro Cloud Server, pero también incrementa la espera ante problemas.

-modifiedInfoPath fullPathToCSVFile

Escribe en el archivo especificado, en formato CSV, información sobre los elementos que la IA haya agregado, editado o eliminado. Estos datos están destinados a permitir evaluar si un modelo fue modificado por la IA o por una persona. La información se agrega continuamente al archivo, por lo que debe considerarse el crecimiento de su tamaño.

Prompts

Al utilizar herramientas de creación, como la creación de elementos, el tipo enviado debe ser correcto y coincidir con la cadena utilizada para crear elementos mediante la Automation Interface de Enterprise Architect. Se proporcionan prompts para facilitar la generación de esos valores, de acuerdo con la especificación MCP.

Por ejemplo, en Claude para Windows, pulsa el icono «+» para mostrar el menú antes de iniciar el chat. Luego selecciona «Agregar desde Enterprise Architect» y elige «Reglas de creación para SysML 1.5», «Reglas de creación para UML» o «Reglas de creación para BPMN 2.0».

Para utilizar otras notaciones, como ArchiMate, definir y proporcionar previamente contenido similar ayuda a obtener un procesamiento correcto. En Claude, al hacer doble clic en un prompt agregado, se muestra el texto completo. Puedes editarlo y guardarlo para uso propio o crear un prompt basado en el original. Si no utilizas herramientas de generación, no es necesario usar prompts.

Estructura del servidor MCP

El servidor MCP para Enterprise Architect consta de dos componentes: MCP3.exe y MCP_EA.dll. MCP3.exe es el ejecutable del servidor MCP y los clientes MCP se conectan mediante el método STDIO. MCP_EA.dll es un complemento estándar de Enterprise Architect que se ejecuta dentro del proceso de Enterprise Architect. Ambos archivos y las bibliotecas necesarias se instalan en el directorio de instalación de Enterprise Architect.

No está previsto ofrecer un servidor MCP basado en HTTP para Enterprise Architect, ya que podría infringir el EULA de Enterprise Architect.

El complemento MCP (MCP_EA.dll) carga algunos archivos de biblioteca de .NET Framework instalados localmente. Esto puede afectar el comportamiento de otros complementos basados en .NET Framework.

Tratamiento de la información procesada por el servidor MCP

El servidor MCP proporciona al cliente MCP la información del modelo de Enterprise Architect especificada por el usuario. El cliente MCP utiliza un LLM para responder preguntas o sugerir cambios en el modelo. El servidor MCP no transmite directamente al exterior la información del modelo de Enterprise Architect. Además, Sparx Systems Japan no accede ni utiliza información de modelos ni datos personales relacionados con las operaciones de los usuarios.

Sin embargo, si el cliente MCP utiliza un LLM, este puede conectarse a servidores externos. Si trabajas con modelos que contienen información confidencial, verifica las políticas de seguridad del cliente MCP y del LLM.

El servidor MCP registra cierta información en MCP_EA.log, pero ese archivo no contiene información relacionada con modelos ni datos personales. El cliente MCP puede generar registros con información detallada. Elimina esos archivos cuando sea necesario. Consulta la sección Archivos de registro para obtener más información.

Descargar instalador

Descargar instalador →

Durante la instalación se muestra el EULA (Acuerdo de licencia de usuario final). Léelo detenidamente antes de continuar con la instalación.

• Para Enterprise Architect de 64 bits: MCP_EA_x64.msi
• Para Enterprise Architect de 32 bits y Enterprise Architect 15.2 o anterior: MCP_EA_x86.msi

Última versión indicada en la fuente: 3.0.4, del 17 de septiembre de 2026. Consulta las notas de la versión.

Preguntas, informes de errores y solicitudes de funciones

Puedes enviar preguntas, informes de errores y solicitudes de funciones mediante el formulario de consulta o escribir a global@sparxsystems.jp. Para informar de errores o solicitar funciones, comprueba si estás utilizando la versión más reciente. Se agregan funciones y se corrigen problemas con regularidad.

Sparx Systems Japan hará lo posible por brindar soporte, agregar funciones y corregir errores, pero no tiene obligación de hacerlo.

Preguntas frecuentes

¿El complemento MCP es gratuito? ¿Se cobrará en el futuro?

El servidor MCP se proporciona gratuitamente y se continuará proporcionando sin cargo.

Las personalizaciones para requisitos específicos de un cliente o la incorporación de funciones solicitadas individualmente pueden tener un costo. Si necesitas un presupuesto para servicios fuera del soporte funcional estándar, puedes solicitar una cotización.

¿Se permite el uso comercial?

Sí. Está permitido y no hay restricciones respecto al propósito de uso.

¿Puedo utilizarlo con la versión x.y de Enterprise Architect?

Se confirmó el funcionamiento con Enterprise Architect 17.1. No hay restricciones de funcionamiento basadas en la versión. También se recibieron informes positivos con versiones anteriores, como 16.1, aunque pueden surgir problemas con versiones antiguas.

No puedo obtener un GUID o indicar elementos de destino mediante GUID.

Este servidor MCP está diseñado para que no sea necesario especificar un destino mediante GUID. Los GUID son información para computadoras, no para personas. Del mismo modo que no mencionamos GUID en una conversación, no se considera natural utilizarlos al dialogar con una IA. Además, exigirlos generaría operaciones ineficientes, como copiar y pegar desde Enterprise Architect. El objetivo es permitir consultar y editar modelos mediante instrucciones naturales, como «el elemento seleccionado» o «el elemento agregado anteriormente».

Quiero una herramienta MCP que ejecute directamente sentencias SQL SELECT.

Actualmente no hay planes para ofrecer esta función. Aunque permitiría recuperar el contenido del modelo sin restricciones, requiere comprender en profundidad la estructura interna de la base de datos y ejecutar consultas SQL precisas. Además, los resultados no tienen un formato fácilmente interpretable por la IA.

El objetivo de este MCP es permitir comprender el contenido del modelo y realizar operaciones masivas sencillas mediante lenguaje natural, sin necesitar ese conocimiento interno. Por ello, no se prevé exponer a terceros mecanismos del lado de las herramientas, como los GUID.

¿Hay una hoja de ruta para futuras funciones?

Por el momento, no. Debido a la rápida evolución de la IA (LLM), cualquier decisión podría quedar obsoleta rápidamente. Se realizan mejoras y se optimizan las funciones según los comentarios y solicitudes de los usuarios.