Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: read, write.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration. These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

​
Setup

  1. Get a DigitalOcean account: Sign up at https://www.digitalocean.com - new accounts get trial credit you can use for testing.
  2. Register an OAuth application: Go to API > OAuth Applications (https://cloud.digitalocean.com/account/api/applications), register an app, and set the callback URL to your app’s /api/auth/digitalocean/callback URL.
  3. Set environment variables: Copy the Client ID and Client Secret into your .env as DIGITALOCEAN_CLIENT_ID and DIGITALOCEAN_CLIENT_SECRET.
  4. Verify access: Complete the OAuth flow, then run Get Account and List Droplets.

​
Provider notes

  • Scopes are space-separated ‘read write’; request only ‘read’ if you don’t need mutations
  • Access tokens expire after 30 days; refresh tokens are single-use and rotate on each refresh
  • Creating Droplets provisions billable infrastructure - confirm sizes and regions before running write tools
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as digitalocean__list_droplets with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.