Connect your AI agent

Connect in three steps.

With an account and an AI client, you’re connected in under two minutes.

  1. 1Create an API key with Allow MCP connections ticked.
  2. 2Add this URL as a connector in your client.
  3. 3Paste the key when Gourdo’s sign-in page opens.

Before you start

You need one API key that is allowed to accept MCP connections.

  1. 01Dashboard → API Keys → Create Key. Tick Allow MCP connections.
  2. 02From the API Key Created dialog, copy the key (shown once) and the connector URL.
Tip: use one key per client, so you can disconnect one without touching the others.
The dashboard's Create API Key dialog with Allow MCP connections ticked
Create Key, with Allow MCP connections ticked.
The API Key Created dialog showing the key once and the connector URL with a copy button
The key, shown once, and the connector URL to copy.

The one screen every path shares

Gourdo’s sign-in page. Paste the key, approve, done.

Whichever client you use, it ends up here. Check the address bar reads https://gourdo.ai/mcp/authorize, paste the whole sk_live_… string, and click Approve and connect.

The page belongs to Gourdo, not to your AI client. It never sees your client’s credentials, and your client never sees the key.

https://gourdo.ai/mcp/authorize

Pick your client

Where to add it, what to enter, the sign-in, how you know it worked.

Claude Code
Already added Gourdo as a connector in your Claude account? Nothing to configure: restart Claude Code and run /mcp. Gourdo is listed.

Otherwise, add it from the terminal:

claude mcp add --transport http gourdo https://gourdo.ai/api/mcp
  1. 01Start a new session and run /mcp.
  2. 02Choose gourdo, then Authenticate. Your browser opens Gourdo’s sign-in page; paste the key.

You’ll know it worked: the terminal reports Authentication successful. Connected to gourdo.

claude
> /mcp

Manage MCP servers
1 server found

❯ 1. gourdo          ✔ connected

Enter to select · Esc to exit

───────────────────────────────────────
gourdo
URL:       https://gourdo.ai/api/mcp
Transport: http
Status:    ✔ connected
Tools:     13

Authentication successful. Connected to gourdo.
claude.ai, Claude Desktop, and Cowork

One connector serves all three.

Claude's Add custom connector dialog with Gourdo filled in: Sign in now and Register automatically detected
1 · Add the connector. Customize → Connectors → Add custom connector. Name Gourdo, URL https://gourdo.ai/api/mcp. Leave Sign in now and Register automatically selected (Claude detects them). No request headers. Click Add.
Claude shows: You're not connected to Gourdo yet, with a Connect button
2 · Connect. On “You’re not connected to Gourdo yet.” click Connect. Gourdo’s sign-in page opens: paste the key, then Approve and connect.
Claude Desktop asks: Finish connecting a connector? with a Continue connecting button
3 · Finish (desktop app only). When it asks “Finish connecting a connector?”, click Continue connecting.
You’ll know it worked: Gourdo shows Connected under Your connectors.
In a conversation: + → Connectors, make sure Gourdo is on. Cowork: start a new conversation after connecting.
Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), or use Settings → Tools & MCP → Add Custom MCP:

{ "mcpServers": { "gourdo": { "url": "https://gourdo.ai/api/mcp" } } }

Restart Cursor. On first use it opens Gourdo’s sign-in page in your browser; paste the key.

You’ll know it worked: Gourdo’s tools appear under the server in Settings → Tools & MCP.

ChatGPT

Settings → Connectors → Advanced settings → turn on Developer mode (Plus, Pro, Team/Business, Enterprise and Edu plans).

Create: name Gourdo, URL https://gourdo.ai/api/mcp, Authentication OAuth, leave client ID and secret blank. Complete the sign-in on Gourdo’s page.

In a chat, pick Gourdo from the tools menu.

You’ll know it worked: Gourdo is listed under Connectors with its tools, and appears in the chat’s tools menu.

VS Code (GitHub Copilot)

Command Palette → MCP: Add Server → HTTP → https://gourdo.ai/api/mcp. Or in .vscode/mcp.json:

{ "servers": { "gourdo": { "type": "http", "url": "https://gourdo.ai/api/mcp" } } }

VS Code opens the browser for sign-in; paste the key. Tools appear in Copilot Chat’s Agent mode.

You’ll know it worked: the server shows as running above its entry in mcp.json, and Gourdo’s tools are in Agent mode’s tool picker.

Gemini CLI

Add to ~/.gemini/settings.json:

{ "mcpServers": { "gourdo": { "httpUrl": "https://gourdo.ai/api/mcp" } } }

Sign-in opens on first connect; if it does not, run /mcp auth gourdo.

You’ll know it worked: /mcp lists gourdo as connected with its tools.

Any other MCP client

Add a remote server by URL, https://gourdo.ai/api/mcp, and choose sign-in / OAuth when asked. Gourdo’s sign-in page opens; paste the key.

Done

Your agent now has Gourdo’s tools.

Pages as Markdown, HTML, elements, links, metadata, screenshots and PDF; sessions; and your usage and balance. Full list in the docs.

To disconnect, deactivate or delete the key on the dashboard.

Your connectorsManage
Gourdohttps://gourdo.ai/api/mcpConnected
Approximation of Claude’s connector list.

Having trouble?

Still stuck? hello@uelabs.ai

“This key isn't enabled for MCP connections.”The key was created without the box ticked. Create a new one with it ticked. Existing keys can't be changed.
“That key is not valid, is inactive, or has expired.”Check the key on the dashboard, and paste the whole sk_live_… string.
The client keeps asking me to sign in.The key was deactivated or deleted, or the subscription has lapsed. The dashboard shows which. A reactivated key needs a fresh paste.
New tools aren't showing.Start a new conversation (claude.ai, Desktop, Cowork) or restart the session (Claude Code, Cursor, VS Code).