Qovery

Un servidor MCP para Qovery AI Copilot que permite desplegar aplicaciones y gestionar Kubernetes en infraestructuras de AWS, GCP, Azure y On-Premise con lenguaje natural.

Ver en qovery.comPrueba este MCPPatrocinado

Documentación

Servidor MCP

Conecta cualquier cliente compatible con MCP a tu infraestructura de Qovery

Descripción general

El Servidor MCP de Qovery te permite interactuar con tu infraestructura de Qovery desde cualquier cliente compatible con MCP (Claude, Claude Code, ChatGPT, etc.) usando lenguaje natural.

Información

¿Qué es MCP? El Protocolo de Contexto de Modelo es un estándar abierto desarrollado por Anthropic que permite a los asistentes de IA interactuar con herramientas y sistemas externos. Aprende más →

Consejo

¿Quieres desplegar una nueva aplicación desde el código fuente? El Servidor MCP es para gestionar infraestructura existente. Para desplegar una nueva aplicación desde tu código usando un agente de IA, instala la Habilidad del Agente Qovery en su lugar — funciona con Claude Code, Cursor, OpenCode y más de 30 herramientas de codificación con IA. La habilidad y el Servidor MCP se complementan: usa la habilidad para desplegar y luego el Servidor MCP para gestionar.

Requisitos previos

Cliente compatible con MCP: Cualquier aplicación compatible con MCP
Cuenta de Qovery: Cuenta activa con infraestructura

Configuración

El Servidor MCP de Qovery es accesible en https://mcp.qovery.com/mcp. Puedes encontrar esta URL y gestionar tu acceso MCP en la Consola bajo Configuración > Servidor MCP. Elige uno de los dos métodos de autenticación a continuación para conectar tu cliente MCP.

Si tu cliente MCP soporta OAuth, esta es la opción más fácil — no se requiere generación de tokens. El cliente manejará la autenticación automáticamente.

**Ejemplo con Claude Code:**

```bash theme={null}
# Read-only (default)
claude mcp add --transport http qovery https://mcp.qovery.com/mcp --callback-port 4242

# Read/write
claude mcp add --transport http qovery "https://mcp.qovery.com/mcp?read_write=true" --callback-port 4242
```

Consulta la documentación de tu cliente MCP para saber cómo configurar OAuth con una URL de servidor personalizada.

Si tu cliente MCP no soporta OAuth, genera un token de API de Qovery y pásalo a través de la URL.

**Paso 1 — Genera un token:**

<Steps>
  <Step title="Open Qovery Console">
    Ve a [console.qovery.com](https://console.qovery.com)
  </Step>

  <Step title="Navigate to Settings">
    Haz clic en el ícono de configuración en tu organización
  </Step>

  <Step title="Access API Tokens">
    Ve a la sección **Tokens de API**
  </Step>

  <Step title="Generate Token">
    Haz clic en "Generar Token" y cópialo

Advertencia

¡Guarda este token de forma segura. No podrás verlo de nuevo!

**Paso 2 — Configura tu cliente MCP:**

Usa el siguiente formato de URL, reemplazando `your_qovery_token` con tu token:

```
# Read-only (default)
https://mcp.qovery.com/mcp?token=your_qovery_token

# Read/write
https://mcp.qovery.com/mcp?token=your_qovery_token&read_write=true
```

También puedes pasar el token a través de un encabezado `Authorization` en su lugar:

Si quieres usar un token de API de Qovery, por ejemplo para poder limitar el permiso de lo que se puede hacer.
Puedes crear un token con permiso de solo lectura/vista para garantizar que no se pueda realizar ninguna acción destructiva.

<Tabs>
  <Tab title="Claude Code">
    Configura claude code para agregar tu token de Qovery en los encabezados HTTP

    ```bash theme={null}
    claude mcp add --transport http qovery https://mcp.qovery.com/mcp --header 'Authorization: Token qov_xxxx'
    ```

    ```
    Authorization: Token your_qovery_token
    ```
  </Tab>
</Tabs>

Información

El Servidor MCP de Qovery también está disponible a través del Registro MCP.

Modos de acceso

Modo	Predeterminado	Descripción
Solo lectura	Sí	Puede consultar y listar recursos (entornos, servicios, despliegues, etc.)
Lectura/escritura	No (`read_write=true`)	También puede activar despliegues, actualizar configuraciones y realizar operaciones de escritura

Información

La herramienta devops_copilot depende de dos configuraciones en tu Consola de Qovery:

Copilot debe estar habilitado — si está deshabilitado, la herramienta no será accesible en absoluto, independientemente de tu configuración MCP

El acceso de escritura debe estar habilitado — requerido para usar la herramienta en modo lectura/escritura (además del parámetro de URL read_write=true)

Advertencia

Habilita el modo de escritura solo cuando sea necesario. Prefiere el modo de solo lectura para limitar el radio de impacto de acciones de IA no intencionadas.

Ejemplos de uso

Una vez conectado, puedes interactuar con tu infraestructura de forma natural:

"Show me all my environments"
"What services are running in production?"
"List projects in my organization"

Solución de problemas

El Servidor MCP no se conecta

Problema: El cliente no muestra las herramientas de Qovery o no puede conectarse

Soluciones:

Verifica que la URL del Servidor MCP sea correcta: https://mcp.qovery.com/mcp
Revisa tu conexión a internet
Reinicia tu cliente MCP
Contacta al Soporte de Qovery si el problema persiste

Errores de autenticación

Problema: Errores de "Autenticación fallida" o "Token inválido"

Soluciones:

Verifica que tu token de API sea correcto (revisa si hay errores de copiar y pegar)
Asegúrate de que el token no haya sido revocado o haya expirado
Genera un nuevo token de API si es necesario desde la Consola de Qovery

Mejores prácticas de seguridad

Advertencia

Seguridad del token de API:

Nunca compartas tus tokens de API públicamente

No confirmes tokens en el control de versiones

Revoca los tokens que ya no necesites desde la Consola de Qovery

Usa tokens con los permisos mínimos requeridos

Rota los tokens regularmente

Permisos de token

El token de API tiene los mismos permisos que el rol que seleccionaste durante su creación:

Solo puede acceder a recursos dentro de tu organización
Respeta las políticas RBAC de la organización
Todas las acciones se auditan en la Consola de Qovery

Próximos pasos

Usa el Copilot de Consola integrado para obtener ayuda rápida Configura el Bot de Slack para colaboración en equipo Explora todo lo que Copilot puede hacer Ejemplos prácticos y casos de uso

Recursos

Protocolo MCP: modelcontextprotocol.io
Claude: claude.ai
Blog técnico: Cómo construimos un Copilot DevOps Agéntico

Gestiona tu infraestructura y aplicaciones con lenguaje natural

Pídele a Claude que liste entornos, verifique el estado de las aplicaciones, revise registros o active un despliegue. Todo a través del Servidor MCP de Qovery. Sin necesidad de kubectl.

Prueba Qovery gratis →

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.