Claude Desktop Setup
Connect Claude to graph8 so you can ask about your campaigns, accounts, contacts, and intelligence — and run graph8 tools — directly in a conversation.
The UI moved — where to add graph8 now
Anthropic replaced the old claude_desktop_config.json editing flow with an in-app Connectors UI. If you are looking for the config file or a “paste this JSON” step, that flow no longer exists for remote servers. Add graph8 here instead:
| Client | Where to add a custom connector |
|---|---|
| Claude.ai (web) | Settings → Connectors → Add custom connector |
| Claude Desktop (app) | Settings → Connectors → Add custom connector (older builds label this MCP Servers → Add) |
If your menu shows Extensions or Plugins instead of Connectors, use Add custom connector / Add in that panel — it is the same remote-MCP entry point under a different label depending on your Claude version.
Prerequisites
- Claude Desktop installed (download) or a Claude.ai account
- A graph8 account (get started free — 1,000 credits, no card required)
Setup
-
Open the connector settings
In Claude.ai go to Settings → Connectors → Add custom connector. In Claude Desktop go to Settings → Connectors → Add custom connector (or MCP Servers → Add on older builds).
-
Paste the graph8 server URL
https://be.graph8.com/mcp/ -
Add and connect
Click Add, then Connect. Claude opens a browser tab to graph8.
-
Authorize (one time)
Sign in to graph8 and approve the connection. You are returned to Claude automatically. No API key or session ID is required — the OAuth grant is tied to your graph8 account and the organization you have active when you connect.
-
Verify
Start a new conversation and ask: “What campaigns do I have in graph8?”
Example Questions
Once connected, try asking Claude:
Show me my active campaigns in graph8What accounts are in the healthcare industry?Get the intelligence report for [account name]Search graph8 for content about competitive positioningWhat deals are in my pipeline?How It Works
Claude uses MCP (Model Context Protocol) to connect to graph8:
- When you mention graph8 data, Claude recognizes it needs external information.
- Claude calls the appropriate graph8 tool (like
list_campaignsorsearch). - The graph8 MCP server authenticates with your OAuth grant and fetches the data.
- Claude formats and presents the results in the conversation.
Multiple Organizations
The connection uses the organization you had active in graph8 when you authorized. To switch:
- Switch organizations in graph8.
- In Claude, remove the graph8 connector and add it again (Settings → Connectors).
- Re-authorize; the new grant binds to the newly active organization.
Managing the Connection
- Disconnect: remove the graph8 connector from Settings → Connectors in Claude, and/or revoke the grant from your graph8 Profile.
- Re-authorize: if Claude reports an authentication error, open the connector and click Connect again to refresh the OAuth grant.
Troubleshooting
Claude specifics live here. Generic MCP issues (auth, permissions, “tool not found”) are answered in the MCP FAQ.
I can’t find “Connectors” in the menu
Depending on your Claude version the entry may be labeled Connectors, MCP Servers, Extensions, or Plugins. In every case, look for Add custom connector / Add and paste https://be.graph8.com/mcp/. Update Claude to the latest version if you see none of these.
Claude doesn’t recognize graph8 commands
- Confirm the graph8 connector shows Connected in Settings → Connectors.
- Start a fresh conversation after connecting.
- If it still fails, remove and re-add the connector, then re-authorize.
Other issues
Privacy & Security
- Your graph8 data is fetched in real time and not stored by Claude.
- All requests use your authenticated OAuth grant, scoped to your account and active organization.
- You can revoke access anytime from your graph8 Profile or by removing the connector in Claude.
- API calls are logged for audit purposes.