PlatformSolutionsPricing PlansResourcesCompany
LoginGet my demo

Platform

Coffee image

Platform overview

Learn more about Quantum Metric.

Data

Session replayUnderstand the "why" behind customer behaviors. Segment builderSlice your audience with nested segment building. AutocaptureCapture over 300 metrics out-of-the-box.Page performanceDiscover and quantify the impact of slow pages. User analyticsUnlock better user adoption, retention, and customer journeys.Platform intelligenceOur powerful machine learning engine.Mobile app analyticsPatented mobile analytics technology.Adobe Experience Platform Connector Go live with CJA faster.

Insights

Felix AI AgenticAutonomous agents analyze every part of the customer journey.Felix AI SummarizationGen AI powered session summarization.JourneysUnderstand which paths customers are taking.Interaction heatmapsVisualize page-level clicks, scrolls, and attention.VisibleVisualize user behavior directly from your browser. DashboardsOrganize and monitor your most important data. Opportunity analysisAutomatically surface and quantify friction points.

Action

Voice of CustomerConnect feedback to behavior and take action in real time.MCPLet AI agents see where customers struggle.Monitoring & alertsAlerting on aggregate behavior, frustration, and more.Data activationSeamlessly merge any data source.Data streamingSend Quantum Metric insights to your data warehouse.Data enrichmentGet greater impact with enhanced data insights.Salesforce Lightning analyticsGain visibility and understanding of Salesforce Lightning app users.Performance & overheadLightweight SDKs and tags.Security & privacyBest in class security technology and polices.

See for yourself.

Schedule a personalized discussion and walkthrough of our solution.

Talk to our team.

Schedule a personalized discussion and walkthrough of our solution.

Join a regularly streamed demo of our top features and use cases.

Watch a live demo.

Join a regularly streamed demo of our top features and use cases.

Review platform use cases and capabilities at your own pace.

Browse product tours.

Review platform use cases and capabilities at your own pace.

Solutions

By industry

RetailUnderstand shoppers’ needs faster.Financial servicesDrive digital adoption and improve satisfaction.Travel & hospitalityGrow revenue and loyalty with real-time visibility.TelcoImprove the digital-first experience.GamingUnderstand real-time player behavior.HealthcareImprove patient self-service and loyalty.

By teams

ProductUnderstand any part of the digital experience in seconds.TechnologySurface and scope customer technical friction in real-time.MarketingStrengthen your campaigns and convert more.AnalyticsAnswer the “why” behind the customer experience.CX & VoCBring together qualitative and quantitative insights.UXDeep insight into behavior, engagement, and friction.Service & supportImprove customer empathy and contact center efficiency.

By capability

Digital analyticsMonitor, diagnose, and optimize critical experiences.Product analyticsUnderstand user behavior and drive adoption.Experience analyticsSurface pain points and quantify opportunities.Journey analyticsInsights into every touchpoint across the digital journey.Web analyticsUnderstand and report on digital performance.Employee experienceAutomatically surface critical friction on your internal apps and kiosks.Contact centerOptimize contact center experiences.AI Agent VisibilityReveal how AI agents interact with your digital experience.

See for yourself.

Schedule a personalized discussion and walkthrough of our solution.

Talk to our team.

Schedule a personalized discussion and walkthrough of our solution.

Join a regularly streamed demo of our top features and use cases.

Watch a live demo.

Join a regularly streamed demo of our top features and use cases.

Review platform use cases and capabilities at your own pace.

Browse product tours.

Review platform use cases and capabilities at your own pace.

Resources

Learn

ResourcesReview expert guidance and new data. Case studiesDiscover our customer stories.Product tour libraryReview platform use cases and capabilities at your own pace. Events & webinarsJoin us for live or virtual events. BenchmarksReview the top findings from Quantum Metric aggregated platform data.BlogThought leadership, trends, and product insights.Digital Analytics FAQGet quick answers to foundational digital and product analytics questions.

Community

The QuadConnect with experts, converse, and be inspired.

New blog post.

AI assistants vs. agentic AI: Key differences in digital analytics.

AI assistants vs. agentic AI: Key differences in digital analytics.

Learn how understanding the distinction between AI assistants and agentic AI becomes essential for everyone working in digital experience, analytics, or strategy.

Read the blog

Company

About us

Our storyHow Quantum Metric started, our leadership team, and how you can get involved.CareersSee what it's like to work for Quantum Metric, and available positions.NewsRead the latest announcements and news.

Partner network

Partners & integrationsView our technology and solutions partners.Partner programOur key ecosystem of partners.

Latest news.

Quantum Metric Launches Next Evolution of Felix Agentic, Expands Agentic Analytics and Digital Visibility Across Enterprise Teams

