DigitalOcean
Administrér DigitalOcean Droplets, DNS, firewalls, volumes, VPC'er og load balancers via MCP. Forbind med OAuth eller et personal access token.
Overblik
Forbind DigitalOcean, så AI-klienter kan administrere din control plane: Droplets, DNS, firewalls, volumes, tags, projekter, snapshots, VPC'er, reserved IP'er og load balancers.
Integrationenen bruger DigitalOcean API v2 (https://api.digitalocean.com/v2). Autentificér med OAuth (Connect DigitalOcean), når det er konfigureret, eller indsæt et personal access token.
Forudsætninger
- En DigitalOcean-konto med API-adgang til det team, du vil administrere
- En stackgate.ai-konto
Sådan får du legitimationsoplysninger
Mulighed A — OAuth (anbefalet når tilgængelig)
- I stackgate.ai skal du åbne Mine integrationer → DigitalOcean.
- Klik på Connect DigitalOcean, og godkend adgang for det DigitalOcean-team, du vil bruge.
- Efter redirect er integrationen klar. Brug Edit tool access til at begrænse Read vs Write-værktøjer om nødvendigt.
Mulighed B — Personal access token
- Log ind i DigitalOcean Control Panel.
- Åbn API → Tokens, og klik på Generate New Token.
- Foretræk Custom Scopes, der matcher de værktøjer, du har brug for (fx
droplet:read,droplet:update,droplet:create,droplet:delete,domain:read,domain:create,firewall:read,block_storage:read). - Kopiér tokenet én gang (
dop_v1_…). - I stackgate.ai skal du åbne Mine integrationer → DigitalOcean, indsætte tokenet og aktivere.
Se DigitalOceans dokumentation om autentificering for scopes.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/digitaloceanmed et Sanctum bearer-token - Private gateway: én konfiguration til alle integrationer — brug
digitalocean__*-navngivne værktøjer
Nøgleværktøjer:
- list_droplets, get_droplet, create_droplet, delete-droplet-tool — Droplet-oversigt og livscyklus
- initiate_droplet_action — reboot, shutdown, power on/off, snapshots
- list-domains-tool, list-domain-records-tool, create-domain-record-tool — DNS
- list-firewalls-tool, list-volumes-tool, list-load-balancers-tool — netværk og lagring
Se Dokumentation for HTTP-autentificering og private gateway-opsætning.
Fejlfinding
- 422 integration not configured — forbind med OAuth, eller indsæt et personal access token under Mine integrationer.
- 401 Unauthorized — genforbind OAuth, eller generér et nyt personal access token.
- 403 Forbidden — tokenet mangler det nødvendige custom scope, eller din teamrolle tillader ikke handlingen.
- 429 Too many requests — DigitalOcean begrænser tokens til 5.000 requests/time og 250/minut; vent, og undgå tæt polling. Listing af SSH-nøgler er begrænset til 10 requests pr. 60 sekunder.
- Tom Droplet-liste — bekræft, at tokenet tilhører det korrekte DigitalOcean-team.
Tilgængelige værktøjer
-
get_account
Get the DigitalOcean account and team status for the connected token.
-
list_droplets
List Droplets. Optionally filter by tag_name.
-
get_droplet
Get details for a single Droplet by ID.
-
create_droplet
Create a Droplet. Requires name, region, size, and image. Optional ssh_keys, backups, ipv6, monitoring, tags, vpc_uuid, user_data.
-
delete_droplet
Delete a Droplet by ID. This is irreversible.
-
list_droplet_actions
List actions performed on a Droplet.
-
get_droplet_action
Get the status of a Droplet action.
-
initiate_droplet_action
Start a Droplet power/lifecycle action: reboot, power_cycle, shutdown, power_off, power_on, password_reset, enable_ipv6, enable_backups, disable_backups, or snapshot (requires name for snapshot).
-
list_regions
List DigitalOcean regions and available features.
-
list_sizes
List Droplet size plans (CPU, memory, disk, price).
-
list_images
List images (distributions, applications, or private snapshots).
-
get_image
Get an image by ID or slug.
-
list_ssh_keys
List SSH keys on the account. Note: DO rate-limits this endpoint to 10 requests per 60 seconds.
-
get_ssh_key
Get an SSH key by ID or fingerprint.
-
create_ssh_key
Add an SSH public key to the account.
-
delete_ssh_key
Delete an SSH key by ID or fingerprint.
-
list_domains
List domains in the account DNS.
-
get_domain
Get a domain and its TTL zone file metadata.
-
create_domain
Add a domain to DigitalOcean DNS. Optional ip_address creates an A record for @.
-
delete_domain
Delete a domain and all of its DNS records from DigitalOcean DNS.
-
list_domain_records
List DNS records for a domain. Optionally filter by type, name, or both.
-
get_domain_record
Get a single DNS record by ID.
-
create_domain_record
Create a DNS record. Provide type, name, and data; optional priority, port, ttl, weight, flags, tag.
-
update_domain_record
Update a DNS record fields (type, name, data, ttl, etc.).
-
delete_domain_record
Delete a DNS record by ID.
-
list_firewalls
List cloud firewalls.
-
get_firewall
Get a cloud firewall by ID.
-
create_firewall
Create a cloud firewall. Pass inbound_rules and outbound_rules as DigitalOcean rule objects; optional droplet_ids and tags.
-
delete_firewall
Delete a cloud firewall by ID.
-
add_droplets_to_firewall
Assign Droplets to a firewall.
-
remove_droplets_from_firewall
Remove Droplets from a firewall.
-
list_volumes
List block storage volumes. Optionally filter by name or region.
-
get_volume
Get a block storage volume by ID.
-
create_volume
Create a block storage volume. Provide name, size_gigabytes, and region (or snapshot_id).
-
delete_volume
Delete a block storage volume by ID.
-
initiate_volume_action
Attach or detach a volume (type=attach|detach). For attach, provide droplet_id and optional region.
-
list_tags
List resource tags.
-
get_tag
Get a tag and resource counts by name.
-
create_tag
Create a tag name (resources can be tagged afterward).
-
delete_tag
Delete a tag by name (untags resources).
-
tag_resources
Apply a tag to resources. resources is an array of {resource_id, resource_type} objects (droplet, image, volume, volume_snapshot).
-
untag_resources
Remove a tag from resources. Same resources shape as tag_resources.
-
list_projects
List projects used to organize resources.
-
get_project
Get a project by ID.
-
create_project
Create a project. purpose and environment are required by DigitalOcean.
-
update_project
Update a project name, description, purpose, environment, or default flag.
-
delete_project
Delete an empty project by ID.
-
list_snapshots
List Droplet or volume snapshots. Optionally filter by resource_type (droplet|volume).
-
get_snapshot
Get a snapshot by ID.
-
delete_snapshot
Delete a snapshot by ID.
-
list_vpcs
List VPCs.
-
get_vpc
Get a VPC by UUID.
-
create_vpc
Create a VPC in a region. Optional ip_range (CIDR).
-
delete_vpc
Delete a VPC by UUID (must have no members).
-
list_reserved_ips
List reserved (floating) IPv4 addresses.
-
get_reserved_ip
Get a reserved IP by address.
-
create_reserved_ip
Reserve a new IPv4. Provide region for an unassigned IP, or droplet_id to assign immediately.
-
delete_reserved_ip
Release a reserved IP address.
-
initiate_reserved_ip_action
Assign or unassign a reserved IP (type=assign|unassign). assign requires droplet_id.
-
list_load_balancers
List load balancers.
-
get_load_balancer
Get a load balancer by ID.
-
create_load_balancer
Create a load balancer. Provide name, region, and forwarding_rules; optional droplet_ids, tag, vpc_uuid, health_check, sticky_sessions.
-
delete_load_balancer
Delete a load balancer by ID.
MCP-endpoint:
https://stackgate.ai/mcp/digitalocean
(HTTP) eller via
private gateway.