--- title: Integración de MCP description: "Amplía Verdent con servidores y plugins de Model Context Protocol" --- ## ¿Qué es MCP (Model Context Protocol)? Model Context Protocol (MCP) es un sistema de integración que amplía las capacidades de Verdent conectándose a herramientas, fuentes de datos y servicios externos. **Concepto central:** MCP permite que Verdent interactúe con sistemas más allá de su conjunto de herramientas integrado, posibilitando una integración fluida con: - APIs externas y servicios web - Sistemas de bases de datos - Plataformas en la nube (AWS, Azure, GCP) - Herramientas de gestión de proyectos - Pipelines de CI/CD - Herramientas internas personalizadas **Arquitectura:** Los servidores de MCP actúan como puentes entre Verdent y los sistemas externos. Cada servidor de MCP expone capacidades específicas que Verdent puede invocar durante las sesiones de programación, de manera similar a herramientas integradas como `file_read` o `bash`. **Almacenamiento de la configuración:** Las configuraciones de los servidores de MCP se almacenan en `~/.verdent/mcp.json` y se gestionan a través del menú de Configuración. --- ## Beneficios de la integración de MCP ### Capacidades ampliadas **Acceso a sistemas externos:** Conecta Verdent a herramientas y servicios que no están disponibles mediante la funcionalidad integrada. Consulta bases de datos, interactúa con servicios en la nube o integra APIs específicas del proyecto sin salir de tu flujo de trabajo de programación. **Desarrollo de herramientas personalizadas:** Crea servidores de MCP adaptados a los requisitos únicos de tu proyecto. Construye integraciones especializadas para herramientas internas, APIs propietarias o sistemas específicos de tu dominio. ### Interoperabilidad **Aprovechamiento del ecosistema:** Conéctate al creciente ecosistema de MCP. Los servidores de MCP desarrollados por la comunidad ofrecen integraciones predefinidas para herramientas y servicios populares. **Protocolo estandarizado:** MCP proporciona una interfaz coherente para la integración de herramientas, asegurando que las nuevas capacidades se integren sin problemas con el sistema de herramientas existente de Verdent. ### Automatización del flujo de trabajo **Integración fluida:** Los servidores de MCP pasan a formar parte del conjunto de herramientas de Verdent. El agente usa automáticamente las herramientas de MCP cuando corresponde, o puedes invocarlas explícitamente para tareas específicas. **Operaciones conscientes del contexto:** Las integraciones de MCP entienden el contexto de tu base de código, lo que permite interacciones inteligentes con sistemas externos según el estado actual del desarrollo. --- ## Configuración de los servidores de MCP ### Proceso de configuración **Acceder a la configuración de MCP:** 1. Abre el menú de Configuración en Verdent 2. Navega a la sección **Servidores de MCP** 3. Visualiza o modifica la configuración de `~/.verdent/mcp.json` **Archivo de configuración:** Los servidores de MCP se configuran a través del archivo `~/.verdent/mcp.json`, que define las conexiones de los servidores, la autenticación y los parámetros de integración. Consulta la sección **Configuración de MCP** más abajo para ver el esquema completo. ### Gestión de la configuración **Agregar servidores:** Configura nuevos servidores de MCP agregando entradas a `mcp.json` con los detalles de conexión y las credenciales de autenticación. **Múltiples servidores:** Verdent admite múltiples servidores de MCP simultáneos, lo que permite la integración con varios sistemas externos al mismo tiempo. **Probar conexiones:** Valida las configuraciones de los servidores de MCP para asegurar conexiones exitosas antes de usarlos en los flujos de trabajo de desarrollo. ### Estado del servidor Supervisa el estado de la conexión en el panel de configuración de MCP: | Estado | Descripción | |--------|-------------| | **Success** | Servidor conectado y herramientas disponibles | | **Failed** | Error de conexión (selecciona para ver los detalles) | | **Loading** | El servidor se está inicializando | **Actualizar herramientas:** Selecciona el botón de actualizar para volver a descubrir las herramientas disponibles de un servidor tras cambios de configuración o problemas de conexión. --- ## Configuración de MCP ### Configuración básica **Ubicación:** `.mcp.json` en la raíz del proyecto o `~/.verdent/mcp.json` (global) ```json PostgreSQL Server { "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/myapp_dev" ] } } } ``` ```json GitHub Server { "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } } } ``` ```json Multiple Servers { "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/myapp_dev" ] }, "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } } } ``` **Claves de configuración:** - `mcpServers` - Clave de nivel superior requerida para la configuración de MCP - `command` - Ejecutable a correr (normalmente `npx` para paquetes de Node.js) - `args` - Argumentos pasados al comando (nombre del paquete, cadenas de conexión, etc.) - `env` - Variables de entorno para autenticación/configuración **Más información sobre MCP:** - [Especificación de Model Context Protocol](https://modelcontextprotocol.io/specification) - [Registro de servidores de MCP](https://mcp.so/servers) - Explora los servidores de MCP disponibles - [Servidores oficiales de MCP](https://github.com/modelcontextprotocol) - PostgreSQL, GitHub, Filesystem y más --- ## Plugins y extensiones de MCP ### Plugins disponibles Los plugins de MCP ofrecen integraciones predefinidas para herramientas y servicios comunes. Explora el registro de la comunidad en [mcp.so/servers](https://mcp.so/servers) o el [repositorio oficial de servidores de MCP](https://github.com/modelcontextprotocol) para conocer la disponibilidad actual. **Categorías comunes de plugins:** - **Integraciones de bases de datos:** herramientas de consulta para PostgreSQL, MySQL, MongoDB - **Servicios en la nube:** interacciones con APIs de AWS, Azure, GCP - **Herramientas para desarrolladores:** integraciones con GitHub, GitLab, Jira, Linear - **Plataformas de CI/CD:** Jenkins, GitHub Actions, CircleCI - **Servicios de monitoreo:** Datadog, New Relic, Sentry - **Comunicación:** notificaciones de Slack, Discord, Microsoft Teams ### Instalación de plugins **Métodos de instalación:** Los plugins se instalan y configuran a través de la interfaz de Configuración de MCP y normalmente requieren: - Identificador o fuente del plugin - Parámetros de configuración - Credenciales de autenticación (si corresponde) **Gestión de dependencias:** Los plugins de MCP pueden depender de servicios o bibliotecas externos. Los procesos de instalación resuelven las dependencias automáticamente cuando es posible. --- ## Desarrollo de servidores de MCP personalizados ### Creación de servidores personalizados Los usuarios avanzados pueden crear servidores de MCP personalizados para integrar herramientas propietarias o sistemas específicos de su dominio. **Enfoque de desarrollo:** Los servidores de MCP personalizados implementan la especificación del protocolo MCP, exponiendo capacidades de herramientas que Verdent puede invocar. Consulta la [especificación de Model Context Protocol](https://modelcontextprotocol.io/specification) para conocer los detalles de implementación y los SDK. **Casos de uso para servidores personalizados:** - **Integración de API internas:** conéctate a APIs y servicios específicos de la empresa - **Puentes a sistemas heredados:** permite que Verdent interactúe con infraestructura heredada - **Fuentes de datos especializadas:** accede a bases de datos o almacenes de datos propietarios - **Automatización de flujos de trabajo:** activa pipelines personalizados de compilación, despliegue o pruebas ### Patrones de integración **Configuración a nivel de espacio de trabajo:** Los servidores de MCP pueden configurarse a nivel de espacio de trabajo para integraciones específicas del proyecto, lo que permite a los equipos compartir las configuraciones de MCP mediante el control de versiones. **Interoperabilidad de herramientas:** Las herramientas proporcionadas por MCP se integran sin problemas con las herramientas integradas de Verdent (`file_read`, `bash`, `spawn_subagent`), lo que permite flujos de trabajo complejos que combinan múltiples tipos de herramientas. --- ## Funciones de MCP específicas del escritorio ### Configuración por proyecto | Nivel de configuración | Ubicación | Alcance | |---------------------|----------|-------| | **Global** | `~/.verdent/mcp.json` | Todos los proyectos | | **Proyecto** | `.mcp.json` en la raíz del proyecto | Un solo proyecto | | **Worktree** | Hereda del proyecto | Hereda la configuración del proyecto | ### MCP en múltiples worktrees Los servidores de MCP funcionan en todos los worktrees: - **Servidores compartidos:** la configuración base de MCP del espacio de trabajo es compartida por todos los worktrees - **Operaciones aisladas:** cada worktree mantiene un estado de sesión de MCP separado - **Acceso paralelo:** múltiples worktrees pueden usar los mismos servidores de MCP simultáneamente ### Cambio de proyecto Al cambiar de proyecto: - Se cargan los servidores de MCP del proyecto actual - Los servidores globales de MCP siguen disponibles - Las conexiones de MCP del proyecto anterior se mantienen en segundo plano --- ## Ejemplos de flujos de trabajo de MCP ### Integración de consultas a bases de datos **Escenario:** Consultar la base de datos de producción para depurar problemas de datos. **Enfoque de MCP:** ``` User: "Check the orders table for customer ID 12345" Verdent: [Uses MCP database server to execute safe read-only query] Results: 3 orders found for customer 12345 [Displays formatted results] ``` El servidor de base de datos de MCP gestiona la autenticación, la validación de consultas y el formato de los resultados. ### Interacción con servicios en la nube **Escenario:** Revisar los registros de una función AWS Lambda en busca de errores. **Enfoque de MCP:** ``` User: "Show me recent errors from the payment-processor Lambda function" Verdent: [Invokes MCP AWS integration] [Retrieves CloudWatch logs for specified function] [Filters for ERROR level entries] [Presents formatted error summaries] ``` El servidor de AWS de MCP gestiona la autenticación, las llamadas a la API y el análisis de los registros. ### Monitoreo de pipelines de CI/CD **Escenario:** Verificar el estado de la compilación antes de desplegar cambios. **Enfoque de MCP:** ``` User: "Is the master branch build passing?" Verdent: [Queries MCP CI/CD integration] Build #245: ✓ Passed (2 minutes ago) All tests passed, ready for deployment ``` El servidor de CI/CD de MCP rastrea el estado de los pipelines y proporciona retroalimentación en tiempo real. --- ## Consideraciones de seguridad ### Autenticación y autorización **Gestión de credenciales:** Los servidores de MCP gestionan la autenticación con servicios externos. Las credenciales se almacenan de forma segura en la configuración de MCP y nunca se exponen en el historial de chat ni en el código. **Definición del alcance de los permisos:** Configura los servidores de MCP con los permisos mínimos necesarios. Usa acceso de solo lectura cuando sea posible y restringe las operaciones destructivas. ### Operaciones seguras **Revisión de comandos:** Las operaciones que involucran herramientas de MCP aparecen en el historial de conversación, lo que brinda visibilidad y control. **Registro de auditoría:** Las operaciones de los servidores de MCP aparecen en el historial de chat de Verdent, creando un registro de auditoría de las interacciones con sistemas externos. --- ## Resolución de problemas de la integración de MCP ### Problemas comunes **Fallos de conexión:** - Verifica la conectividad de red con el servidor de MCP - Revisa las credenciales de autenticación en `mcp.json` - Asegúrate de que el servidor de MCP esté en ejecución y sea accesible - Valida la sintaxis del archivo de configuración **Errores de permisos:** - Confirma que las claves de API o las credenciales tengan los permisos requeridos - Revisa las cuotas del servicio o los límites de tasa - Verifica que las reglas del firewall permitan el tráfico de MCP **Problemas de invocación de herramientas:** - Asegúrate de que el servidor de MCP exponga correctamente las herramientas esperadas - Comprueba que los formatos de los parámetros de las herramientas coincidan con lo que espera el servidor - Revisa los registros del servidor de MCP para conocer los detalles del error ### Cómo obtener ayuda **Canales de soporte:** - Soporte de Verdent: support@verdent.ai - [Documentación del protocolo MCP](https://modelcontextprotocol.io) - [Comunidad de Discord de Verdent](https://discord.com/invite/NGjXEZcbJq) **Información de diagnóstico:** Al reportar problemas de MCP, proporciona: - Tipo y versión del servidor de MCP - Detalles de configuración (con las credenciales depuradas) - Mensajes de error del historial de chat - Registros del servidor de MCP (si están accesibles) --- ## Preguntas frecuentes Las operaciones de los servidores de MCP consumen créditos según el modelo que procesa los resultados. El servidor de MCP en sí no consume créditos directamente. No. Los servidores de MCP se configuran a nivel de usuario, no por proyecto. Todos los servidores configurados están disponibles en todos tus proyectos. Las credenciales en mcp.json se almacenan localmente en tu equipo y nunca se envían a los servidores de Verdent. Usa variables de entorno (`${VAR_NAME}`) para los valores sensibles. Los servidores de MCP se inician cuando es necesario y se ejecutan durante tu sesión. No consumen recursos cuando Verdent está cerrado. Los servidores de MCP tienen los permisos que configures. Usa acceso de solo lectura cuando sea posible y restringe las operaciones destructivas. Pídele a Verdent que use una herramienta del servidor de MCP. Las respuestas exitosas indican que la conexión está funcionando. Consulta la sección de Resolución de problemas si surgen inconvenientes.