MCP DigitalOcean Integration

Gestiona recursos de DigitalOcean y realiza acciones utilizando la API de DigitalOcean.

Documentación

MCP DigitalOcean Integration

MCP DigitalOcean Integration es un proyecto de código abierto que proporciona una interfaz integral para gestionar recursos de DigitalOcean y realizar acciones utilizando la API de DigitalOcean. Construido sobre la biblioteca godo y el marco MCP, este proyecto expone una amplia gama de herramientas para simplificar la gestión de infraestructura en la nube.

AVISO: "El uso de la tecnología MCP para interactuar con tu cuenta de DigitalOcean puede conllevar riesgos"

Autenticación

Los servidores MCP alojados (remotos) admiten dos formas de autenticación:

OAuth 2.0 (recomendado). Simplemente agrega la URL del servidor — sin encabezado Authorization. Tu cliente abrirá un navegador para iniciar sesión en DigitalOcean en el primer uso, por lo que no hay token que crear, almacenar o rotar. Los clientes compatibles (por ejemplo, Claude y Cursor recientes) manejan esto automáticamente, y puedes omitir los Pasos 1–2 a continuación.
Token de API. Para instalaciones locales o clientes sin soporte OAuth, usa un token de acceso personal de DigitalOcean mediante un encabezado Authorization: Bearer (remoto) o la variable de entorno DIGITALOCEAN_API_TOKEN (local). Consulta los Pasos 1–2 a continuación.

Seguridad: Nunca Codifiques Tu Token de API

ADVERTENCIA: NO pegues tu token de API de DigitalOcean directamente en ningún archivo de configuración (por ejemplo, claude_desktop_config.json, ~/.cursor/config.json, configuración de VS Code). Si confirmas estos archivos en GitHub, tu token quedará expuesto y GitHub lo bloqueará o revocará automáticamente para proteger tu cuenta.

El enfoque seguro es almacenar tu token en una variable de entorno en tu máquina y hacer referencia a él desde tu archivo de configuración. Sigue los pasos a continuación para tu sistema operativo antes de continuar con cualquier instalación de cliente.

Paso 1: Configura Tu Token de API como Variable de Entorno

macOS / Linux

Opción A: Configúralo en tu perfil de shell (Recomendado — persiste entre reinicios)

Abre una terminal.
Determina qué shell estás usando:
```
echo $SHELL
```
- Si muestra /bin/zsh → edita ~/.zshrc
- Si muestra /bin/bash → edita ~/.bashrc o ~/.bash_profile

Abre el archivo en un editor de texto:

# For zsh (default on macOS Monterey and later)
nano ~/.zshrc

# For bash
nano ~/.bashrc

Agrega la siguiente línea al final del archivo:
```
export DIGITALOCEAN_API_TOKEN="your_actual_token_here"
```
Reemplaza your_actual_token_here con tu token real de la página de Tokens de API de DigitalOcean.
Guarda y sal:
- En nano: presiona Ctrl + O, luego Enter para guardar, y luego Ctrl + X para salir.

Recarga tu shell para aplicar el cambio:

source ~/.zshrc    # or source ~/.bashrc

Verifica que esté configurado correctamente:
```
echo $DIGITALOCEAN_API_TOKEN
```
Deberías ver tu token impreso en la terminal.

Opción B: Usa un archivo `.env` (para aislamiento a nivel de proyecto)

En la carpeta raíz de tu proyecto, crea un archivo .env:
```
touch .env
```

Ábrelo y agrega:

DIGITALOCEAN_API_TOKEN=your_actual_token_here

Inmediatamente agrega .env a tu .gitignore para que nunca se confirme:
```
echo ".env" >> .gitignore
```
Para cargar el archivo .env en tu sesión de terminal actual:
```
export $(grep -v '^#' .env | xargs)
```
Verifica:
```
echo $DIGITALOCEAN_API_TOKEN
```

Nota: La Opción B solo establece la variable para la sesión de terminal actual. Debes ejecutar el paso 4 cada vez que abras una nueva terminal. Para una solución permanente, usa la Opción A.

Windows

Opción A: Configúrala como Variable de Entorno del Sistema (Recomendado — persiste entre reinicios)

