Connect to LLMs

If you’re using MCP clients that support HTTP, you can point them directly to your Drupal site URL — assuming you’ve set up and configured the MCP server module as described earlier.

All examples below use the STDIO transport, which means you’ll need our binary. Don’t worry — it’s fully dockerized, so in most cases, you won’t even notice it running.

Here’s the general config object used to add a Drupal MCP server for various LLM clients.

Replace DRUPAL_AUTH_USER and DRUPAL_AUTH_PASSWORD with the Drupal credentials you’d like the MCP server to use.

IMPORTANT: If you’re running Drupal locally with DDEV, you’ll need to specify the correct --network (check docker network ls for the name), and set the URL as http://web.
If your Drupal site is publicly accessible, you can skip the --network and use your full public URL instead.

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DRUPAL_AUTH_USER",
        "-e",
        "DRUPAL_AUTH_PASSWORD",
        "--network=17c76994121c",
        "ghcr.io/omedia/mcp-server-drupal:latest",
        "--drupal-url=http://web"
      ],
      "env": {
        "DRUPAL_AUTH_USER": "admin",
        "DRUPAL_AUTH_PASSWORD": "changeme"
      }
    }
  },
  "globalShortcut": ""
}

Claude Desktop

To connect Claude Desktop, add the MCP server config to the claude_desktop_config.json file. This file is located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

You can also view and edit it from within Claude Desktop settings.

Paste the config object into that file. Don’t forget to update the credentials and --network value.

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DRUPAL_AUTH_USER",
        "-e",
        "DRUPAL_AUTH_PASSWORD",
        "--network=17c76994121c",
        "ghcr.io/omedia/mcp-server-drupal:latest",
        "--drupal-url=http://web"
      ],
      "env": {
        "DRUPAL_AUTH_USER": "admin",
        "DRUPAL_AUTH_PASSWORD": "changeme"
      }
    }
  },
  "globalShortcut": ""
}

After saving the file, restart Claude Desktop. You should see your Drupal MCP server listed under servers, along with the number of tools (actions) it exposes. If you see that number, you’re good to go.

Claude Code

As with Claude Desktop, you’ll need to run the MCP binary as a Docker container. Replace --network, DRUPAL_AUTH_USER, and DRUPAL_AUTH_PASSWORD as needed:

claude mcp add --scope project mcp-server-drupal docker -e DRUPAL_AUTH_USER=admin -e DRUPAL_AUTH_PASSWORD=changeme -- run -i --rm -e DRUPAL_AUTH_USER -e DRUPAL_AUTH_PASSWORD --network=1bca71ea7302 ghcr.io/omedia/mcp-server-drupal:latest --drupal-url=http://web

Once set up, Claude Code will be able to talk to your Drupal site via MCP. If you’ve enabled the right MCP plugins, you’ll even be able to do things like create content types, add fields, and configure blocks — all from the terminal, without using the UI.

Cursor

To use Drupal MCP with Cursor, you can use the exact same configuration as for Claude Desktop. Just remember to update the credentials and --network.

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DRUPAL_AUTH_USER",
        "-e",
        "DRUPAL_AUTH_PASSWORD",
        "--network=17c76994121c",
        "ghcr.io/omedia/mcp-server-drupal:latest",
        "--drupal-url=http://web"
      ],
      "env": {
        "DRUPAL_AUTH_USER": "admin",
        "DRUPAL_AUTH_PASSWORD": "changeme"
      }
    }
  },
  "globalShortcut": ""
}