> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # 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. Cómo una invocación de herramienta fluye por el servidor MCP de Lerian, desde la llamada del asistente hasta la respuesta, pasando por la validación de la entrada y la solicitud a la API ### 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. Cómo el servidor MCP de Lerian registra sus herramientas al iniciarse y las anuncia al asistente para que se puedan usar 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. Cómo el servidor MCP de Lerian detecta un error a nivel de protocolo, devuelve un error estandarizado y permite que el asistente se recupere y reintente ## 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](https://github.com/LerianStudio/lerian-mcp-server). ## Comenzando *** **Lerian MCP** funciona localmente y se integra con múltiples asistentes de IA. Todo lo que necesitas es [Node.js](https://nodejs.org/en/download) 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 * `~/Library/Application Support/ChatGPT/mcp.json` (macOS). * `%APPDATA%\ChatGPT\mcp.json` (Windows). ```bash Shell theme={null} { "mcpServers": { "lerian": { "command": "npx", "args": ["@lerianstudio/lerian-mcp-server@latest"] } } } ``` Reinicia la aplicación. ### Claude Desktop * `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS). * `%APPDATA%\Claude\claude_desktop_config.json` (Windows). ```bash Shell theme={null} { "mcpServers": { "lerian": { "command": "npx", "args": ["@lerianstudio/lerian-mcp-server@latest"] } } } ``` 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`. ```bash Shell theme={null} { "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: ```bash Shell theme={null} npx --yes @lerianstudio/lerian-mcp-server ``` * Para agregarlo a Claude Code, usa: ```bash Shell theme={null} 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: ```bash Shell theme={null} npm uninstall -g @lerianstudio/midaz-mcp-server ``` ```bash Shell theme={null} npm install -g @lerianstudio/lerian-mcp-server ``` ```bash Shell theme={null} npm install -g @lerianstudio/lerian-mcp-server ``` ```bash Shell theme={null} claude mcp remove midaz\ claude mcp add lerian "lerian-mcp-server" ``` ### Cursor IDE Ve a **File** > **Preferences** > **Cursor Settings** > **MCP**. Haz clic en el botón **+Add new global MCP Server**. Agrega el siguiente código: ```bash Shell theme={null} { "mcp.servers": { "lerian": { "command": "npm", "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"] } } } ``` Reinicia la aplicación. ### Windsurf IDE Ve a **File**> **Preferences** > **Windsurf Settings**. Haz clic en el botón **Manage plugins** en la sección *Cascade*. Haz clic en **View raw config**. Agrega el siguiente código: ```bash Shell theme={null} { "mcpServers": { "lerian": { "command": "npm", "args": ["exec", "@lerianstudio/lerian-mcp-server@latest"] } } } ``` Guarda el archivo. 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: En VS Code, abre el panel **Continue** desde la barra de actividad (o presiona `cmd/ctrl + L`). Haz clic en el selector **Assistant** encima de la entrada de chat principal. Desde ese menú desplegable, selecciona el ícono de engranaje junto a la opción "Local Assistant". Se abrirá el `config.yaml` local. Agrega el siguiente código y guarda el archivo: ```bash JSON theme={null} mcpServers: - name: Lerian command: npx args: - '@lerianstudio/lerian-mcp-server@latest' ``` Cierra y vuelve a abrir VS Code. Abre el panel **Continue** desde la *Barra de actividad*. ## ¿Necesitas ayuda? *** #### ¿Algo no está funcionando? Primero saquemos lo básico del camino: **Reinicia tu asistente de IA** después de guardar la configuración. ¿Estás editando el archivo de configuración correcto? 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](https://github.com/lerianstudio/lerian-mcp-server/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:** Apunta tu configuración a `@lerianstudio/lerian-mcp-server`. Reinicia tu asistente de IA. (Opcional) Actualiza tus variables de entorno de `MIDAZ_*` a `LERIAN_*`. (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.