Abre el Menú Inicio y busca "Variables de Entorno".
Haz clic en "Editar las variables de entorno del sistema".
En el diálogo de Propiedades del Sistema, haz clic en el botón "Variables de Entorno...".
Bajo "Variables de usuario", haz clic en "Nueva...".
Completa:
- Nombre de la variable: DIGITALOCEAN_API_TOKEN
- Valor de la variable: your_actual_token_here
Haz clic en Aceptar en todos los diálogos para guardar.
Reinicia tu terminal (Símbolo del sistema o PowerShell) para que el cambio surta efecto.

Verifica en PowerShell:

echo $env:DIGITALOCEAN_API_TOKEN

O en el Símbolo del sistema:

echo %DIGITALOCEAN_API_TOKEN%

Opción B: Configúrala temporalmente en PowerShell (solo sesión actual)

$env:DIGITALOCEAN_API_TOKEN = "your_actual_token_here"

Opción C: Usa un archivo `.env` en Windows

En tu carpeta de proyecto, crea un archivo llamado .env (sin extensión) con este contenido:
```
DIGITALOCEAN_API_TOKEN=your_actual_token_here
```
Agrega .env a tu .gitignore:
```
.env
```

Para cargarlo en PowerShell:

Get-Content .env | ForEach-Object {
  if ($_ -match "^\s*([^#][^=]*)=(.*)$") {
    [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), "Process")
  }
}

Verifica:
```
echo $env:DIGITALOCEAN_API_TOKEN
```

Paso 2: Obtén Tu Token de API de DigitalOcean

Inicia sesión en tu cuenta de DigitalOcean.
Navega a API → Tokens en la barra lateral izquierda, o ve directamente a: https://cloud.digitalocean.com/account/api/tokens
Haz clic en "Generar Nuevo Token".
Asígnale un nombre (por ejemplo, mcp-local-dev), establece la caducidad y elige los alcances requeridos.
Copia el token inmediatamente — solo se mostrará una vez.
Almacénalo usando uno de los métodos descritos en el Paso 1 anterior.

Instalación

MCP Remoto (Recomendado)

La forma más fácil de comenzar es usar los servicios MCP alojados de DigitalOcean. Cada servicio se implementa como un servidor MCP independiente accesible a través de HTTPS, lo que te permite conectarte sin ejecutar ningún servidor local. Puedes conectarte a múltiples endpoints simultáneamente agregando múltiples entradas a tu configuración.

Estos servidores admiten OAuth 2.0 (recomendado) y autenticación por token de API — consulta Autenticación. Cada sección de cliente a continuación muestra ambas opciones.

Servicios Disponibles