Quantum Metric Launches Next Evolution of Felix Agentic, Expands Agentic Analytics and Digital Visibility Across Enterprise Teams

Learn more

Docs
Docs home
Felix Agentic Analyst
Skills & How They Power Your Felix AnalysisUnderstanding Workflows (Agentic Reports)Directives: An agent that works for youFelix in Slack
MCP (Model Context Protocol)
MCP: Connect via integration tokenMCP: Connect via OAuth (Interactive Sign-in)
LoginGet a demo

Platform

Platform overviewFelix AI AgenticFelix AI SummarizationJourneysMobile app analyticsInteraction heatmapsSecurity & privacy

By industry

RetailFinancial servicesTravel & hospitalityTelcoGamingHealthcare

By teams

ProductTechnologyMarketingAnalyticsCX & VoCUXService & support

By capability

Digital analyticsProduct analyticsExperience analyticsJourney analyticsWeb analyticsEmployee experienceContact centerAI Agent Visibility

Resources

Contact usProduct tour libraryPricing plansResourcesCase studiesGlossary
Privacy PolicyTerm of UseEULAPatentsSubprocessorsLegal InformationModern Slavery StatementDo Not Share My Information

© 2026 Quantum Metric, Inc. All rights reserved. Third-party names and logos are trademarks of their respective owners.

Docs/MCP (Model Context Protocol)/MCP: Connect via integration token

MCP: Connect via integration token

Updated November 18, 20266 min read

Overview

The Quantum Metric MCP Server connects your Quantum Metric subscription to AI assistants and automated systems through the Model Context Protocol (MCP), an open standard for giving AI tools structured access to external systems.

Once connected, an AI client can query behavioral data, investigate sessions and errors, run funnels and saved queries, and trigger the workflows and Background Agents you have built in Quantum Metric.

This guide covers integration tokens: credentials that let an automated system call Quantum Metric MCP with no person present. Use them for scheduled analysis, experiment read-outs, automated remediation and agent frameworks.

What an integration token is

An integration token is a credential for your subscription. Your automation sends it with every request.

Property

Integration token

Acts as

A service account for your subscription

Set up by

Quantum Metric

Lifetime

Until it is revoked

Workspace and timezone

None bound by default; set per call

Before you begin

You need:

  • An active Quantum Metric subscription.
  • Your subscription name, as it appears in your Quantum Metric URL.
  • An MCP-capable client: Claude Code, Claude (desktop and web), ChatGPT, Cursor, VS Code, Gemini CLI, or any client that implements MCP.

Endpoints

US: https://api.quantummetric.com/mcp/<subscription>
Europe and Middle East: https://api-eu.quantummetric.com/mcp/<subscription>
Asia Pacific: https://api-ap.quantummetric.com/mcp/<subscription>

Replace <subscription> with your subscription name. If you are unsure which region your subscription is hosted, contact your account team to confirm.

Getting an integration token

MCP tokens are created by Quantum Metric. Talk to your Customer Success representative to get one for your subscription.

Connect with an integration token

Send the token as a bearer credential to the endpoint with your subscription in the path.

Authorization: Bearer <your-integration-token>

Claude Code:

claude mcp add --transport http --header "Authorization: Bearer <your-integration-token>" felix https://api.quantummetric.com/mcp/<subscription>

Clients that take JSON configuration:

{
  "mcpServers": {
    "felix": {
      "type": "http",
      "url": "https://api.quantummetric.com/mcp/<subscription>",
      "headers": {
        "Authorization": "Bearer <your-integration-token>"
      }
    }
  }
}

Note: If you get a 400 error, ensure you are sending with the correct subscription.

Verify the connection

  1. In Claude Code, run claude mcp list. The felix server should show as connected. Other clients show connection status in their MCP or connector settings.
  2. Ask a question that needs your data, such as "List the dashboards in this subscription."
  3. Call get_context and confirm the subscription is the one you expect.

Set your workspace and timezone on every call

A token session has no user profile, so it has no default workspace and runs in UTC. Pass both values on every call.

  • Workspace is required. Team workspaces, and any segment attached to them, scope what a query sees. A data call without workspace fails with Error: no workspace set. Pass the workspace parameter (list_workspaces shows the options).
  • Timezone defaults to UTC. Pass timezone as an IANA name, such as America/New_York, so "yesterday" and daily breakdowns line up with your business day.

If automated numbers disagree with numbers a colleague pulled in the Quantum Metric UI, compare the workspace and timezone first. The UI uses their workspace and their own timezone.

Step 1: find the workspace ID. Call list_workspaces; it returns each workspace's id and name. Or resolve a name directly:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "switch_workspace",
    "arguments": { "workspace": "Checkout Team" }
  }
}

The reply gives the exact workspace value to pass. It changes nothing on the server.

