Use GraphKit from Claude, ChatGPT and Cursor
Connect any MCP client to GraphKit with one URL. Your AI assistant can then work with your campaigns, leads, inbox and analytics, as you, with approval before anything consequential.
GraphKit is a remote MCP server. Claude, ChatGPT, Cursor, VS Code, Claude Code and other MCP clients can use everything you can do in GraphKit: campaigns, leads and lists, the inbox, sending accounts, analytics, integrations, notifications, the agency views, domains and mailboxes, and GraphKit Autopilot.
The server URL is:
https://app.graphkit.com/mcpOn an agency's own domain, use that domain instead, for example https://app.youragency.com/mcp. Settings → MCP shows the exact URL with a copy button.
How it works
- The client acts as you, in the workspace you choose when you connect, with your role's permissions. It can't see other workspaces or do anything your role can't.
- Reading and small edits run directly: searching leads, reading the inbox, drafting replies, building a campaign draft, adding a label.
- Consequential actions wait for you. Sending messages, launching or resuming campaigns, enrolling many leads, deleting, suppressing, inviting people, developer settings and billing never run straight from the client. It gets an approval link instead, and the action waits on the Kit page under Approvals until you approve it. Nothing is auto-approved for connected apps.
- API keys, webhook secrets and mailbox passwords are never shown to a connected app.
- Everything a connected app changes is in the audit log as MCP client name on behalf of you.
Claude
Works in Claude on the web and in Claude Desktop.
- Open Settings → Connectors and choose Add custom connector.
- Name it GraphKit and paste the server URL. Leave the advanced OAuth fields empty.
- Choose Connect. A GraphKit page opens: sign in if needed, pick the workspace and the access (read only, or read and write), and choose Allow.
- In a chat, open the tools menu and turn on GraphKit.
On Claude Team and Enterprise, an owner adds the connector once in the organization settings; then each person connects their own GraphKit account.
ChatGPT
- Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode. On business plans an admin may need to allow it first.
- Back in Apps & Connectors, choose Create. Name the connector, paste the server URL and choose OAuth as the authentication.
- Choose Create. Sign in to GraphKit, pick the workspace and choose Allow.
- In a chat, choose + → Developer mode and select GraphKit.
Cursor
-
Open Cursor Settings → MCP & Integrations → New MCP server. This opens
~/.cursor/mcp.json. -
Add the server and save:
{ "mcpServers": { "graphkit": { "url": "https://app.graphkit.com/mcp" } } } -
The server shows Needs login. Choose it, sign in to GraphKit, pick the workspace and choose Allow.
VS Code
Run MCP: Add Server → HTTP and paste the URL, or add this to .vscode/mcp.json:
{
"servers": {
"graphkit": { "type": "http", "url": "https://app.graphkit.com/mcp" }
}
}Start the server from the file. VS Code opens the GraphKit sign-in page.
Claude Code
claude mcp add --transport http graphkit https://app.graphkit.com/mcpThen run /mcp in Claude Code and choose Authenticate.
Other clients and API keys
Any client that supports MCP over Streamable HTTP with OAuth needs only the URL: it finds the GraphKit sign-in page from it.
For clients without OAuth, scripts and servers, create a key in Settings → MCP → Create MCP key and send it as a bearer token:
Authorization: Bearer gk_live_…A key acts as the person who created it, in its workspace. Choose Read only or Read and write, and optionally limit it to some areas. Creating keys needs the API keys permission.
Choosing what a client can do
When you connect, you choose:
- Read only: the client sees your campaigns, leads, inbox and analytics and changes nothing.
- Read and write: the client can also make changes. Consequential actions still wait for your approval.
- Limit to some areas (optional): for example only the inbox, or only leads and campaigns.
The areas are sending accounts, leads and lists, campaigns, inbox, analytics, integrations, workspace, billing, Autopilot, and domains and mailboxes. To show a client fewer tools without changing its access, add ?areas= to the URL, for example https://app.graphkit.com/mcp?areas=inbox,leads.
Approving actions
When the client wants to send a reply, launch a campaign or delete something, it tells you that the action is waiting and gives you a link. Open it, or go to Kit → Approvals, check exactly what will happen, and approve or reject it. The client can then check the outcome. You can approve from your phone.
Disconnecting
Account → Connected apps lists every app you connected, with its workspace, its access and when it was last used. Disconnect stops it immediately. Settings → MCP shows the apps you connected to the current workspace and its MCP keys. Workspace admins also see All connected apps in this workspace: every app anyone connected, who it acts as and when it was last used. Revoke ends its access immediately.
Ideas to try
- "Write me this week's outreach report: replies, acceptance rate, best and worst campaigns."
- "Go through my unread replies, sort them by intent and draft answers for the interested ones."
- "Build a campaign for heads of sales at fintechs in Germany from the Fintech DE list: invite, two follow-ups, a voice note. Don't launch it."
- "Which sending accounts are close to their limits or need reconnecting?"
- "Pause Autopilot in the Acme workspace."
The server also offers ready-made prompts (weekly report, inbox triage, campaign plan) in clients that show MCP prompts.
Troubleshooting
- The sign-in page says the link expired: connection requests last 10 minutes and work once. Start again from the client.
- The client says it isn't authorized: it was disconnected, your access to the workspace changed, or your organization requires two-factor authentication and you haven't set it up.
- A tool is missing: your access level, the areas you chose or your role don't include it. Reconnect with more access, or ask an admin.
- Too many requests: each connection can make 120 requests a minute. The client retries automatically.
For the technical details (transport, OAuth endpoints, scopes), see the MCP server reference in the API docs.
Kit, the AI agent
Ask Kit to do anything you can do in GraphKit, from drafting replies to building and launching campaigns. Kit acts with your permissions and asks before anything consequential.
GraphKit Autopilot
An optional add-on in which Kit runs your outbound for a workspace, from finding and researching prospects to answering the replies you allow, inside the limits you set.