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 en tiempo real y monitorear builds, 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 API — Genera una clave desde el panel y pégala en la configuración de tu agente.

---

Método 1: OAuth (Recomendado)

OAuth te permite conectarte con un solo clic: no hay clave API que copiar o gestionar.

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 Customize > Connectors > + > Add custom connector.
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 Settings > Tools & MCP.
2. Haz clic en Add Custom MCP.
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 MCP Servers > Manage MCP Servers.
2. Haz clic en View raw config 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 Refresh. Antigravity abrirá un navegador para que inicies sesión y apruebes el acceso.

---

Método 2: Clave API

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

Paso 1: Genera una clave API

1. Ve a Organization Settings > Agent Keys en tu panel de deployment.io.
2. Haz clic en Create New Key y asígnale un nombre descriptivo (p. ej., "Claude Code Key").
3. Copia la clave API de inmediato: no podrás volver a verla.

Paso 2: Copia 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 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 Settings > Tools & MCP.
2. Haz clic en Add Custom MCP.
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 Settings > MCP.
2. Haz clic en Add Server 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

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

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

1. Haz clic en Refresh y reinicia Antigravity.

---

Solución de problemas

• Verifica que tu conexión funcione: Ejecuta un prompt simple como "lista mis entornos" en tu agente. Si la conexión funciona, verás tus entornos listados.
• Comprueba 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 API si es necesario.
• Regenera la clave: Si tu clave API deja de funcionar, es posible que haya sido revocada. Crea una nueva desde la página de configuración de Agent Keys.
• Revoca el acceso: Puedes revocar agentes conectados por OAuth o claves API en cualquier momento desde Organization Settings > Agent Keys.

Requisitos previos y Solución de problemasHerramientas MCP disponibles