Step 2: pass workspace and timezone on each call. For example, a run_query call:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "run_query",
    "arguments": {
      "query": "Conversion rate by device type",
      "time_phrase": "yesterday",
      "workspace": "<workspace-id>",
      "timezone": "America/New_York"
    }
  }
}

The same two arguments work on run_saved_query, run_funnel, execute_dashboard_card and the other data tools. create_saved_query is the exception: it takes workspace_id.

If an AI agent makes the calls, put the values in its instructions, for example:

On every Felix tool call that accepts them, pass workspace: "<workspace-id>" and timezone: "America/New_York".

Step 3: check what answered. Workspace-scoped responses echo the workspace that answered. run_saved_query also returns workspace_id, workspace_name and workspace_filter_applied.

Building autonomous workflows

An integration token makes calls as your subscription's service account. The automation's access does not depend on any person's session or employment.

Know what each call does

Kind

Tools

What to know

Read

Nearly all tools

Return data. No state changes.

Create

create_saved_query

Saves a new saved query in your subscription.

Invoke

run_monitoring_agent, execute_workflow

Run an agent or workflow saved in Felix. Its side effects are whatever its author configured: notifications, deliveries, downstream actions.

Before you put an invoke tool in an unattended loop, confirm what that agent or workflow does when it runs.

Confirm your scope

  • run_saved_query returns a context block with workspace_id, workspace_name and workspace_filter_applied. workspace_filter_applied: false means the workspace has no segment filter; the workspace still applies.
  • To confirm empirically, count a value your workspace segment excludes in All Traffic and in the workspace, and compare.

Handle failures by status code

  • 400: configuration error in the URL. Retrying will not fix it.
  • 401: credential problem. Check the token value and replace it if revoked.
  • 403: the token is valid but missing Felix MCP access. Alert a person; retrying will not fix it.

Troubleshooting

Symptom

Cause

Fix

Client connects, but no tools appear

The client loads MCP configuration only at startup

Restart the client. Confirm the URL is https://api.quantummetric.com/mcp/<subscription>.

400, message about a missing subscription

Token sent to a URL with no subscription in the path

Add your subscription to the URL.

401 invalid token

Token value mistyped or revoked.

Copy the token value again from Integration Settings.

403, token lacks the felix_mcp scope

Token created without Felix MCP ticked

Ask your Customer Success contact to turn on Felix MCP for the token. Wait a minute before retrying.

Browser login opens when using a token

The Authorization header was not sent

Re-add the server with the header.

Results differ from the Quantum Metric UI

Different workspace, or the call ran in UTC

Run get_context; pass workspace and timezone on each call.

"Error: no workspace set"

Token sessions have no default workspace

Pass workspace with an ID from list_workspaces.

Unrecognized parameter

Tools reject parameters they do not define

Check the name against the tool definition, e.g. workspace, not workspace_id.

Query times out

Analytics queries are limited to 120 seconds

Narrow the time range, add filters, or use a saved query.

Query returns no data

Wrong workspace, time range or event name

Confirm workspace, time range in the session timezone, and that the events exist.

Getting help

Contact your Customer Success Engineer for help connecting MCP to your systems or enabling token access settings.

Appendix: tool reference

The server typically exposes tools across 16 capability areas. The list may change as the product develops; your client retrieves the current list at connect time. Some per-subscription tools, such as Voice of Customer survey tools, are unavailable to integration tokens.

A tool call is one authenticated tools/call request to the Quantum Metric MCP server.

Area

What it covers

Workspaces

List team workspaces and resolve one to its ID

Context

Subscription, workspace, timezone and profile for the session

Analytics

Ad-hoc queries of behavioral and performance data

Saved Queries

List, run and create saved queries

Sessions and users

Session and user summaries, replay URLs, page hits, replay screenshots

Business Concepts

The business concept model configured for the subscription

Events

Event definitions, event discovery and event value search

Catalog

Metrics and dimensions available to query

Dashboards

List and inspect dashboards; run individual cards

The Quad

Search and read Quantum Metric knowledge base articles

Knowledge

Analytics skills and guidance available to the assistant

Page Discovery

Resolve a page name to an analytics filter

Funnels

List and run funnels; analyze step drop-off

Background Agents

List and run background agents; read results

Workflows

List and run workflows; read runs and reports

Alerts

Alerts, incidents, time series and affected sessions

Was this page helpful?
← PreviousFelix in SlackNext →MCP: Connect via OAuth (Interactive Sign-in)
On this page
OverviewWhat an integration token isBefore you beginEndpointsGetting an integration tokenConnect with an integration tokenVerify the connectionSet your workspace and timezone on every callBuilding autonomous workflowsKnow what each call doesConfirm your scopeHandle failures by status codeTroubleshootingGetting helpAppendix: tool reference
Contact usBack to top