Developer Setup (IDE)

Connect your AI-powered IDE to your Metadot workspace in seconds. Just paste one URL — your browser handles sign-in via OAuth 2.1 with PKCE. No API keys, no database credentials, no local server to run.

Not a developer? See Quick Setup (Web-Based) for Claude Desktop, ChatGPT, and Claude.ai.

How It Works

1. Copy the Metadot MCP URL: https://metadot.eu/api/mcp
2. Paste it into your IDE's MCP settings (or run the command below)
3. On first use, your browser opens to a consent page where you sign in with your Metadot account
4. A 24-hour access token is issued automatically — refreshes happen silently in the background

MCP Server URL: https://metadot.eu/api/mcp

Cursor

Add to your project's .mcp.json:

{
  "mcpServers": {
    "metadot": {
      "url": "https://metadot.eu/api/mcp"
    }
  }
}

Or use the one-click install button on metadot.eu/mcp-server — it opens a cursor:// deeplink that auto-configures the server.

On first use, Cursor will open your browser for Metadot login.

Claude Code

Run in your terminal:

claude mcp add --transport http metadot https://metadot.eu/api/mcp

Claude Code opens your browser for authentication on first connection.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "metadot": {
      "command": "npx",
      "args": ["mcp-remote", "https://metadot.eu/api/mcp"]
    }
  }
}

The mcp-remote package bridges Windsurf's STDIO transport to the remote HTTP MCP endpoint and handles the OAuth flow. Merge into your existing config if you already have other MCP servers.

Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "metadot": {
      "command": "npx",
      "args": ["mcp-remote", "https://metadot.eu/api/mcp"]
    }
  }
}

Same bridge as Windsurf — Antigravity is STDIO-only, so mcp-remote translates to the remote HTTP endpoint.

Any Other MCP Client

Point any MCP-compatible client at https://metadot.eu/api/mcp using the Streamable HTTP transport. Clients that only support STDIO can use the mcp-remote bridge shown above.

Try It

Once connected, ask your AI assistant:

"List my workspaces"
"Show me open tickets"
"Create a CRM contact named Jane Doe at Acme Corp"
"Search everything for 'invoice'"

Visual Setup Guide

Visit metadot.eu/mcp-server for a side-by-side visual guide with one-click install buttons for each supported IDE.

For Agents & Scripts (PAT-Based)

If your tool or script cannot open a browser for OAuth, use a Personal Access Token instead. No browser interaction needed.

Generate a PAT

1. Go to Settings > API Keys > Personal Access Tokens in any workspace
2. Click Generate personal token
3. Choose scopes (e.g., crm:*, tickets:*, or * for full access)
4. Copy the token — it is shown only once

MCP Config with PAT

For clients that support custom headers:

{
  "mcpServers": {
    "metadot": {
      "url": "https://metadot.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer mk_your_token_here"
      }
    }
  }
}

curl Example

curl -X POST https://metadot.eu/api/mcp \
  -H "Authorization: Bearer mk_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

PAT scopes limit which tools are available. A token with ["crm:*", "tickets:*"] only sees CRM and Tickets tools. Use * for full access. See the Authentication & RBAC page for details.