# Integración con MCP (/es/docs/verdent-for-vscode/advanced-features/mcp)

> Amplía Verdent con servidores y plugins de Model Context Protocol



### Lo que aprenderás [#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.

<Info>
  La documentación completa de MCP está en desarrollo. Esta página ofrece una descripción general de las capacidades de MCP, con guías detalladas que llegarán pronto. Escribe a [support@verdent.ai](mailto:support@verdent.ai) para consultas específicas sobre integraciones.
</Info>

***

## ¿Qué es MCP (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 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 [#ventajas-de-la-integración-con-mcp]

### Capacidades ampliadas [#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 [#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 [#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 [#configuración-de-servidores-de-mcp]

### Proceso de configuración [#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.

<Note>
  El esquema de configuración detallado de MCP y las instrucciones de configuración se están finalizando. Para obtener ayuda inmediata con la configuración de servidores de MCP, consulta la especificación del protocolo MCP o ponte en contacto con el soporte de Verdent.
</Note>

### Gestión de la configuració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-y-extensiones-de-mcp]

### Plugins disponibles [#plugins-disponibles]

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

<Info>
  Se está compilando una lista curada de los plugins de MCP disponibles. Consulta la documentación oficial de Verdent o los recursos del ecosistema de MCP para conocer la disponibilidad actual de plugins.
</Info>

**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 [#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 [#desarrollo-de-servidores-de-mcp-personalizados]

### Creación de servidores 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

<Note>
  Se están desarrollando guías completas para el desarrollo de servidores de MCP personalizados, que incluirán los requisitos de implementación del protocolo, la documentación del SDK y las herramientas de prueba. Para necesidades inmediatas de integración personalizada, consulta la especificación del protocolo MCP.
</Note>

### Patrones de integración [#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 [#ejemplos-de-flujos-de-trabajo-con-mcp]

### Integración de consultas a bases de datos [#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 [#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 [#monitoreo-de-pipelines-de-cicd]

**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 [#consideraciones-de-seguridad]

### Autenticación y autorización [#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 [#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 [#solución-de-problemas-de-la-integración-con-mcp]

### Problemas comunes [#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 [#obtener-ayuda]

**Canales de soporte:**

* Soporte de Verdent: [support@verdent.ai](mailto:support@verdent.ai)
* [Documentación del protocolo MCP](https://modelcontextprotocol.io)
* [Comunidad de Verdent en Discord](https://discord.com/invite/NGjXEZcbJq) 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 [#recursos-de-documentación-de-mcp]

### Documentación oficial [#documentación-oficial]

<Info>
  Se están desarrollando guías completas de integración con MCP, que incluirán:

  * La especificación completa del protocolo MCP
  * La documentación del SDK para el desarrollo de servidores
  * Un marketplace y registro de plugins
  * Ejemplos y tutoriales de integración
  * Una referencia de API para el desarrollo de servidores personalizados
</Info>

**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 [#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](mailto:support@verdent.ai) con tu caso de uso específico y tus requisitos de integración.

***

## Consulta también [#consulta-también]

<CardGroup cols="2">
  <Card title="Referencia de herramientas" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacidades de las herramientas integradas
  </Card>

  <Card title="Extensibilidad" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    Otros métodos de extensión
  </Card>

  <Card title="Configuración" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Ajustes y preferencias de Verdent
  </Card>

  <Card title="Buenas prácticas" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    Técnicas efectivas de prompting
  </Card>
</CardGroup>
