Saltar al contenido principal
Es como darle a tu asistente conocimiento interno, para que pueda leer la documentación, generar código, ejecutar acciones y ayudarte a avanzar más rápido.

​
¿Qué es MCP?

MCP significa Model Context Protocol. Piénsalo como Bluetooth para LLMs: es cómo tu IA aprende qué herramientas puede usar, cómo funciona tu sistema y qué preguntas hacer para realizar el trabajo. Lerian MCP enseña a tu asistente a:
  • Comprender documentación, arquitectura y SDKs.
  • Usar APIs a través de herramientas integradas.
  • Consultarse inteligentemente con preguntas de seguimiento.
Una vez conectado, tu asistente se vuelve consciente del contexto y capaz de actuar.

​
¿Por qué usar Lerian MCP?

Lerian MCP transforma tu asistente de IA en un compañero productivo de desarrollo. Te ayuda a:
  • Buscar documentación de Midaz con lenguaje natural.
  • Llamar APIs locales de Midaz usando herramientas (no solo texto estático).
  • Comprender la arquitectura, endpoints y SDKs de Midaz.
  • Generar código, solucionar problemas y automatizar configuraciones.
  • Mantener todo local y con permisos explícitos.
Ya sea que estés construyendo nuevas integraciones o dando soporte a sistemas en producción, este plugin proporciona a tu LLM el contexto necesario, de forma segura e instantánea.

​
Construido para la seguridad

La seguridad está integrada en cada paso. Lerian MCP:
  • Se ejecuta completamente en tu máquina.
  • Tiene acceso de solo lectura por defecto.
  • Requiere aprobación explícita del usuario antes de escribir datos.
  • No necesita claves de API para la configuración local.
  • Es código abierto y auditable.
Tus datos permanecen donde deben, 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 (por ejemplo, crear una Organización).
  • Buscar y resumir endpoints de API.
  • Ayudar a depurar problemas de integración.
  • Explorar la arquitectura y los SDKs disponibles.
  • Ejecutar herramientas preconfiguradas para llamar a tus servicios de API locales.

​
Ejemplos de lo que puedes preguntar

  • “¿Cómo creo una Transacción en Midaz?”
  • “Muéstrame el código en Go para incorporar una Organización.”
  • “¿Cuál es la diferencia entre las APIs de onboarding y transacción?”
  • “Ayúdame a solucionar este error 400.”
  • “Lista todos los tipos de Cuenta de Midaz.”
Es como hablar con un compañero de equipo que siempre tiene la respuesta y el ejemplo correcto listo para usar.

​
Herramientas y prompts disponibles

Lerian MCP proporciona a tu asistente una caja de herramientas completa para explorar documentación, interactuar con APIs y aprender mediante guías prácticas. Todo se ejecuta localmente, de forma segura y consciente del contexto.

​
Acceso completo a la documentación (midaz-docs)

​
Operaciones disponibles

  • getting-started: Introducción a Midaz.
  • api-reference: Documentación detallada de la API.
  • search-endpoints: Búsqueda por endpoint o función.
  • best-practices: Mejores prácticas de seguridad, rendimiento y modelado.
  • architecture: Descripción general de la arquitectura del sistema.
  • sdk-docs: Documentación oficial de SDK.
  • code-examples: Generación de ejemplos de código.
  • workflows: Patrones comunes de flujo de trabajo.
  • troubleshooting: Guías de resolución de problemas y diagnóstico.
  • search: Búsqueda general en la documentación.
  • sitemap: Estructura completa de la documentación.
  • read: Acceso directo a una página específica.
  • browse: Navegación guiada a través de la documentación.

​
Herramientas de aprendizaje guiado (midaz-learn)

​
Tipos de contenido disponibles

  • path: Rutas de aprendizaje personalizadas.
  • tutorial: Tutoriales paso a paso.
  • concept: Explicaciones profundas de conceptos.
  • search: Búsqueda rápida en materiales de aprendizaje.

​
Operaciones de dominio

​
Organizaciones

  • list-organizations: Listar todas las Organizaciones.
  • get-organization: Obtener detalles de una Organización específica.

​
Ledgers

  • list-ledgers: Listar todos los Ledgers en una Organización.
  • get-ledger: Obtener detalles de un Ledger específico.

​
Cuentas

  • list-accounts: Listar todos los Cuentas bajo un Ledger.
  • get-account: Obtener detalles de un Cuenta.
  • get-balance: Verificar el saldo de un Cuenta.

​
Transactions

  • list-transactions: Listar todas las Transactions.
  • get-transaction: Obtener detalles de una Transacción.

​
SDK

  • generate-sdk-code: Generar código usando SDKs oficiales.
  • compare-sdk-features: Comparar características entre SDKs.
  • find-sdk-examples: Buscar ejemplos de código específicos.

​
Prompts disponibles

Tu asistente también comprende una amplia gama de prompts integrados que adaptan el contenido al nivel de experiencia, tiempo disponible o rol del usuario.

​
Documentación

  • Formato: detailed, summary, examples-only.
  • Categorías: api, guides, examples, models, components.

​
Aprendizaje

  • Nivel de experiencia: beginner, intermediate, advanced.
  • Modo de aprendizaje: explain, show-me, guide-me, deep-dive.
  • Tiempo disponible: 5min, 15min, 30min, 1hour, deep-dive.

​
SDK

  • Lenguajes: golang, typescript.
  • Casos de uso: basic-setup, organization-crud, transaction-processing, authentication-setup, error-handling.

​
Complejidad

  • overview: Resumen de alto nivel.
  • detailed: Recorrido completo.
  • deep-dive: Inmersión técnica profunda con contexto.

