Lerian MCP

Conecta asistentes de IA como Claude, Cursor o Windsurf al ecosistema Midaz con acceso seguro y en tiempo real a documentación, APIs y servicios locales.

Lerian MCP conecta tu asistente de IA directamente al ecosistema de Midaz. Ya sea que uses ChatGPT, Claude, Cursor, Windsurf u otro cliente compatible, este servidor le da a tu modelo de lenguaje grande (LLM) acceso seguro y en tiempo real a la documentación, las APIs y los servicios locales de Midaz.

El asistente lee la documentación, genera código y ejecuta acciones por ti, para que avances más rápido.

​

¿Qué es MCP?

---

MCP significa Model Context Protocol (Protocolo de Contexto de Modelo). Piénsalo como Bluetooth para LLMs. Así es como tu IA aprende qué herramientas puede usar y cómo funciona tu sistema. También aprende qué preguntas hacer para terminar el trabajo.

Lerian MCP enseña a tu asistente a:

• Entender documentación, arquitectura y SDKs.
• Usar APIs a través de herramientas integradas.
• Hacer preguntas de seguimiento para guiarse a sí mismo.

Una vez conectado, tu asistente se vuelve consciente del contexto y capaz de actuar.

​

¿Por qué usar Lerian MCP?

---

Lerian MCP convierte tu asistente de IA en un compañero de desarrollo. Te ayuda a:

• Buscar documentación de Midaz con lenguaje natural.
• Llamar a las APIs locales de Midaz a través de herramientas, no solo texto estático.
• Entender la arquitectura, endpoints y SDKs de Midaz.
• Generar código, solucionar problemas y automatizar la configuración.
• Mantener todo local y explícitamente con permisos.

Ya sea que construyas nuevas integraciones o des soporte a sistemas de producción, Lerian MCP le da a tu LLM el contexto que necesita, de forma segura e instantánea.

​

Construido para la seguridad

---

Lerian MCP pone la seguridad primero. Este:

• Se ejecuta completamente en tu máquina.
• Tiene acceso de solo lectura por defecto.
• Requiere tu aprobación explícita antes de escribir datos.
• No necesita claves API para la configuración local.
• Tiene el código disponible y es auditable.

Tus datos permanecen donde pertenecen, bajo tu control.

​

¿Qué puede hacer tu asistente?

---

Una vez conectado, tu asistente puede interactuar con tu entorno Midaz como si ya hubiera leído la documentación.

Puede:

• Explicar cómo funcionan los conceptos de Midaz.
• Generar código para tareas del mundo real (ej., crear una organización).
• Buscar y resumir endpoints de API.
• Ayudar a depurar problemas de integración.
• Explorar la arquitectura y SDKs disponibles.
• Ejecutar herramientas preconfiguradas para llamar a tus servicios API locales.

​

Ejemplos de lo que puedes preguntar

• “¿Cómo creo una transacción en Midaz?”
• “Muéstrame el código Go para incorporar una organización.”
• “¿Cuál es la diferencia entre las APIs de onboarding y transaction?”
• “Ayúdame a solucionar este error 400.”
• “Lista todos los tipos de cuenta de Midaz.”

​

Herramientas y prompts disponibles

---

Lerian MCP le da a tu asistente un pequeño conjunto de herramientas para explorar documentación, llamar a las APIs y aprender con pasos guiados. Todo se ejecuta localmente y con lectura primero.

​

Herramientas principales

• lerian: el punto de entrada de solo lectura para documentación, aprendizaje, ejemplos de SDK, descubrimiento de productos y búsqueda.
• portfolio-workflow: ejecuta flujos de trabajo entre varios productos de Lerian.

​

La herramienta lerian

La herramienta lerian recibe un parámetro operation. Cada operación cubre una necesidad:

• discover: resume un producto y las herramientas que expone.
• docs: consulta la documentación de un producto.
• learn: devuelve aprendizaje guiado sobre un tema.
• sdk: devuelve ejemplos de código de SDK en Go o TypeScript.
• search: busca en el conocimiento del producto.

