MCP: Connect via OAuth (Interactive Sign-in)

Overview

Interactive sign-in lets you ask Felix questions about your Quantum Metric data from your own AI assistant: Claude, ChatGPT, Cursor, VS Code, or any client that supports the Model Context Protocol (MCP).

You sign in once with your Quantum Metric account. Every call runs as you, with your role, permissions, workspace and timezone. There is no token to create or store.

Once connected, your assistant can query behavioral data, investigate sessions and errors, run funnels and saved queries, and work with the dashboards, workflows and monitoring agents in your subscription.

Scope and limits

• Read and act on collected data only. Quantum Metric MCP works with a subscription that already collects data.
• Targeted questions and actions. For bulk data movement, you should use the Quantum Metric API instead.
• Your permissions carry over unchanged. Your assistant sees only what your Quantum Metric account can see.

Before you begin

You need:

• A Quantum Metric login with access to the subscription.
• Your subscription name, as it appears in your Quantum Metric URL.
• An MCP client that supports sign-in (MCP OAuth). Claude Code, Claude desktop and web, ChatGPT, Cursor and VS Code all do.

Endpoint

https://api.quantummetric.com/mcp/<subscription>

Replace <subscription> with your subscription name.

Connect your client

Add the endpoint URL to your client with no headers or token. The first time you connect, a browser window opens for Quantum Metric sign-in. The client keeps you signed in after that.

Claude Code

Step 1. In a terminal, run:

claude mcp add --transport http felix https://api.quantummetric.com/mcp/<subscription>

Step 2. Start Claude Code, run /mcp, select felix, and sign in. You can also sign in from a terminal with claude mcp login felix.

Claude desktop and web

1. Go to Customize › Connectors.
2. Select + Add › Add custom connector.
3. Enter a name, such as Felix, and the endpoint URL. Select Add.
4. Sign in with your Quantum Metric account when prompted.

On Team and Enterprise plans, an organization owner adds the connector once under Organization settings › Connectors. Members then open Customize › Connectors, find it, and select Connect. The connector works across Claude desktop, web and mobile.

ChatGPT

1. Go to chatgpt.com/plugins.
2. Select + › Add custom MCP server.
3. Enter a name and the endpoint URL.
4. Set Authentication to OAuth.
5. Create the plugin, then install it.
6. Sign in with your Quantum Metric account when prompted.

Whether you can add custom MCP servers depends on your ChatGPT plan and your workspace admin's settings.

Cursor

Step 1. Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "felix": {
      "url": "https://api.quantummetric.com/mcp/<subscription>"
    }
  }
}

Step 2. Restart Cursor, open its MCP settings, connect felix, and sign in.

VS Code (Copilot agent mode)

Step 1. Add the server to your user mcp.json, or to .vscode/mcp.json in a workspace. The top-level key is servers:

{
  "servers": {
    "felix": {
      "type": "http",
      "url": "https://api.quantummetric.com/mcp/<subscription>"
    }
  }
}

Step 2. Restart VS Code. A browser window opens for sign-in the first time it connects.

Verify the connection

1. Check that the server shows as connected: claude mcp list in Claude Code, or the connector status in your client's settings.
2. Ask a question that needs your data, such as "List the dashboards in this subscription."
3. Ask your assistant to run get_context. Confirm it shows your subscription, workspace and timezone.

Working with workspaces

Your session starts in your current Quantum Metric workspace and uses your profile timezone, so answers should match what you see in the UI.

To query a different workspace:

1. Ask your assistant to run list_workspaces and find the workspace ID.
2. Ask it to pass that ID as workspace on later calls. The server keeps no state between calls, so the workspace applies per call.

To use a different timezone, ask your assistant to pass timezone on tools that accept it.

Security and data governance

• Access follows your identity. Every call runs as your Quantum Metric account. MCP adds no access beyond what your account has.
• Disconnecting. Remove the server from your client to stop using it. Removing your Quantum Metric access ends access from every client.

Troubleshooting

Getting help

Contact your Customer Success Engineer for help connecting MCP to your AI assistant.

Appendix: tool reference

The server exposes tools across 16 capability areas. Your client retrieves the current list at connect time. Some per-subscription tools, such as Voice of Customer survey tools, appear when enabled for your subscription.