MCP DigitalOcean Integration

Gerencie recursos da DigitalOcean e execute ações usando a API da DigitalOcean.

Documentação

Integração MCP DigitalOcean

A Integração MCP DigitalOcean é um projeto de código aberto que fornece uma interface abrangente para gerenciar recursos da DigitalOcean e executar ações usando a API DigitalOcean. Construído sobre a biblioteca godo e o framework MCP, este projeto expõe uma ampla gama de ferramentas para simplificar o gerenciamento de infraestrutura em nuvem.

AVISO: "O uso da tecnologia MCP para interagir com sua conta DigitalOcean pode apresentar riscos"

Autenticação

Os servidores MCP hospedados (remotos) suportam duas formas de autenticação:

OAuth 2.0 (recomendado). Basta adicionar a URL do servidor — sem cabeçalho Authorization. Seu cliente abre um navegador para você entrar na DigitalOcean no primeiro uso, então não há token para criar, armazenar ou rotacionar. Clientes compatíveis (ex.: Claude e Cursor recentes) lidam com isso automaticamente, e você pode pular as Etapas 1–2 abaixo.
Token de API. Para instalações locais ou clientes sem suporte a OAuth, use um token de acesso pessoal da DigitalOcean via cabeçalho Authorization: Bearer (remoto) ou a variável de ambiente DIGITALOCEAN_API_TOKEN (local). Veja as Etapas 1–2 abaixo.

Segurança: Nunca Codifique Seu Token de API

AVISO: NÃO cole seu token de API da DigitalOcean diretamente em nenhum arquivo de configuração (ex.: claude_desktop_config.json, ~/.cursor/config.json, configurações do VS Code). Se você enviar esses arquivos para o GitHub, seu token será exposto e o GitHub bloqueará ou revogará automaticamente para proteger sua conta.

A abordagem segura é armazenar seu token em uma variável de ambiente na sua máquina e referenciá-lo a partir do arquivo de configuração. Siga as etapas abaixo para o seu sistema operacional antes de prosseguir com qualquer instalação de cliente.

Etapa 1: Configure Seu Token de API como Variável de Ambiente

macOS / Linux

Opção A: Defina no seu perfil de shell (Recomendado — persiste entre reinicializações)

Abra um terminal.
Determine qual shell você está usando:
```
echo $SHELL
```
- Se exibir /bin/zsh → edite ~/.zshrc
- Se exibir /bin/bash → edite ~/.bashrc ou ~/.bash_profile

Abra o arquivo em um editor de texto:

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

# For bash
nano ~/.bashrc

Adicione a seguinte linha no final do arquivo:
```
export DIGITALOCEAN_API_TOKEN="your_actual_token_here"
```
Substitua your_actual_token_here pelo seu token real da página de Tokens de API da DigitalOcean.
Salve e saia:
- No nano: pressione Ctrl + O, depois Enter para salvar, e Ctrl + X para sair.
Recarregue seu shell para aplicar a alteração:
```
source ~/.zshrc    # or source ~/.bashrc
```
Verifique se foi definido corretamente:
```
echo $DIGITALOCEAN_API_TOKEN
```
Você deve ver seu token impresso no terminal.

Opção B: Use um arquivo `.env` (para isolamento em nível de projeto)

Na pasta raiz do seu projeto, crie um arquivo .env:
```
touch .env
```

Abra-o e adicione:

DIGITALOCEAN_API_TOKEN=your_actual_token_here

Imediatamente adicione .env ao seu .gitignore para que nunca seja enviado:
```
echo ".env" >> .gitignore
```
Para carregar o arquivo .env na sua sessão de terminal atual:
```
export $(grep -v '^#' .env | xargs)
```
Verifique:
```
echo $DIGITALOCEAN_API_TOKEN
```

Nota: A Opção B define a variável apenas para a sessão de terminal atual. Você precisa executar a etapa 4 cada vez que abrir um novo terminal. Para uma solução permanente, use a Opção A.

Windows

Opção A: Defina como Variável de Ambiente do Sistema (Recomendado — persiste entre reinicializações)

