Integración de MCP

¿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:

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)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

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

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 o el repositorio oficial de servidores de MCP 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 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

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
• Comunidad de Discord de Verdent

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