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

If you are on a Team or Enterprise plan, your workspace Owner has to add Marker.io for the team. Members cannot add custom connectors themselves. See Anthropic's guide for the full flow.

Owners (Team and Enterprise)

Open Claude.ai → Settings → Organization settings → Connectors
Click Add, hover Custom, then select Web
Enter the MCP server URL: https://connect.marker.io/mcp
Save and complete the authorization flow

Once added, team members can enable Marker.io from Customize → Connectors.

Personal accounts (Free, Pro, Max)

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    }  }}

CMS-specific guides

If your team uses a CMS, we have dedicated guides for connecting Marker.io MCP to your platform:

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.