Connect your AI
Three steps, about two minutes. You only do this once per app.
1
Create an access token
The token lets your AI work under your account. You need a free account to create one.
2
Add TraceGrade to your app
- Open Claude Desktop and go to Settings → Connectors.
- Click Add custom connector, name it
TraceGrade, and paste this URL:https://app.tracegrade.tech/mcp?token=YOUR_TOKEN - Click Add, then start a new chat.
Connector option not available? Use the config file instead
Requires Node.js. In Claude Desktop open Settings → Developer → Edit Config, put this in claude_desktop_config.json, save and restart Claude:
{
"mcpServers": {
"tracegrade": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.tracegrade.tech/mcp",
"--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
}
}
}- Open a terminal and run:
claude mcp add --transport http tracegrade https://app.tracegrade.tech/mcp --header "Authorization: Bearer YOUR_TOKEN" - Start
claude. Type/mcpto check that tracegrade shows as connected.
- Open (or create) the file
~/.cursor/mcp.jsonin your home folder. - Paste this, or add the
tracegradeentry next to your existing servers:{ "mcpServers": { "tracegrade": { "url": "https://app.tracegrade.tech/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } } - Save and restart Cursor. TraceGrade should appear under Settings → MCP with a green dot.
Any MCP client that supports remote servers will work. Use these values:
Server URL
https://app.tracegrade.tech/mcpTransport
Streamable HTTP (SSE also available at
https://app.tracegrade.tech/sse)Auth header
Authorization: Bearer YOUR_TOKENNo header support?
Add
?token=YOUR_TOKEN to the URL.Replace YOUR_TOKEN with the token from step 1.
3
Check that it works
In a new chat, ask your assistant:
List the TraceGrade rooms.If it answers with Office AI Fundamentals, you are connected. Go to Rooms and start one.
It didn't work
- "Unauthorized" or 401: the token is wrong, has extra spaces, or was revoked. Create a new one in step 1.
- The assistant doesn't see TraceGrade: fully quit and reopen the app after changing its settings.
- Claude Desktop config file option: it needs Node.js installed (
npxmust work in a terminal). - Still stuck? Email [email protected] with your app name and the error.