Abra o Menu Iniciar e pesquise por "Variáveis de Ambiente".
Clique em "Editar as variáveis de ambiente do sistema".
Na caixa de diálogo Propriedades do Sistema, clique no botão "Variáveis de Ambiente...".
Em "Variáveis do usuário", clique em "Nova...".
Preencha:
- Nome da variável: DIGITALOCEAN_API_TOKEN
- Valor da variável: your_actual_token_here
Clique em OK em todas as caixas de diálogo para salvar.
Reinicie seu terminal (Prompt de Comando ou PowerShell) para que a alteração tenha efeito.

Verifique no PowerShell:

echo $env:DIGITALOCEAN_API_TOKEN

Ou no Prompt de Comando:

echo %DIGITALOCEAN_API_TOKEN%

Opção B: Defina temporariamente no PowerShell (apenas na sessão atual)

$env:DIGITALOCEAN_API_TOKEN = "your_actual_token_here"

Opção C: Use um arquivo `.env` no Windows

Na pasta do seu projeto, crie um arquivo chamado .env (sem extensão) com este conteúdo:
```
DIGITALOCEAN_API_TOKEN=your_actual_token_here
```
Adicione .env ao seu .gitignore:
```
.env
```

Para carregá-lo no PowerShell:

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

Verifique:
```
echo $env:DIGITALOCEAN_API_TOKEN
```

Etapa 2: Obtenha Seu Token de API da DigitalOcean

Entre na sua conta DigitalOcean.
Navegue até API → Tokens na barra lateral esquerda, ou vá diretamente para: https://cloud.digitalocean.com/account/api/tokens
Clique em "Gerar Novo Token".
Dê um nome (ex.: mcp-local-dev), defina a expiração e escolha os escopos necessários.
Copie o token imediatamente — ele será exibido apenas uma vez.
Armazene-o usando um dos métodos descritos na Etapa 1 acima.

Instalação

MCP Remoto (Recomendado)

A maneira mais fácil de começar é usar os serviços MCP hospedados da DigitalOcean. Cada serviço é implantado como um servidor MCP independente acessível via HTTPS, permitindo que você se conecte sem executar nenhum servidor local. Você pode conectar-se a vários endpoints simultaneamente adicionando várias entradas à sua configuração.

Esses servidores suportam OAuth 2.0 (recomendado) e autenticação por token de API — veja Autenticação. Cada seção de cliente abaixo mostra ambas as opções.

Serviços Disponíveis