Servicio	URL MCP Remota	Descripción
apps	https://apps.mcp.digitalocean.com/mcp	Gestiona aplicaciones de la Plataforma de Apps de DigitalOcean, incluyendo implementaciones y configuraciones.
accounts	https://accounts.mcp.digitalocean.com/mcp	Obtén información sobre tu cuenta de DigitalOcean, facturación, saldo, facturas y claves SSH.
databases	https://databases.mcp.digitalocean.com/mcp	Aprovisiona, gestiona y monitorea clústeres de bases de datos gestionadas (Postgres, MySQL, Redis, etc.).
doks	https://doks.mcp.digitalocean.com/mcp	Gestiona clústeres de Kubernetes y grupos de nodos de DigitalOcean.
droplets	https://droplets.mcp.digitalocean.com/mcp	Crea, gestiona, redimensiona, crea instantáneas y monitorea droplets (máquinas virtuales) en DigitalOcean.
microvms	https://microvms.mcp.digitalocean.com/mcp	Crea, lista, obtén, pausa, reanuda, crea puntos de control y elimina MicroVMs de DigitalOcean.
docr	https://docr.mcp.digitalocean.com/mcp	Gestiona repositorios, etiquetas, manifiestos y recolección de basura del Registro de Contenedores de DigitalOcean.
genai-batchinference	https://genai-batchinference.mcp.digitalocean.com/mcp	Crea, gestiona y monitorea trabajos de inferencia por lotes para procesamiento masivo de IA asíncrono.
signals	https://signals.mcp.digitalocean.com/mcp	Investiga sesiones, segmentos y consentimiento de inferencia de agentes Gradient y sin servidor para DigitalOcean Signals.
harness-runtime	https://harness-runtime.mcp.digitalocean.com/mcp	Lista e inspecciona configuraciones de agentes alojados para DigitalOcean Harness Runtime.
genai-custom-models	https://genai-custom-models.mcp.digitalocean.com/mcp	Importa, lista, actualiza y elimina modelos personalizados (trae el tuyo) en la plataforma GenAI de DigitalOcean.
genai-inferencerouter	https://genai-inferencerouter.mcp.digitalocean.com/mcp	Crea, lista, obtén y elimina enrutadores de modelos GenAI.
dedicated-inference	https://dedicated-inference.mcp.digitalocean.com/mcp	Gestiona instancias de Inferencia Dedicada para el servicio de modelos acelerados por GPU.
inference-modelcatalog	https://inference-modelcatalog.mcp.digitalocean.com/mcp	Explora el catálogo de modelos de Inferencia de DigitalOcean, busca modelos y obtén tarjetas de modelos.
insights	https://insights.mcp.digitalocean.com/mcp	Monitorea tus recursos y endpoints y te alerta cuando están lentos, no disponibles o los certificados SSL están por expirar.
marketplace	https://marketplace.mcp.digitalocean.com/mcp	Descubre y gestiona aplicaciones del Marketplace de DigitalOcean.
networking	https://networking.mcp.digitalocean.com/mcp	Gestiona dominios, registros DNS, certificados, firewalls, balanceadores de carga, IPs reservadas, prefijos BYOIP, VPCs y CDNs.
functions	https://functions.mcp.digitalocean.com/mcp	Gestiona espacios de nombres, acciones, paquetes, disparadores y activaciones de funciones sin servidor.
spaces	https://spaces.mcp.digitalocean.com/mcp	Almacenamiento de objetos de DigitalOcean Spaces y claves de acceso de Spaces para almacenamiento compatible con S3.
docs	https://docs.mcp.digitalocean.com/mcp	Busca y recupera documentación pública de DigitalOcean. No se requiere token de API.
genai-evaluation	https://genai-evaluation.mcp.digitalocean.com/mcp	Gestiona y ejecuta flujos de trabajo de evaluación en la plataforma GenAI de DigitalOcean.
nfs	https://nfs.mcp.digitalocean.com/mcp	Gestiona recursos compartidos de archivos NFS de DigitalOcean y sus instantáneas.
volumes	https://volumes.mcp.digitalocean.com/mcp	Gestiona volúmenes de almacenamiento en bloque de DigitalOcean y sus instantáneas.
vector-databases	https://vector-databases.mcp.digitalocean.com/mcp	Crea, lista, redimensiona, elimina e inspecciona clústeres de bases de datos vectoriales Weaviate gestionadas.

Claude Code

MCP Remoto (Recomendado)

Opción A — OAuth (recomendado). Agrega el servidor sin encabezado Authorization; Claude te pedirá iniciar sesión en el primer uso:

claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp

Opción B — Token de API. Asegúrate de haber completado el Paso 1 y de que tu variable de entorno DIGITALOCEAN_API_TOKEN esté configurada. Luego ejecuta:

claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"

Cómo funciona: El $DIGITALOCEAN_API_TOKEN es expandido por tu shell en el momento en que ejecutas el comando. El valor real del token se almacena de forma segura en la configuración de Claude — nunca pegas el token en el comando tú mismo.

Puedes agregar múltiples servicios de la misma manera:

claude mcp add --transport http digitalocean-databases https://databases.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"

claude mcp add --transport http digitalocean-droplets https://droplets.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"

Consulta la sección Servicios Disponibles para la lista completa de endpoints disponibles.

Instalación Local

claude mcp add digitalocean-mcp \
  -e DIGITALOCEAN_API_TOKEN=$DIGITALOCEAN_API_TOKEN \
  -- npx @digitalocean/mcp --services apps,databases

Esto:

Agregará el servidor MCP bajo el alcance predeterminado (local) — lo que significa que solo está disponible dentro de la carpeta actual.
Lo registrará con el nombre digitalocean-mcp.
Habilitará los servicios apps y databases.
Pasará tu token de API de DigitalOcean de forma segura al servidor mediante variable de entorno.
Almacenará la configuración en tu configuración global de Claude en ~/.claude.json, con alcance a la carpeta actual.

