Integración con MCP

Lo que aprenderás

Descripción general de la integración de Model Context Protocol (MCP) en Verdent for VS Code, incluyendo la configuración, los ajustes y las opciones de extensibilidad.

¿Qué es MCP (Model Context Protocol)?

Model Context Protocol (MCP) es un sistema de integración que amplía las capacidades de Verdent al conectarse con 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, lo que posibilita 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 forma similar a las 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 Ajustes.

Ventajas de la integración con MCP

Capacidades ampliadas

Acceso a sistemas externos: Conecta Verdent con herramientas y servicios que no están disponibles mediante las funciones integradas. 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: Aprovecha el 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, lo que garantiza 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 según el contexto: Las integraciones de MCP comprenden 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 servidores de MCP

Proceso de configuración

Accede a los ajustes de MCP:

1. Abre el menú de Ajustes en Verdent
2. Ve a la sección Servidores de MCP
3. Consulta 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.

Gestión de la configuración

Agregar servidores: Configura nuevos servidores de MCP agregando entradas a mcp.json con los detalles de la conexión y las credenciales de autenticación.

Múltiples servidores: Verdent admite varios servidores de MCP concurrentes, lo que permite la integración con varios sistemas externos de forma simultánea.

Probar conexiones: Valida las configuraciones de los servidores de MCP para asegurar conexiones exitosas antes de usarlos en los flujos de trabajo de desarrollo.

Plugins y extensiones de MCP

Plugins disponibles

Los plugins de MCP ofrecen integraciones predefinidas para herramientas y servicios comunes.

Categorías de plugins previstas:

• 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 Ajustes 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 tener dependencias de servicios o bibliotecas externas. Los procesos de instalación gestionan la resolución de 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.

Casos de uso para servidores personalizados:

• Integración con APIs internas: conecta con APIs y servicios específicos de la empresa
• Puentes con 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 del flujo 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 varios tipos de herramientas.

Ejemplos de flujos de trabajo con MCP

Integración de consultas a bases de datos

Escenario: Consultar la base de datos de producción para depurar problemas de datos.

Enfoque con 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 con 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 registros.

Monitoreo de pipelines de CI/CD

Escenario: Revisar el estado de la compilación antes de desplegar cambios.

Enfoque con MCP:

User: "Is the main 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 del pipeline y ofrece 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 los 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.

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 pueden revisarse en Manual Accept Mode antes de ejecutarse, lo que ofrece visibilidad y control.

Registro de auditoría: Las operaciones de los servidores de MCP aparecen en el historial de chat de Verdent, lo que crea un registro de auditoría de las interacciones con sistemas externos.

Solución de problemas de la integración con 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 de 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
• Verifica 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

Obtener ayuda

Canales de soporte:

• Soporte de Verdent: support@verdent.ai
• Documentación del protocolo MCP
• Comunidad de Verdent en Discord para soporte en tiempo real

Información de diagnóstico: Al reportar problemas de MCP, proporciona:

• Tipo y versión del servidor de MCP
• Detalles de configuración (sin incluir credenciales)
• Mensajes de error del historial de chat
• Registros del servidor de MCP (si están disponibles)

Recursos de documentación de MCP

Documentación oficial

Próximamente:

• Guías paso a paso para la configuración de servidores de MCP
• Recorridos de instalación y configuración de plugins
• Tutoriales para el desarrollo de servidores personalizados
• Buenas prácticas para la integración con MCP
• Optimización del rendimiento para los flujos de trabajo de MCP

Recursos provisionales

Información actual sobre MCP:

• Especificación del protocolo MCP (externa)
• Servidores y ejemplos de MCP desarrollados por la comunidad
• Repositorios de GitHub del ecosistema de MCP

Contacto para más detalles: Para obtener ayuda inmediata con la integración de MCP, escribe a support@verdent.ai con tu caso de uso específico y tus requisitos de integración.

Consulta también