Step-by-step instructions for connecting Marker.io MCP to your AI tool. For an overview of what MCP can do, see MCP Integration (Model Context Protocol).

The MCP server URL is:

https://connect.marker.io/mcp

Authentication

There are two ways to authenticate:

OAuth - your AI tool opens a browser window where you approve access. No token needed.
Access token - for clients that don't support OAuth, generate a bearer token from your Marker.io account settings.

ChatGPT

ChatGPT supports MCP via Connectors (requires ChatGPT Plus/Pro or Teams).

Go to Settings > Apps & Connectors > Advanced settings and enable Developer mode
Go to Settings > Connectors > Create
Enter name: Marker.io
Enter MCP server URL: https://connect.marker.io/mcp
Set authentication to OAuth
Click Create, then complete the OAuth login flow

Codex

Open your terminal and run:

codex mcp add --url https://connect.marker.io/mcp marker-io

Then authenticate:

codex mcp login marker-io

Complete the authorization flow in your browser.

Claude.ai

Open Claude.ai → Settings → Connectors
Click Add custom connector
Enter the MCP server URL: https://connect.marker.io/mcp
Click Add and complete the authorization flow

Claude Code

claude mcp add --transport http marker-io https://connect.marker.io/mcp

Claude Desktop

Edit the config file:

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

{
  "mcpServers": {
    "marker-io": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://connect.marker.io/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

Replace YOUR_TOKEN with your access token. Restart Claude Desktop after editing.

Cursor

Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global setup):

{
  "mcpServers": {
    "marker-io": {
      "url": "https://connect.marker.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with your access token. Cursor will handle the OAuth flow automatically if you omit the headers.

VS Code

Create .vscode/mcp.json in your workspace, or use the Command Palette > "MCP: Add Server":

{
  "servers": {
    "marker-io": {
      "type": "http",
      "url": "https://connect.marker.io/mcp"
    }
  }
}

Requires VS Code 1.101+.

GitHub Copilot

Open VS Code → Settings → search for MCP. Click Edit in settings.json and add:

{
  "servers": {
    "marker-io": {
      "type": "http",
      "url": "https://connect.marker.io/mcp"
    }
  }
}

Make sure Agent Mode is enabled in GitHub Copilot Chat.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "marker-io": {
      "serverUrl": "https://connect.marker.io/mcp"
    }
  }
}

Windsurf will open an OAuth authorization flow to connect. Restart Windsurf after editing.

JetBrains

Open Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Click Add to add a new MCP server
Paste the following configuration:

{
  "mcpServers": {
    "marker-io": {
      "url": "https://connect.marker.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with your access token.

OpenCode

Edit ~/.config/opencode/opencode.json (or opencode.json in your project root):

{
  "mcp": {
    "marker-io": {
      "type": "remote",
      "url": "https://connect.marker.io/mcp",
      "enabled": true
    }
  }
}

Other clients

For any MCP-compatible client not listed above:

Set the server URL to https://connect.marker.io/mcp
Add the Authorization: Bearer YOUR_TOKEN header with your access token

{
  "mcpServers": {
    "marker-io": {
      "url": "https://connect.marker.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with your access token.