Quick Setup (Web-Based)

This is the fastest way to connect your AI tool to Metadot. Just add a URL — your browser handles authentication via OAuth 2.1 with PKCE. No API keys, no database credentials, no local server required.

Connecting from an IDE? See the Developer Setup (IDE) guide for Cursor, Claude Code, Windsurf, and Antigravity instructions.

How It Works

1. Copy the Metadot MCP URL: https://metadot.eu/api/mcp
2. Paste it into your AI tool's settings
3. Your browser opens to a consent page where you sign in with your Metadot account
4. A 24-hour access token is issued automatically — renewals happen in the background

For Everyone (No Coding Required)

These tools work for anyone with a Metadot account. No technical skills needed.

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

Claude Desktop

1. Open Claude Desktop
2. Go to Settings (gear icon) > MCP Servers > Add
3. Paste the URL: https://metadot.eu/api/mcp
4. Click Save
5. Your browser opens for Metadot login. Authorize and you're done.

ChatGPT

1. Open ChatGPT Desktop app
2. Go to Settings > MCP
3. Click Add Server
4. Paste the URL: https://metadot.eu/api/mcp
5. Click Save
6. Your browser opens for Metadot login. Authorize and you're done.

Claude.ai (Web)

1. Go to claude.ai in your browser
2. Click your profile icon > Settings
3. Go to Integrations tab
4. Click Add MCP Server
5. Paste the URL: https://metadot.eu/api/mcp
6. Click Save. Login is handled automatically.

For Developers

Cursor

Add to your project's .mcp.json:

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

When you first use the MCP server, your browser will open for you to log in to your Metadot account. No further setup needed.

Claude Code

Run in your project root:

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

Claude Code will open your browser for authentication when you first connect.

Windsurf

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

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

The mcp-remote package acts as a bridge for STDIO-only clients. Your browser opens for authentication on first use.

Antigravity

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

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

Merge into your existing config if you already have other MCP servers.

Try It Out

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 an interactive visual guide with step-by-step connection instructions for each AI tool.