Serviço	URL MCP Remota	Descrição
apps	https://apps.mcp.digitalocean.com/mcp	Gerencie aplicativos da Plataforma de Apps da DigitalOcean, incluindo implantações e configurações.
accounts	https://accounts.mcp.digitalocean.com/mcp	Obtenha informações sobre sua conta DigitalOcean, cobrança, saldo, faturas e chaves SSH.
databases	https://databases.mcp.digitalocean.com/mcp	Provisione, gerencie e monitore clusters de bancos de dados gerenciados (Postgres, MySQL, Redis, etc.).
doks	https://doks.mcp.digitalocean.com/mcp	Gerencie clusters Kubernetes e pools de nós da DigitalOcean.
droplets	https://droplets.mcp.digitalocean.com/mcp	Crie, gerencie, redimensione, faça snapshots e monitore droplets (máquinas virtuais) na DigitalOcean.
microvms	https://microvms.mcp.digitalocean.com/mcp	Crie, liste, obtenha, pause, retome, faça checkpoint e exclua MicroVMs da DigitalOcean.
docr	https://docr.mcp.digitalocean.com/mcp	Gerencie repositórios, tags, manifestos e coleta de lixo do Registro de Contêineres da DigitalOcean.
genai-batchinference	https://genai-batchinference.mcp.digitalocean.com/mcp	Crie, gerencie e monitore trabalhos de inferência em lote para processamento assíncrono de IA em massa.
signals	https://signals.mcp.digitalocean.com/mcp	Investigue sessões, segmentos e consentimento de inferência do agente Gradient e serverless para DigitalOcean Signals.
harness-runtime	https://harness-runtime.mcp.digitalocean.com/mcp	Liste e inspecione configurações de agentes hospedados para o DigitalOcean Harness Runtime.
genai-custom-models	https://genai-custom-models.mcp.digitalocean.com/mcp	Importe, liste, atualize e exclua modelos personalizados (traga o seu próprio) na plataforma GenAI da DigitalOcean.
genai-inferencerouter	https://genai-inferencerouter.mcp.digitalocean.com/mcp	Crie, liste, obtenha e exclua roteadores de modelos GenAI.
dedicated-inference	https://dedicated-inference.mcp.digitalocean.com/mcp	Gerencie instâncias de Inferência Dedicada para servir modelos acelerados por GPU.
inference-modelcatalog	https://inference-modelcatalog.mcp.digitalocean.com/mcp	Navegue pelo catálogo de modelos de Inferência da DigitalOcean, pesquise modelos e obtenha fichas de modelos.
insights	https://insights.mcp.digitalocean.com/mcp	Monitore seus recursos e endpoints e alerte quando estiverem lentos, indisponíveis ou com certificados SSL expirando.
marketplace	https://marketplace.mcp.digitalocean.com/mcp	Descubra e gerencie aplicativos do Marketplace da DigitalOcean.
networking	https://networking.mcp.digitalocean.com/mcp	Gerencie domínios, registros DNS, certificados, firewalls, balanceadores de carga, IPs reservados, prefixos BYOIP, VPCs e CDNs.
functions	https://functions.mcp.digitalocean.com/mcp	Gerencie namespaces, ações, pacotes, gatilhos e ativações de funções serverless.
spaces	https://spaces.mcp.digitalocean.com/mcp	Armazenamento de objetos Spaces da DigitalOcean e chaves de acesso Spaces para armazenamento compatível com S3.
docs	https://docs.mcp.digitalocean.com/mcp	Pesquise e recupere documentação pública da DigitalOcean. Nenhum token de API necessário.
genai-evaluation	https://genai-evaluation.mcp.digitalocean.com/mcp	Gerencie e execute fluxos de trabalho de avaliação na plataforma GenAI da DigitalOcean.
nfs	https://nfs.mcp.digitalocean.com/mcp	Gerencie compartilhamentos de arquivos NFS e snapshots de compartilhamentos de arquivos da DigitalOcean.
volumes	https://volumes.mcp.digitalocean.com/mcp	Gerencie volumes de armazenamento em bloco e snapshots de volumes da DigitalOcean.
vector-databases	https://vector-databases.mcp.digitalocean.com/mcp	Crie, liste, redimensione, exclua e inspecione clusters de banco de dados vetorial Weaviate gerenciados.

Claude Code

MCP Remoto (Recomendado)

Opção A — OAuth (recomendado). Adicione o servidor sem cabeçalho Authorization; o Claude solicita que você entre no primeiro uso:

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

Opção B — Token de API. Certifique-se de ter concluído a Etapa 1 e que sua variável de ambiente DIGITALOCEAN_API_TOKEN esteja definida. Em seguida, execute:

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

Como funciona: O $DIGITALOCEAN_API_TOKEN é expandido pelo seu shell no momento em que você executa o comando. O valor real do token é armazenado com segurança na configuração do Claude — você nunca cola o token no comando.

Você pode adicionar vários serviços da mesma forma:

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"

Veja a seção Serviços Disponíveis para a lista completa de endpoints disponíveis.

Instalação Local

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

Isso irá:

Adicionar o servidor MCP no escopo padrão (local) — ou seja, estará disponível apenas dentro da pasta atual.
Registrá-lo com o nome digitalocean-mcp.
Habilitar os serviços apps e databases.
Passar seu token de API da DigitalOcean com segurança para o servidor via variável de ambiente.
Armazenar a configuração na sua configuração global do Claude em ~/.claude.json, com escopo para a pasta atual.

Verificar Instalação

Para confirmar que foi adicionado:

claude mcp list

Inspecionar Detalhes

Para inspecionar detalhes:

claude mcp get digitalocean-mcp

Remover Servidor

Para removê-lo:

claude mcp remove digitalocean-mcp

Escopo do Usuário

O escopo local é ótimo quando você está testando ou usando o servidor apenas em um projeto. O escopo do usuário é melhor se você quiser que ele esteja disponível em todos os lugares.

Se você quiser disponibilizar o servidor globalmente (para não precisar adicioná-lo novamente em cada projeto), você pode usar o escopo user:

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

Isso irá:

Disponibilizar o servidor em todas as pastas, não apenas naquela em que você está
Definir o escopo para sua conta de usuário
Armazená-lo na sua configuração global do Claude em ~/.claude.json

Para removê-lo:

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

Claude Desktop

MCP Remoto (Recomendado)

Antes de editar o arquivo de configuração, certifique-se de que DIGITALOCEAN_API_TOKEN esteja definido no seu perfil de shell (veja a Etapa 1 — Opção A). O Claude Desktop lê as variáveis de ambiente do seu perfil de shell na inicialização.

O arquivo de configuração está localizado em:

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

Opção A — OAuth (recomendado). O Claude Desktop se conecta a servidores remotos por meio do bridge mcp-remote, que abre um navegador para você fazer login na DigitalOcean no primeiro uso:

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

Opção B — Token de API. Adicione os servidores MCP remotos ao seu arquivo de configuração. Referencie a variável de ambiente usando ${DIGITALOCEAN_API_TOKEN} — o Claude Desktop a substituirá em tempo de execução:

{
  "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: A sintaxe ${DIGITALOCEAN_API_TOKEN} informa ao Claude Desktop para ler o valor das variáveis de ambiente do seu sistema. Seu token real nunca é gravado neste arquivo. Este arquivo é seguro para ser commitado no controle de versão.

Você pode adicionar qualquer um dos endpoints listados na seção Available Services.

Instalação Local

Adicione o seguinte ao seu arquivo claude_desktop_config.json. O bloco env passa a variável de ambiente diretamente para o processo do servidor MCP — sem necessidade de token codificado:

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

Como isso funciona: O bloco "env" na configuração do Claude Desktop passa variáveis de ambiente para o processo do servidor MCP iniciado. O valor ${DIGITALOCEAN_API_TOKEN} é resolvido a partir do ambiente do seu sistema em tempo de execução. Seu token nunca é armazenado no próprio arquivo de configuração.

Após salvar o arquivo, reinicie o Claude Desktop para que as alterações tenham efeito.

Cursor

MCP Remoto (Recomendado)

Antes de editar o arquivo de configuração, certifique-se de que DIGITALOCEAN_API_TOKEN esteja definido no seu perfil de shell (veja a Etapa 1 — Opção A).

O arquivo de configuração do Cursor está localizado em:

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

Opção A — OAuth (recomendado). Adicione apenas a URL sem bloco headers; o Cursor solicitará que você faça login no primeiro uso:

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

Opção B — Token de API. Adicione os servidores MCP remotos ao arquivo de configurações do 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}"
      }
    }
  }
}

Você pode adicionar qualquer um dos endpoints listados na seção Available Services.

Instalação Local

Adicione o seguinte ao arquivo de configurações do Cursor localizado em ~/.cursor/config.json:

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

Como isso funciona: O Cursor resolve ${DIGITALOCEAN_API_TOKEN} a partir das variáveis de ambiente do seu sistema ao iniciar o servidor MCP. Certifique-se de que a variável esteja definida no seu perfil de shell antes de iniciar o Cursor.

Verificar Instalação

Abra o Cursor e abra a Paleta de Comandos (Shift + ⌘ + P no Mac ou Ctrl + Shift + P no Windows/Linux)
Pesquise por "MCP" na barra de pesquisa da paleta de comandos
Selecione "View: Open MCP Settings"
Selecione "Tools & Integrations" na barra lateral esquerda
Você deve ver "digitalocean" listado em Available MCP Servers
Clique em "N tools enabled" (N é o número de ferramentas atualmente habilitadas)

Depuração

Para verificar os logs do servidor MCP e depurar problemas:

Abra a Paleta de Comandos (⌘+Shift+P no Mac ou Ctrl+Shift+P no Windows/Linux)
Digite "Developer: Toggle Developer Tools" e pressione Enter
Navegue até a aba Console para visualizar os logs do servidor MCP
Você encontrará logs relacionados ao MCP ao interagir com o servidor MCP

Testando a Conexão