​

Herramientas de API en vivo de Midaz

Dos herramientas le dan a tu asistente acceso en vivo a un Midaz en ejecución:

• midaz-discover: devuelve los recursos, acciones, parámetros y esquemas de solicitud disponibles. Es de solo lectura.
• midaz-execute: llama a la API de Midaz con un contrato de midaz-discover.

Llama a midaz-discover antes de midaz-execute. Una acción de escritura necesita confirmación explícita y un motivo de auditoría.

​

Prompts integrados

Lerian MCP también incluye prompts integrados que guían tareas comunes. Por ejemplo, un prompt puede ayudarte a incorporar una primera organización, aprender un concepto o depurar una llamada de API. Cada prompt se adapta a tu nivel de experiencia y rol.

​

¿Cómo funciona?

---

Lerian MCP enseña a tu asistente usando tres entradas clave:

​

1. Documentación

Tu LLM puede usar de inmediato cualquier cosa que agregues a llms.txt, incluyendo guías de producto, ejemplos y conceptos.

​

2. Herramientas API

El asistente aprende cómo llamar a tus APIs, incluyendo endpoints, campos requeridos y formatos de respuesta, a través de herramientas estructuradas.

​

3. Prompts y flujos de trabajo

Aprende cómo interactuar: qué preguntar, cuándo preguntar y cómo validar el siguiente paso.

​

Flujo de invocación de herramientas

La mayoría de las interacciones del asistente usan este flujo principal. Cuando le pides a tu asistente “crear una organización” u “obtener detalles del Ledger”, sigue esta secuencia:

• El LLM llama a la herramienta.
• MCP valida y enriquece la entrada.
• El servidor MCP activa el manejador de herramientas.
• La herramienta envía la solicitud API.
• La herramienta devuelve la respuesta al asistente en tiempo real.

El siguiente diagrama muestra cómo fluye una solicitud de invocación de herramienta a través del servidor MCP.

​

Descubrimiento y registro de herramientas

Cada vez que el servidor MCP se inicia, registra sus herramientas, como lerian, midaz-discover y midaz-execute. El servidor adapta estas herramientas a las capacidades de cada cliente MCP, como Claude Desktop, Cursor o ChatGPT.

Esto mantiene las cosas actualizadas. Después de que el servidor registra una herramienta, tu asistente sabe cómo usarla.

El siguiente diagrama muestra cómo Lerian MCP anuncia herramientas a tu asistente y las hace utilizables dentro del cliente.

​

Manejo de errores a nivel de protocolo

Si algo sale mal, como una llamada de herramienta mal formada, una respuesta inesperada del backend o una configuración faltante, el servidor MCP devuelve un error estandarizado. En muchos casos, el asistente puede recuperarse y reintentar con una mejor entrada o lógica de respaldo.

El siguiente diagrama muestra cómo Lerian MCP detecta, maneja y comunica errores a nivel de protocolo.

​

De recursos a herramientas

---

Lerian MCP pasó de recursos estáticos a herramientas interactivas. Ahora tu asistente puede explorar, generar, probar y solucionar problemas directamente.

Aspecto	Recursos	Herramientas de documentación
Soporte de cliente	Limitado	Soporte completo en todos los clientes MCP.
Funcionalidad	Contenido estático	Contextual, interactivo, dinámico.
Ejemplos	Texto básico	Código listo para producción.
Búsqueda	Ninguna	Búsqueda difusa con filtros.
Solución de problemas	No disponible	Herramientas de diagnóstico y consejos de prevención.
Interactividad	Solo lectura	Tours guiados, demos y generación de código.

​

Lo que las herramientas desbloquean

Las herramientas de Lerian MCP ayudan a tu asistente a ayudarte. Cubren:

• Referencia de API: Obtén documentación detallada de endpoints con payloads, métodos y ejemplos.
• Tutoriales y guías: Aprende configuración, incorporación y mejores prácticas.
• Arquitectura: Explora cómo se conectan los componentes, incluidos diagramas opcionales.
• Documentación de SDK: Accede a documentación de SDK de Go y TypeScript, con ejemplos de código.
• Generación de código: Genera fragmentos funcionales para tareas como creación de cuentas o transferencias de fondos.
• Patrones de flujo de trabajo: Comprende flujos comunes como incorporación, informes y seguimiento de activos.
• Solución de problemas: Obtén ayuda en tiempo real para resolver problemas de integración.
• Búsqueda y navegación: Localiza rápidamente temas relevantes con filtros avanzados.
• Herramientas de exploración: Ejecuta verificaciones de salud, prueba tours guiados y explora capacidades.

¿Quieres la referencia completa con todas las herramientas y parámetros? Consulta el README de lerian-mcp-server en GitHub.

​

Comenzando

---

Lerian MCP funciona localmente y se integra con múltiples asistentes de IA. Todo lo que necesitas es Node.js instalado y una de las herramientas compatibles a continuación.

Antes de configurarlo, comprueba qué herramientas están disponibles para tu sistema operativo:

Herramienta	Linux	macOS	Windows	Notas
ChatGPT Desktop	No oficial	Sí	Sí	Compilaciones de Linux disponibles vía Flatpak y AppImage (mantenido por la comunidad).
Claude Desktop	No	Sí	Sí	No compatible con Linux.
Claude Code (CLI)	Sí	Sí	Sí	Basado en terminal, funciona en cualquier lugar con Node.js.
Cursor IDE	Sí	Sí	Sí	Basado en Electron, soporta oficialmente todas las plataformas.
Windsurf IDE	Sí	Sí	Sí	Soporte de Linux disponible, aunque ligeramente limitado.
Continue (VS Code)	Sí	Sí	Sí	Extensión de VS Code, completamente multiplataforma.

Para usuarios de Linux, recomendamos usar Claude Code, Cursor, Windsurf o Continue para la mejor experiencia.

Ahora, elige tu asistente y sigue las instrucciones a continuación para conectar Lerian MCP.

​

ChatGPT Desktop

1. Abre tu archivo de configuración MCP

   • ~/Library/Application Support/ChatGPT/mcp.json (macOS).
   • %APPDATA%\ChatGPT\mcp.json (Windows).
2. Agrega el siguiente código

   Shell

   {
     "mcpServers": {
       "lerian": {
         "command": "npx",
         "args": ["@lerianstudio/lerian-mcp-server@latest"]
       }
     }
   }
   
3. Reinicia la aplicación.

​

Claude Desktop

1. Abre el archivo claude_desktop_config.json

   • ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
   • %APPDATA%\Claude\claude_desktop_config.json (Windows).
2. Agrega el siguiente código

   Shell

   {
     "mcpServers": {
       "lerian": {
         "command": "npx",
         "args": ["@lerianstudio/lerian-mcp-server@latest"]
       }
     }
   }
   
3. Reinicia la aplicación.

​

Compatibilidad hacia atrás

El nombre antiguo del paquete (@lerianstudio/midaz-mcp-server@latest) todavía funciona, pero ahora está obsoleto. Migra a @lerianstudio/lerian-mcp-server.

Shell

{
  "mcpServers": {
    "midaz": {
      "command": "npx",
      "args": ["@lerianstudio/midaz-mcp-server@latest"]
    }
  }
}

​

Claude Code

Si usas Claude Code desde la línea de comandos, usa los siguientes comandos:

• Para una configuración única, usa:

Shell

npx --yes @lerianstudio/lerian-mcp-server

• Para agregarlo a Claude Code, usa:

Shell

claude mcp add --scope user lerian -- npx --yes @lerianstudio/lerian-mcp-server

​

Migración desde el paquete antiguo

Si habilitaste el MCP con el paquete antiguo @lerianstudio/midaz-mcp-server, sigue estos pasos:

1. Eliminar paquete antiguo

   Shell

   npm uninstall -g @lerianstudio/midaz-mcp-server
   
