Connect Your AI
Atlas connects to any AI tool that supports the Model Context Protocol (MCP). You build the model once, every tool gets structured context about your actual business.
Generate your API key
- In Atlas, click your email → Settings → API Keys
- Click + New App, name it (e.g., "Claude MCP")
- Click + New Key on your app
- Set: JWT Token, Full Access, Production, 90-day expiration
- Click Generate Token
This token is only shown once. Don't close this screen until you've pasted the config.
Click Copy Config. It copies the full MCP JSON with your token embedded.
Connect your tool
- Claude (Desktop & Code) →
- Other MCP Clients →. Cursor, Windsurf, ChatGPT
What you get
Your AI gets access to 48 tools across 9 categories:
- Atlas, Points, Paths, Views: full CRUD on your data
- Brain Dump: generate structured data from text
- Analytics: PageRank, centrality, neighborhoods
- Graph Algorithms: communities, shortest path, similarity
- Cypher Queries: custom queries against your atlas
Token scopes
Full Access is recommended. For fine-grained control:
| Scope | What it allows |
|---|---|
read:atlases | View atlases |
write:atlases | Create/update atlases |
read:points, read:paths | View Points and Paths |
write:points, write:paths | Create/update Points and Paths |
delete:points, delete:paths | Remove Points and Paths |
use:llm | Brain dump (AI extraction) |
use:embeddings | Semantic search |
Token management
- Expiration: tokens expire after the period you set (recommended: 90 days). Expired tokens return
401 Unauthorized. - Revoking: revoke anytime from Settings → API Keys. Takes effect immediately.
- Security: never commit tokens to git. Never share publicly. Rotate every 90 days.
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
GRAPHITE_ACCESS_TOKEN | Yes | — | Your JWT token |
GRAPHITE_API_URL | No | https://graphiteatlas.com | API base URL |
Troubleshooting
"Unauthorized" / 401: token expired or revoked. Generate a new one in Settings → API Keys.
"GRAPHITE_ACCESS_TOKEN required": config didn't paste correctly. Re-copy.
"403 Forbidden": token doesn't have the required scope. Generate a new token with broader permissions.
Tools not appearing: fully quit and reopen your AI tool. Check JSON syntax in the config file.
Still stuck? [email protected]