No chat do Cursor, tente perguntar: "List all my DigitalOcean apps" — isso deve acionar o servidor MCP para buscar seus apps se estiver configurado corretamente. Se você estiver recebendo um erro 401 ou erros relacionados à autenticação, verifique se a variável DIGITALOCEAN_API_TOKEN está definida corretamente executando echo $DIGITALOCEAN_API_TOKEN no seu terminal.

VS Code

MCP Remoto (Recomendado)

Antes de editar o arquivo de configuração, certifique-se de que DIGITALOCEAN_API_TOKEN esteja definido no seu perfil de shell (veja a Etapa 1 — Opção A).

O arquivo de configuração MCP do VS Code está localizado em .vscode/mcp.json na raiz do seu workspace. Crie este arquivo se ele não existir.

Opção A — OAuth (recomendado). Adicione apenas a URL sem bloco headers; o VS Code solicitará que você faça login no primeiro uso:

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

Opção B — Token de API. Adicione os servidores MCP remotos, usando o recurso inputs do VS Code para solicitar o token com segurança:

{
  "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}"
      }
    }
  }
}

Como funcionam os inputs do VS Code: O bloco inputs define um input nomeado (digitalocean-token) que o VS Code solicitará que você insira com segurança na primeira vez que usar o servidor. Seu token é armazenado no armazenamento secreto do VS Code — nunca gravado em disco em texto simples. O sinalizador "password": true garante que ele seja mascarado durante a entrada. Este arquivo de configuração é completamente seguro para commit no GitHub.

Alternativamente, se você preferir usar uma variável de ambiente do sistema diretamente:

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

Nota: O VS Code usa a sintaxe ${env:VARIABLE_NAME} para ler variáveis de ambiente do sistema.

Instalação Local

Adicione o seguinte ao seu arquivo .vscode/mcp.json. Use o recurso inputs do VS Code para evitar codificar o 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}"
      }
    }
  }
}

Ou, para usar uma variável de ambiente do sistema diretamente:

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

Verificar Instalação

Abra o VS Code e abra a Paleta de Comandos (Shift + ⌘ + P no Mac ou Ctrl + Shift + P no Windows/Linux)
Pesquise por "MCP" na barra de pesquisa da paleta de comandos
Selecione "MCP: List Servers"
Verifique se "mcpDigitalOcean" aparece na lista de servidores configurados

Visualizando Ferramentas Disponíveis

Para ver quais ferramentas estão disponíveis no servidor MCP:

Abra a Paleta de Comandos (⌘+Shift+P no Mac ou Ctrl+Shift+P no Windows/Linux)
Selecione o modo "Agent" na caixa de chat
Clique em "Configure tools" à direita e verifique as ferramentas relacionadas à DigitalOcean em MCP Server: mcpDigitalocean. Você deve conseguir listar ferramentas disponíveis como app-create, app-list, app-delete, etc.

Depuração

Para solucionar problemas de conexão MCP:

Abra a Paleta de Comandos (⌘+Shift+P no Mac ou Ctrl+Shift+P no Windows/Linux)
Digite "Developer: Toggle Developer Tools" e pressione Enter
Navegue até a aba Console para visualizar os logs do servidor MCP
Verifique o status da conexão e mensagens de erro

Se você estiver recebendo um erro 401 ou erros relacionados à autenticação, verifique se a variável DIGITALOCEAN_API_TOKEN está definida executando echo $DIGITALOCEAN_API_TOKEN no seu terminal antes de iniciar o VS Code.

Etapa 3: Proteja Seu Token — Checklist

Antes de enviar qualquer código para o GitHub, verifique o seguinte:

Seu arquivo .env (se usado) está listado em .gitignore
Nenhum arquivo de configuração contém uma string de token bruta como dop_v1_...
Os arquivos de configuração usam a sintaxe ${DIGITALOCEAN_API_TOKEN}, ${env:DIGITALOCEAN_API_TOKEN} ou ${input:...}
Você executou git diff ou git status para confirmar que nenhum segredo está preparado
Você nunca commitou um token — se tiver, rotacione-o imediatamente e revogue o antigo

Se seu token já foi commitado: Vá para a página de Tokens de API da DigitalOcean, exclua o token comprometido e gere um novo. A varredura de segredos do GitHub detectará e sinalizará tokens expostos automaticamente.