2. Instalar nuevo paquete

   Shell

   npm install -g @lerianstudio/lerian-mcp-server
   
3. Actualizar Claude Code

   Shell

   npm install -g @lerianstudio/lerian-mcp-server
   
4. Actualizar Claude Code

   Shell

   claude mcp remove midaz\
   claude mcp add lerian "lerian-mcp-server"
   

​

Cursor IDE

1. Ve a File > Preferences > Cursor Settings > MCP.

2. Haz clic en el botón +Add new global MCP Server.

3. Agrega el siguiente código:

   Shell

   {
     "mcp.servers": {
       "lerian": {
         "command": "npm",
         "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"]
       }
     }
   }
   
4. Reinicia la aplicación.

​

Windsurf IDE

1. Ve a File> Preferences > Windsurf Settings.

2. Haz clic en el botón Manage plugins en la sección Cascade.

3. Haz clic en View raw config.

4. Agrega el siguiente código:

   Shell

   {
     "mcpServers": {
       "lerian": {
         "command": "npm",
         "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"]
       }
     }
   }
   
5. Guarda el archivo.

6. Haz clic en Refresh en la pestaña Manage plugins.

En Windsurf IDE, debes usar el panel Cascade para preguntar sobre Midaz.

​

Continue (VS Code)

En VS Code, instala la extensión Continue y agrega el código Lerian MCP al archivo config.yaml.

Puedes encontrar el archivo en las siguientes ubicaciones:

• ~/.continue/config.yaml (MacOS / Linux).
• %USERPROFILE%.continue\config.yaml (Windows).

También puedes abrir el archivo vía VS Code:

1. En VS Code, abre el panel Continue desde la barra de actividad (o presiona cmd/ctrl + L).

2. Haz clic en el selector Assistant encima de la entrada de chat principal.

3. Desde ese menú desplegable, selecciona el ícono de engranaje junto a la opción “Local Assistant”.

4. Se abrirá el config.yaml local.

5. Agrega el siguiente código y guarda el archivo:

   JSON

   mcpServers:
     - name: Lerian
       command: npx
       args:
         - '@lerianstudio/lerian-mcp-server@latest'
   
6. Cierra y vuelve a abrir VS Code.

7. Abre el panel Continue desde la Barra de actividad.

​

¿Necesitas ayuda?

---

​

¿Algo no está funcionando?

Primero saquemos lo básico del camino:

1. Reinicia tu asistente de IA después de guardar la configuración.

2. Verifica dos veces la ruta del archivo

   ¿Estás editando el archivo de configuración correcto?

3. Ejecuta una prueba rápida

   Pregunta a tu asistente, “¿Puedes acceder a la documentación de Lerian?”

​

¿Aún atascado?

• ¿Usando Claude Desktop? - Asegúrate de que MCP esté habilitado en tu versión.
• ¿Usando cualquier otra aplicación de IA? - Confirma que Node.js esté instalado en tu máquina.
• ¿Necesitas ayuda? - Abre un ticket en GitHub Issues.

​

¿Migrando desde Midaz MCP?

No te preocupes, ambos paquetes funcionan exactamente igual:

• Puedes usar @lerianstudio/midaz-mcp-server o @lerianstudio/lerian-mcp-server.
• Lerian MCP admite tanto las variables de entorno MIDAZ_* como las LERIAN_*.
• Los archivos de configuración funcionan desde las carpetas .midaz/ o .lerian/.
• Los comandos CLI midaz-mcp-server y lerian-mcp-server son intercambiables.

Cómo cambiar:

1. Apunta tu configuración a @lerianstudio/lerian-mcp-server.

2. Reinicia tu asistente de IA.

3. (Opcional) Actualiza tus variables de entorno de MIDAZ_* a LERIAN_*.

4. (Opcional) Mueve tus archivos de configuración a .lerian/.

​

¿Listo para comenzar?

---

Tu asistente lo está. Conecta la configuración, reinicia tu aplicación y comienza a construir.