​
Roles de usuario

  • developer: Para quienes escriben código.
  • admin: Para administradores de sistemas.
  • business: Para consumidores de datos y analistas.
  • explorer: Para usuarios que exploran la funcionalidad de Midaz.

​
Combinando herramientas y prompts

Puedes combinar cualquier herramienta con un prompt para crear una experiencia completamente personalizada. Por ejemplo:
  • Un desarrollador principiante podría usar midaz-learn con un prompt de tutorial.
  • Un usuario técnico podría acceder a midaz-docs con api-reference para una revisión detallada de endpoints.
Estas combinaciones desbloquean sesiones dinámicas, guiadas y altamente productivas, impulsadas por tu asistente.

​
¿Cómo funciona?

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

​
1. Documentación

Todo lo que se agrega a llms.txt está inmediatamente disponible para tu LLM, incluyendo guías de producto, ejemplos y conceptos.

​
2. Herramientas de 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. ¿El resultado? Una IA más inteligente, segura y proactiva.

​
Flujo de invocación de herramientas

Este es el flujo central utilizado en la mayoría de las interacciones del asistente. Cuando le pides a tu asistente que “cree una Organización” u “obtenga detalles del Ledger”, sigue esta secuencia:
  • El LLM llama a la herramienta.
  • MCP valida y enriquece la entrada.
  • Se activa el manejador de herramientas.
  • Se envía la solicitud a la API.
  • La respuesta se devuelve 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 un conjunto de herramientas, como get-api-reference, generate-code-examples y get-architecture-overview. Estas herramientas se adaptan automáticamente a las capacidades de cada cliente MCP (por ejemplo, Claude Desktop, Cursor, ChatGPT). Esto facilita mantener las cosas actualizadas: una vez que se 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 (por ejemplo, una llamada de herramienta mal formada, una respuesta inesperada del backend o una configuración faltante), el servidor MCP devuelve un error estandarizado de manera elegante. En muchos casos, el asistente puede recuperarse y reintentar con una entrada mejorada 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

Hemos pasado de recursos estáticos a herramientas interactivas, para que tu asistente pueda explorar, generar, probar y solucionar problemas con interactividad real.
AspectoRecursosHerramientas de documentación
Soporte de clienteLimitadoSoporte completo en todos los clientes MCP.
FuncionalidadContenido estáticoContextual, interactivo, dinámico.
EjemplosTexto básicoCódigo listo para producción.
BúsquedaNingunaBúsqueda difusa con filtros.
Solución problemasNo disponibleHerramientas diagnóstico y consejos prevención.
InteractividadSolo lecturaTours guiados, demos y generación de código.

​
Lo que desbloquean las herramientas

Las herramientas de Lerian MCP están diseñadas para ayudar a tu asistente a ayudarte. Esto es lo que 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, incluyendo diagramas opcionales.
  • Documentación de SDK: Accede a la 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, reportes 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.
Consejo¿Quieres la referencia completa con todas las herramientas y parámetros soportados? Consulta la lista completa en GitHub.

​
Primeros pasos

Lerian MCP funciona localmente y se integra con múltiples asistentes de IA. Todo lo que necesitas es tener Node.js instalado y una de las herramientas compatibles a continuación. Antes de configurarlo, verifica qué herramientas están disponibles para tu sistema operativo:
HerramientaLinuxmacOSWindowsNotas
ChatGPT Desktop No oficial Sí SíVersiones para Linux disponibles vía Flatpak y AppImage (mantenido por la comunidad).
Claude Desktop No Sí SíNo soportado en 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 para Linux disponible, aunque ligeramente limitado.
Continue (VS Code) Sí Sí SíExtensión de VS Code, completamente multiplataforma.
ConsejoPara usuarios de Linux, recomendamos usar Claude Code, Cursor, Windsurf o Continue para obtener 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

{
  "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

{
  "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 está obsoleto. Por favor, migra a @lerianstudio/lerian-mcp-server. 
{
  "mcpServers": {
    "midaz": {
      "command": "npx",
      "args": ["@lerianstudio/midaz-mcp-server@latest"]
    }
  }
}

​
Claude Code

Si estás usando Claude Code vía línea de comandos, usa los siguientes comandos:
  • Para una configuración única, usa:
npx —yes @lerianstudio/lerian-mcp-server
  • Para agregar a Claude Code, usa:
claude mcp add —user lerian "npx —yes @lerianstudio/lerian-mcp-server"

​
Migración desde el paquete antiguo

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

Elimina el paquete antiguo

npm uninstall -g @lerianstudio/midaz-mcp-server
2

Instala el nuevo paquete

npm install -g @lerianstudio/lerian-mcp-server
3

Actualiza Claude Code

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:
{
  "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

{
  "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.
AtenciónEn Windsurf IDE, debes usar el panel Cascade para consultar sobre Midaz.

​
Continue (VS Code)

En VS Code, instala la extensión Continue y agrega el código de 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 a través de 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 del chat principal.
3
Desde ese menú desplegable, selecciona el ícono de engranaje junto a la opción “Local Assistant”.
4
Se abrirá el archivo local config.yaml.
5

Agrega el siguiente código y guarda el archivo

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 funciona?

Primero, cubramos lo básico:
1
Reinicia tu asistente de IA después de guardar la configuración.
2
Verifica 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?”

​
¿Sigues atascado?

  • ¿Usas Claude Desktop? - Asegúrate de que MCP esté habilitado en tu versión.
  • ¿Usas 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 tanto @lerianstudio/midaz-mcp-server como @lerianstudio/lerian-mcp-server.
  • Se soportan las variables de entorno MIDAZ_* y LERIAN_*.
  • Los archivos de configuración funcionan tanto desde carpetas .midaz/ como .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á. Solo conecta la configuración, reinicia tu aplicación y comienza a construir, aprender y entregar más rápido.