1

Create an access token

The token lets your AI work under your account. You need a free account to create one.

Create a free account Sign in
2

Add TraceGrade to your app

  1. Open Claude Desktop and go to Settings → Connectors.
  2. Click Add custom connector, name it TraceGrade, and paste this URL:
    https://app.tracegrade.tech/mcp?token=YOUR_TOKEN
  3. 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" }
    }
  }
}
  1. Open a terminal and run:
    claude mcp add --transport http tracegrade https://app.tracegrade.tech/mcp --header "Authorization: Bearer YOUR_TOKEN"
  2. Start claude. Type /mcp to check that tracegrade shows as connected.
  1. Open (or create) the file ~/.cursor/mcp.json in your home folder.
  2. Paste this, or add the tracegrade entry next to your existing servers:
    {
      "mcpServers": {
        "tracegrade": {
          "url": "https://app.tracegrade.tech/mcp",
          "headers": { "Authorization": "Bearer YOUR_TOKEN" }
        }
      }
    }
  3. 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/mcp
Transport
Streamable HTTP (SSE also available at https://app.tracegrade.tech/sse)
Auth header
Authorization: Bearer YOUR_TOKEN
No 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 (npx must work in a terminal).
  • Still stuck? Email [email protected] with your app name and the error.