Connect Ekly's MCP Server to Claude, Cursor, VS Code, and More

Every client below connects to the same URL, signs you in with your Ekly account, and needs no API key. Pick your client and follow the steps.

Paid plans only

MCP access is included on paid Ekly plans. You can still follow the setup below on a free account, but tool calls won't complete until you upgrade.

MCP server URL — same one for every client

https://mcp.ekly.ai/mcp

Ekly authenticates over OAuth. The first time a client connects, it opens Ekly's sign-in page in your browser — log in and approve access. That's the whole auth step, every client below.

Claude.ai and Claude Desktop

Open Connectors settings

Settings → Connectors. Same tab in claude.ai and Claude Desktop.

Add a custom connector

Tap the + next to Connectors → Add → Custom. Choose Web if it asks for a type.

Name it, paste the URL

Call it "Ekly", paste the URL below, leave the OAuth fields blank.

e.g. “https://mcp.ekly.ai/mcp”

Add, then Connect

Claude Code (CLI)

Run this in your terminal

Not inside a `claude` session — register the server first, then start Claude Code.

e.g. “claude mcp add --transport http ekly https://mcp.ekly.ai/mcp”

Authorize on first use

Use any Ekly tool. Your browser opens to sign in — after that, you're set for the session.

User-scope vs. project-scope

That command registers Ekly for every project (~/.claude.json). Add --scope project to keep it to the current repo instead (.mcp.json).

ChatGPT

Turn on Developer mode

Settings → Apps → Advanced settings. One-time toggle.

Create a custom connector

Settings → Connectors → Create → Add custom connector.

Name it, paste the URL

Call it "Ekly" and paste the URL below as the endpoint.

e.g. “https://mcp.ekly.ai/mcp”

Authorize and enable

Cursor

Open MCP settings

Cursor Settings → Tools & MCP → "+ Add New MCP Server". Or edit the config directly (below).

Connect

Click Connect next to the Ekly entry — your browser opens to sign in and approve access.

~/.cursor/mcp.json

{ "mcpServers": { "ekly": { "url": "https://mcp.ekly.ai/mcp" } } }

Don't paste a token into headers

The URL alone is enough — Cursor's Connect button handles sign-in. A headers block with a hard-coded key is for a different kind of MCP server, not this one.

VS Code (GitHub Copilot)

Add a server config

Command Palette → "MCP: Add Server" — or create `.vscode/mcp.json` in your workspace and paste the config below.

Sign in when prompted

VS Code opens your browser to authorize — approve access, same as any OAuth connector.

Switch Copilot Chat to Agent mode

Ekly's tools only show up in Agent mode — pick it from the mode dropdown in Copilot Chat.

.vscode/mcp.json

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

The root key is "servers", not "mcpServers"

VS Code uses a different config key than Cursor, Windsurf, and Claude Desktop. Reuse one of those JSON snippets here and VS Code will silently ignore it.

Windsurf

Open the MCP panel

Cascade panel → MCPs icon (top right) → add a custom server. Or edit the config file directly (below).

Name it, paste the URL

Call it "Ekly", paste the URL below as the server URL.

Sign in when prompted

Windsurf opens your browser to authorize — approve access, and Cascade picks up the connection.

~/.codeium/windsurf/mcp_config.json

{ "mcpServers": { "ekly": { "serverUrl": "https://mcp.ekly.ai/mcp" } } }

Cline

Open MCP server settings

In Cline's Configure tab, click "Configure MCP Servers", then the "Remote Servers" tab.

Fill in the server details

Server Name: "Ekly". Server URL: the endpoint below. Transport Type: Streamable HTTP. Click Add Server.

e.g. “https://mcp.ekly.ai/mcp”

Authorize

Cline shows an authorization link — click it, sign in, and approve. Cline connects automatically once you do.

What to expect once you're connected

Nothing's charged until you say so. Asking for an image or video shows you the model and credit cost first — it only spends once you confirm.
Images finish inline; video and music run in the background. For those, the agent points you to the generation so you can check on it or open it in Ekly.
Multiple organizations work too. Ask your agent to switch organizations — same setting as the web app's org switcher.

Built from official sources