Create, test, deploy your MCP key

1. 1Create your MCP key

   Go to Dashboard → Settings → MCP API keys → "Create MCP key". Pick a descriptive name (e.g. claude-desktop-laptop, cursor-personal, my-hermes-agent). The plaintext secret is shown exactly once - copy it straight into your secret manager.

   Open the dashboard →

2. 2Smoke-test the key in 30 seconds (cURL)

   Run a direct call to the MCP endpoint to confirm Bearer auth works. A 200 OK with a valid JSON-RPC initialize response means your key is live.

   curl -sX POST https://mcp.trinityinsights.io/mcp \
     -H "Authorization: Bearer <paste-your-tr_mcp_key-here>" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "initialize",
       "params": {
         "protocolVersion": "2025-11-25",
         "capabilities": {},
         "clientInfo": { "name": "trinity-smoke-test", "version": "1.0.0" }
       }
     }'

3. 3Configure your MCP client

   Pick your client below. Each guide gives the exact configuration (file path, JSON snippet, restart required) for Claude Desktop, Claude Code, Cursor, ChatGPT Apps SDK, Gemini Antigravity, Windsurf, VS Code Copilot, and Perplexity Spaces.

   See per-client guides ↓

4. 4Store the key safely

   Never commit the plaintext key to a git repository. Use OS-native secret stores (macOS Keychain, Linux gnome-keyring, Windows Credential Manager) or a managed secret backend (1Password, Bitwarden, Doppler, AWS Secrets Manager, Vault).

5. 5Revoke or rotate the key

   A key can be revoked at any time from the dashboard ("Revoke" button on the row). Propagation is within 60 seconds (MCP cache TTL). To rotate: create the new key, update your clients, then revoke the old key.

Per-client setup guides

Eight major MCP clients are supported through the same canonical endpoint. Each guide details the config file path, the exact JSON snippet to paste, and post-installation checks.

• Claude Desktop

  Anthropic desktop app. Configure via claude_desktop_config.json. Restart required.

• Claude Code

  Claude Code CLI. Configure via the `claude mcp add` command.

• Cursor

  Cursor IDE. Configure via Settings → Cursor Settings → MCP.

• ChatGPT (Apps SDK)

  ChatGPT Apps SDK for MCP integrations. Configure via the Apps SDK manifest.

• Gemini (Antigravity)

  Google Gemini with Antigravity. Configure via the agent manifest.

• Windsurf

  Codeium Windsurf editor. Configure via Settings → MCP servers.

• VS Code Copilot

  VS Code GitHub Copilot Chat. Configure via settings.json (github.copilot.chat.mcpServers key).

• Perplexity Spaces

  Perplexity Pro/Enterprise. Configure via Spaces → Connectors → MCP.