Verificar Instalación

Para confirmar que se ha agregado:

claude mcp list

Inspeccionar Detalles

Para inspeccionar detalles:

claude mcp get digitalocean-mcp

Eliminar Servidor

Para eliminarlo:

claude mcp remove digitalocean-mcp

Alcance de Usuario

El alcance local es excelente cuando estás probando o solo usas el servidor en un proyecto. El alcance de usuario es mejor si quieres que esté disponible en todas partes.

Si deseas que el servidor esté disponible globalmente (para no tener que volver a agregarlo en cada proyecto), puedes usar el alcance user:

claude mcp add -s user digitalocean-mcp-user-scope \
  -e DIGITALOCEAN_API_TOKEN=$DIGITALOCEAN_API_TOKEN \
  -- npx @digitalocean/mcp --services apps,databases

Esto:

Hará que el servidor esté disponible en todas las carpetas, no solo en la que estás
Lo limitará a tu cuenta de usuario
Lo almacenará en tu configuración global de Claude en ~/.claude.json

Para eliminarlo:

claude mcp remove -s user digitalocean-mcp-user-scope

Claude Desktop

MCP Remoto (Recomendado)

Antes de editar el archivo de configuración, asegúrate de que DIGITALOCEAN_API_TOKEN esté definido en el perfil de tu shell (consulta el Paso 1 — Opción A). Claude Desktop lee las variables de entorno desde tu perfil de shell al iniciarse.

El archivo de configuración se encuentra en:

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

Opción A — OAuth (recomendado). Claude Desktop se conecta a servidores remotos a través del puente mcp-remote, que abre un navegador para que inicies sesión en DigitalOcean en el primer uso:

{
  "mcpServers": {
    "digitalocean-apps": {
      "command": "npx",
      "args": ["mcp-remote", "https://apps.mcp.digitalocean.com/mcp"]
    }
  }
}

Opción B — Token de API. Agrega los servidores MCP remotos a tu archivo de configuración. Haz referencia a la variable de entorno usando ${DIGITALOCEAN_API_TOKEN} — Claude Desktop la sustituirá en tiempo de ejecución:

{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Importante: La sintaxis ${DIGITALOCEAN_API_TOKEN} le indica a Claude Desktop que lea el valor desde las variables de entorno de tu sistema. Tu token real nunca se escribe en este archivo. Este archivo es seguro para confirmar en el control de versiones.

Puedes agregar cualquiera de los endpoints enumerados en la sección Servicios Disponibles.

Instalación Local

Agrega lo siguiente a tu archivo claude_desktop_config.json. El bloque env pasa la variable de entorno directamente al proceso del servidor MCP — no se necesita token codificado:

{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Cómo funciona: El bloque "env" en la configuración de Claude Desktop pasa variables de entorno al proceso del servidor MCP generado. El valor ${DIGITALOCEAN_API_TOKEN} se resuelve desde el entorno de tu sistema en tiempo de ejecución. Tu token nunca se almacena en el archivo de configuración en sí.

Después de guardar el archivo, reinicia Claude Desktop para que los cambios surtan efecto.

Cursor

MCP Remoto (Recomendado)

Antes de editar el archivo de configuración, asegúrate de que DIGITALOCEAN_API_TOKEN esté definido en el perfil de tu shell (consulta el Paso 1 — Opción A).

El archivo de configuración de Cursor se encuentra en:

macOS / Linux: ~/.cursor/config.json
Windows: %USERPROFILE%\.cursor\config.json

Opción A — OAuth (recomendado). Agrega solo la URL sin bloque headers; Cursor te pedirá iniciar sesión en el primer uso:

{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp"
    }
  }
}

Opción B — Token de API. Agrega los servidores MCP remotos a tu archivo de configuración de Cursor:

{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Puedes agregar cualquiera de los endpoints enumerados en la sección Servicios Disponibles.

Instalación Local

Agrega lo siguiente a tu archivo de configuración de Cursor ubicado en ~/.cursor/config.json:

{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Cómo funciona: Cursor resuelve ${DIGITALOCEAN_API_TOKEN} desde las variables de entorno de tu sistema cuando inicia el servidor MCP. Asegúrate de que la variable esté definida en tu perfil de shell antes de iniciar Cursor.

Verificar Instalación

Abre Cursor y abre la Paleta de Comandos (Shift + ⌘ + P en Mac o Ctrl + Shift + P en Windows/Linux)
Busca "MCP" en la barra de búsqueda de la paleta de comandos
Selecciona "Ver: Abrir Configuración de MCP"
Selecciona "Herramientas e Integraciones" en la barra lateral izquierda
Deberías ver "digitalocean" listado bajo Servidores MCP Disponibles
Haz clic en "N herramientas habilitadas" (N es el número de herramientas actualmente habilitadas)

Depuración

Para verificar los registros del servidor MCP y depurar problemas:

Abre la Paleta de Comandos (⌘+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux)
Escribe "Desarrollador: Alternar Herramientas de Desarrollo" y presiona Enter
Navega a la pestaña Consola para ver los registros del servidor MCP
Encontrarás registros relacionados con MCP al interactuar con el servidor MCP

Probando la Conexión

En el chat de Cursor, intenta preguntar: "Lista todas mis aplicaciones de DigitalOcean" — esto debería activar el servidor MCP para obtener tus aplicaciones si está configurado correctamente. Si recibes un error 401 o errores relacionados con la autenticación, verifica que la variable DIGITALOCEAN_API_TOKEN esté configurada correctamente ejecutando echo $DIGITALOCEAN_API_TOKEN en tu terminal.

VS Code

MCP Remoto (Recomendado)

Antes de editar el archivo de configuración, asegúrate de que DIGITALOCEAN_API_TOKEN esté definido en el perfil de tu shell (consulta el Paso 1 — Opción A).

El archivo de configuración MCP de VS Code se encuentra en .vscode/mcp.json en la raíz de tu espacio de trabajo. Crea este archivo si no existe.

Opción A — OAuth (recomendado). Agrega solo la URL sin bloque headers; VS Code te pedirá iniciar sesión en el primer uso:

{
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp"
    }
  }
}

Opción B — Token de API. Agrega los servidores MCP remotos, usando la función inputs de VS Code para solicitar el token de forma segura:

{
  "inputs": [
    {
      "id": "digitalocean-token",
      "type": "promptString",
      "description": "DigitalOcean API Token",
      "password": true
    }
  ],
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:digitalocean-token}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:digitalocean-token}"
      }
    }
  }
}

Cómo funcionan las entradas de VS Code: El bloque inputs define una entrada nombrada (digitalocean-token) que VS Code te pedirá ingresar de forma segura la primera vez que uses el servidor. Tu token se almacena en el almacenamiento secreto de VS Code — nunca se escribe en disco en texto plano. La bandera "password": true asegura que esté enmascarada durante la entrada. Este archivo de configuración es completamente seguro para confirmar en GitHub.

Alternativamente, si prefieres usar una variable de entorno del sistema directamente:

{
  "inputs": [],
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Nota: VS Code usa la sintaxis ${env:VARIABLE_NAME} para leer desde las variables de entorno del sistema.

Instalación Local

Agrega lo siguiente a tu archivo .vscode/mcp.json. Usa la función inputs de VS Code para evitar codificar el token:

{
  "inputs": [
    {
      "id": "digitalocean-token",
      "type": "promptString",
      "description": "DigitalOcean API Token",
      "password": true
    }
  ],
  "servers": {
    "mcpDigitalOcean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${input:digitalocean-token}"
      }
    }
  }
}

O, para usar una variable de entorno del sistema directamente:

