Set up Claude, Cursor, claude.ai, or ChatGPT

This page walks through connecting each supported client to your Maark workspace. The connection endpoint is the same everywhere:

https://www.maark.ai/api/mcp

First: mint a key (for key-based clients)

Claude Code and Cursor authenticate with a scoped key.

1. Go to Org Settings → External agent access.
2. Mint a new key, choosing its scope (read, propose, or operate) and the projects it can reach.
3. Copy the key (mk_…) — it is shown once. Store it somewhere safe.

claude.ai and ChatGPT do not need a key — they use a guided sign-in instead (covered below).

Claude Code

Run:

claude mcp add --transport http maark https://www.maark.ai/api/mcp --header "Authorization: Bearer mk_your_key"

Then ask Claude to run a Maark task to confirm it is connected.

Cursor

Add Maark to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "maark": {
      "url": "https://www.maark.ai/api/mcp",
      "headers": { "Authorization": "Bearer mk_your_key" }
    }
  }
}

Restart Cursor so it picks up the new connector.

claude.ai (browser)

1. In claude.ai, open Settings → Connectors → Add custom connector.
2. Enter the URL https://www.maark.ai/api/mcp.
3. Complete the sign-in: log in to Maark, pick your organization and projects, choose a scope, and approve.

No key needed — the guided sign-in handles it. On Team and Enterprise plans, org owners can add org-level connectors.

ChatGPT

1. Enable Developer mode, then add an MCP connector.
2. Enter the same URL: https://www.maark.ai/api/mcp.
3. Complete the guided sign-in and approve access.

Confirm it works

Ask your assistant to check your pipeline status for one project. It should return data for only the projects your key or sign-in was scoped to. If it does, you are connected — head to What your AI can do.

Notes

• The scope you pick at sign-in (or when minting a key) decides whether the assistant can read, propose, or operate. See Agent access & safety.
• Lost a key or need to cut off access? Revoke it in Org Settings → External agent access and mint a new one.