Deployment.io

Configuración de MCP para Agentes de Codificación con IA

---

El Protocolo de Contexto de Modelo (MCP) permite que los agentes de codificación con IA interactúen con tu infraestructura de deployment.io. Una vez configurado, agentes como Claude Code, Cursor, OpenAI Codex, Gemini CLI y Antigravity pueden desplegar tus aplicaciones, gestionar entornos, obtener registros de ejecución y monitorear compilaciones, directamente desde tu flujo de trabajo de desarrollo.

Requisitos previos

• Una cuenta de deployment.io

Métodos de conexión

Hay dos formas de conectar tu agente de codificación a deployment.io:

1. OAuth (recomendado) — El agente abre una ventana del navegador, inicias sesión y apruebas el acceso. No es necesario copiar claves manualmente.
2. Clave de API — Genera una clave desde el panel de control y pégala en la configuración de tu agente.

---

Método 1: OAuth (Recomendado)

OAuth te permite conectarte con un solo clic, sin necesidad de copiar o gestionar claves de API.

Claude Code CLI

Ejecuta el siguiente comando:

claude mcp add --transport http Deployment-io https://api.deployment.io/v1/mcp

Claude Code abrirá una ventana del navegador donde inicias sesión en deployment.io y apruebas el acceso. La conexión se establece automáticamente.

Claude Desktop

1. Ve a Personalizar > Conectores > + > Agregar conector personalizado.
2. Ingresa el nombre Deployment-io y la URL: https://api.deployment.io/v1/mcp
3. Claude Desktop abrirá un navegador para que inicies sesión y apruebes el acceso.

Cursor

1. Abre Cursor y ve a Configuración > Herramientas y MCP.
2. Haz clic en Agregar MCP personalizado.
3. Ingresa la URL: https://api.deployment.io/v1/mcp
4. Cursor abrirá un navegador para que inicies sesión y apruebes el acceso.

OpenAI Codex

1. Agrega el servidor a tu ~/.codex/config.toml:

[mcp_servers.Deployment-io]
url = "https://api.deployment.io/v1/mcp"

2. Ejecuta el comando de inicio de sesión OAuth:

codex mcp login Deployment-io

Codex abrirá una ventana del navegador donde inicias sesión en deployment.io y apruebas el acceso.

Antigravity

1. Abre el Menú en el panel del Agente y ve a Servidores MCP > Gestionar servidores MCP.
2. Haz clic en Ver configuración sin procesar para abrir mcp_config.json.
3. Agrega la siguiente configuración:

{
  "mcpServers": {
    "Deployment-io": {
      "serverUrl": "https://api.deployment.io/v1/mcp"
    }
  }
}

4. Haz clic en Actualizar. Antigravity abrirá un navegador para que inicies sesión y apruebes el acceso.

---

Método 2: Clave de API

Si tu agente no admite OAuth, o prefieres la configuración manual, usa una clave de API.

Paso 1: Generar una clave de API

1. Ve a Configuración de la organización > Claves de agente en tu panel de deployment.io.
2. Haz clic en Crear nueva clave y asígnale un nombre descriptivo (por ejemplo, "Clave de Claude Code").
3. Copia la clave de API inmediatamente; no podrás verla nuevamente.

Paso 2: Copiar la configuración de MCP

Después de generar tu clave, verás un bloque de configuración JSON de MCP como este:

{
  "mcpServers": {
    "Deployment-io": {
      "url": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Reemplaza YOUR_API_KEY con la clave que copiaste en el Paso 1.

Configuración del agente con clave de API

Claude Code CLI

claude mcp add --transport http Deployment-io https://api.deployment.io/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Agrega la configuración a tu archivo claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fusiona la configuración JSON de MCP del Paso 2 en el archivo.

Cursor

1. Abre Cursor y ve a Configuración > Herramientas y MCP.
2. Haz clic en Agregar MCP personalizado.
3. Pega la configuración JSON de MCP del Paso 2 en el editor.
4. Guarda y reinicia Cursor.

Windsurf

1. Abre Windsurf y ve a Configuración > MCP.
2. Haz clic en Agregar servidor y selecciona HTTP.
3. Pega la configuración JSON de MCP del Paso 2.
4. Guarda y reinicia Windsurf.

OpenAI Codex

Agrega el servidor a tu ~/.codex/config.toml:

[mcp_servers.Deployment-io]
url = "https://api.deployment.io/v1/mcp"
bearer_token_env_var = "DEPLOYMENT_IO_API_KEY"

Luego establece la variable de entorno:

export DEPLOYMENT_IO_API_KEY=YOUR_API_KEY

Gemini CLI

Ejecuta el siguiente comando:

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  Deployment-io https://api.deployment.io/v1/mcp

O agrégalo manualmente a tu ~/.gemini/settings.json:

{
  "mcpServers": {
    "Deployment-io": {
      "httpUrl": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

1. Abre el Menú en el panel del Agente y ve a Servidores MCP > Gestionar servidores MCP.
2. Haz clic en Ver configuración sin procesar para abrir mcp_config.json.
3. Agrega la siguiente configuración:

{
  "mcpServers": {
    "Deployment-io": {
      "serverUrl": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

4. Haz clic en Actualizar y reinicia Antigravity.

---

Solución de problemas

• Verifica que tu conexión funcione: Ejecuta un mensaje simple como "lista mis entornos" en tu agente. Si la conexión funciona, verás tus entornos listados.
• Revisa la URL de MCP: Asegúrate de que la URL sea exactamente https://api.deployment.io/v1/mcp sin barra diagonal final.
• Problemas con OAuth: Si la ventana de autorización del navegador no se abre, verifica que tu agente admita conexiones MCP basadas en OAuth. Usa el método de clave de API si es necesario.
• Regenera la clave: Si tu clave de API deja de funcionar, es posible que haya sido revocada. Crea una nueva desde la página de configuración de Claves de agente.
• Revoca el acceso: Puedes revocar agentes conectados por OAuth o claves de API en cualquier momento desde Configuración de la organización > Claves de agente.