{
  "inputs": [],
  "servers": {
    "mcpDigitalOcean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${env:DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}

Verificar Instalación

Abre VS Code y abre la Paleta de Comandos (Shift + ⌘ + P en Mac o Ctrl + Shift + P en Windows/Linux)
Busca "MCP" en la barra de búsqueda de la paleta de comandos
Selecciona "MCP: Listar Servidores"
Verifica que "mcpDigitalOcean" aparezca en la lista de servidores configurados

Ver Herramientas Disponibles

Para ver qué herramientas están disponibles desde el servidor MCP:

Abre la Paleta de Comandos (⌘+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux)
Selecciona el modo "Agente" en el cuadro de chat
Haz clic en "Configurar herramientas" a la derecha y busca herramientas relacionadas con DigitalOcean bajo MCP Server: mcpDigitalocean. Deberías poder listar herramientas disponibles como app-create, app-list, app-delete, etc.

Depuración

Para solucionar problemas de conexión MCP:

Abre la Paleta de Comandos (⌘+Shift+P en Mac o Ctrl+Shift+P en Windows/Linux)
Escribe "Desarrollador: Alternar Herramientas de Desarrollo" y presiona Enter
Navega a la pestaña Consola para ver los registros del servidor MCP
Verifica el estado de la conexión y los mensajes de error

Si recibes un error 401 o errores relacionados con la autenticación, verifica que la variable DIGITALOCEAN_API_TOKEN esté configurada ejecutando echo $DIGITALOCEAN_API_TOKEN en tu terminal antes de iniciar VS Code.

Paso 3: Protege tu Token — Lista de Verificación

Antes de enviar cualquier código a GitHub, verifica lo siguiente:

Tu archivo .env (si se usa) está listado en .gitignore
Ningún archivo de configuración contiene una cadena de token sin procesar como dop_v1_...
Los archivos de configuración usan la sintaxis ${DIGITALOCEAN_API_TOKEN}, ${env:DIGITALOCEAN_API_TOKEN} o ${input:...}
Has ejecutado git diff o git status para confirmar que no hay secretos preparados
Nunca has confirmado un token — si lo has hecho, rótalo inmediatamente y revoca el anterior

Si tu token ya fue confirmado: Ve a la página de Tokens de API de DigitalOcean, elimina el token comprometido y genera uno nuevo. El escaneo de secretos de GitHub detectará y marcará automáticamente los tokens expuestos.

Requisitos Previos para la Instalación Local

Si estás usando el método de instalación local (no MCP Remoto), necesitarás:

Node.js (v18 o posterior)
NPM (v8 o posterior)

Puedes encontrar guías de instalación en https://nodejs.org/en/download

Verifica tu instalación:

node --version
npm --version

Prueba Rápida

Para verificar que el servidor MCP local funciona correctamente, puedes probarlo directamente desde la línea de comandos (asegúrate de que DIGITALOCEAN_API_TOKEN esté definido en tu entorno primero):

npx @digitalocean/mcp --services apps

Configuración

Configuración de Instalación Local

Al usar la instalación local, usas la bandera --services para especificar qué servicio deseas habilitar. Se recomienda encarecidamente habilitar solo los servicios que necesitas para reducir el tamaño del contexto y mejorar la precisión. Consulta la lista de servicios compatibles a continuación.

npx @digitalocean/mcp --services apps,droplets

Documentación

Cada servicio proporciona un README detallado que describe todas las herramientas disponibles, recursos, argumentos y consultas de ejemplo. Consulta los siguientes archivos para la documentación completa:

Herramientas de Ejemplo

Buscar modelos de catálogo por nombre: inference-model-catalog-search
Abrir metadatos completos para un modelo de catálogo: inference-model-catalog-get-card
Implementar una aplicación desde un repositorio de GitHub: create-app-from-spec
Redimensionar un droplet: droplet-resize
Ejecutar un comando en una MicroVM: microvm-exec
Agregar una nueva clave SSH: key-create
Crear un nuevo dominio: domain-create
Habilitar copias de seguridad en un droplet: droplet-enable-backups
Vaciar la caché de un CDN: cdn-flush-cache
Crear una conexión de emparejamiento VPC: vpc-peering-create
Eliminar una conexión de emparejamiento VPC: vpc-peering-delete
Buscar documentación de DigitalOcean: docs-search
Obtener una guía de inicio rápido para un servicio: docs-get-quickstart
Encontrar documentación de solución de problemas para un error: docs-troubleshoot
Descubrir páginas relacionadas con una página de documentación: docs-get-related

Contribuciones

¡Las contribuciones son bienvenidas! Si encuentras algún problema o tienes ideas para mejoras, no dudes en abrir un issue o enviar una solicitud de extracción.

Haz un fork del repositorio.
Crea una nueva rama para tu característica o corrección de errores.
Envía una solicitud de extracción con una descripción clara de tus cambios.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENCIA para más detalles.

MCP DigitalOcean Integration

Documentación