Pré-requisitos para Instalação Local

Se você estiver usando o método de instalação local (não MCP Remoto), precisará de:

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

Você pode encontrar guias de instalação em https://nodejs.org/en/download

Verifique sua instalação:

node --version
npm --version

Teste Rápido

Para verificar se o servidor MCP local funciona corretamente, você pode testá-lo diretamente da linha de comando (certifique-se de que DIGITALOCEAN_API_TOKEN esteja definido no seu ambiente primeiro):

npx @digitalocean/mcp --services apps

Configuração

Configuração da Instalação Local

Ao usar a instalação local, você usa o sinalizador --services para especificar qual serviço deseja habilitar. É altamente recomendável habilitar apenas os serviços que você precisa para reduzir o tamanho do contexto e melhorar a precisão. Veja a lista de serviços suportados abaixo.

npx @digitalocean/mcp --services apps,droplets

Documentação

Cada serviço fornece um README detalhado descrevendo todas as ferramentas disponíveis, recursos, argumentos e consultas de exemplo. Veja os seguintes arquivos para documentação completa:

Exemplos de Ferramentas

Pesquisar modelos de catálogo por nome: inference-model-catalog-search
Abrir metadados completos de um modelo de catálogo: inference-model-catalog-get-card
Implantar um app a partir de um repositório GitHub: create-app-from-spec
Redimensionar um droplet: droplet-resize
Executar um comando em uma MicroVM: microvm-exec
Adicionar uma nova chave SSH: key-create
Criar um novo domínio: domain-create
Habilitar backups em um droplet: droplet-enable-backups
Limpar o cache de um CDN: cdn-flush-cache
Criar uma conexão de peering VPC: vpc-peering-create
Excluir uma conexão de peering VPC: vpc-peering-delete
Pesquisar documentação da DigitalOcean: docs-search
Obter um guia de início rápido para um serviço: docs-get-quickstart
Encontrar documentação de solução de problemas para um erro: docs-troubleshoot
Descobrir páginas relacionadas a uma página de documentação: docs-get-related

Contribuindo

Contribuições são bem-vindas! Se você encontrar algum problema ou tiver ideias para melhorias, sinta-se à vontade para abrir uma issue ou enviar um pull request.

Faça um fork do repositório.
Crie um novo branch para sua funcionalidade ou correção de bug.
Envie um pull request com uma descrição clara das suas alterações.

Licença

Este projeto é licenciado sob a Licença MIT. Veja o arquivo LICENSE para detalhes.

MCP DigitalOcean Integration

Documentação

Integração MCP DigitalOcean

Autenticação

Segurança: Nunca Codifique Seu Token de API

Etapa 1: Configure Seu Token de API como Variável de Ambiente

macOS / Linux

Opção A: Defina no seu perfil de shell (Recomendado — persiste entre reinicializações)

Opção B: Use um arquivo .env (para isolamento em nível de projeto)

Windows

Opção A: Defina como Variável de Ambiente do Sistema (Recomendado — persiste entre reinicializações)

Opção B: Defina temporariamente no PowerShell (apenas na sessão atual)

Opção C: Use um arquivo .env no Windows

Etapa 2: Obtenha Seu Token de API da DigitalOcean

Instalação

MCP Remoto (Recomendado)

Serviços Disponíveis

Claude Code

MCP Remoto (Recomendado)

Instalação Local

Verificar Instalação

Inspecionar Detalhes

Remover Servidor

Escopo do Usuário

Claude Desktop

MCP Remoto (Recomendado)

Instalação Local

Cursor

MCP Remoto (Recomendado)

Instalação Local

Verificar Instalação

Depuração

Testando a Conexão

VS Code

MCP Remoto (Recomendado)

Instalação Local

Verificar Instalação

Visualizando Ferramentas Disponíveis

Depuração

Etapa 3: Proteja Seu Token — Checklist

Pré-requisitos para Instalação Local

Teste Rápido

Configuração

Configuração da Instalação Local

Documentação

Exemplos de Ferramentas

Contribuindo

Licença

Opção B: Use um arquivo `.env` (para isolamento em nível de projeto)

Opção C: Use um arquivo `.env` no Windows