Getting Started

Create your account, grab your API token, and connect your AI tool to start managing Drupal sites with natural language. Complete in under 5 minutes.

Step 1: Create Your Account

Sign up free — no credit card required.

Head to the Decoupled.io Dashboard and create your account. You'll get instant access to create Drupal sites and manage your projects.

Open Dashboard →

Step 2: Get Your API Token

Generate a Personal Access Token to authenticate your AI tools.

Create your token

  1. Go to dashboard.decoupled.io
  2. Navigate to Settings → API Tokens
  3. Click Create Token and copy it

Your token will look like dc_tok_... — keep it safe, you'll need it in the next step.

Step 3: Connect Your AI Tool

One command to configure MCP for your IDE:

npx decoupled-cli@latest mcp configure

This auto-detects your IDE (Claude Code, Cursor, etc.), prompts for your API token, and configures the MCP server. That's it.

Manual configuration (JSON)

Claude Code

Add a .mcp.json file to your project root:

{
  "mcpServers": {
    "decoupled-io": {
      "type": "http",
      "url": "https://mcp.decoupled.io",
      "headers": {
        "Authorization": "Bearer dc_tok_YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "decoupled-io": {
      "url": "https://mcp.decoupled.io/sse",
      "headers": {
        "Authorization": "Bearer dc_tok_YOUR_TOKEN"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

{
  "mcpServers": {
    "decoupled-io": {
      "url": "https://mcp.decoupled.io/sse",
      "headers": {
        "Authorization": "Bearer dc_tok_YOUR_TOKEN"
      }
    }
  }
}

Step 4: Start Building

Create a Drupal site and import content — all from your AI assistant.

Open your AI tool and try these prompts:

Create a site with content

"Create a new Drupal site called 'Tech Blog', then import a blog content model with categories and 5 sample posts about web development. Give me the login link when done."

Your AI assistant will call create_space, wait for provisioning, import_content, then get_login_link.

Connect a Next.js frontend

"Get the OAuth credentials for my space and help me set up a Next.js project to fetch content from it."

Uses get_oauth_credentials and get_space to get your GraphQL endpoint, then scaffolds the frontend.

You're all set!

Your AI tool is connected and ready to manage Drupal sites. Explore the full platform: