Skip to main content
Adding the Vortex IQ connector to Claude takes under two minutes. You need a Vortex IQ account — the connector signs in with your existing Vortex IQ (Google) login and only ever returns data your account can already see.

​
Claude web and desktop

1

Open Connectors

In Claude, go to Settings → Connectors and click Add custom connector.
2

Enter the server URL

Paste https://app.vortexiq.ai/mcp and confirm.
3

Sign in and allow

A Vortex IQ consent screen opens. Sign in with your existing Vortex IQ (Google) login and click Allow.
4

Start asking

The Vortex IQ tools appear in Claude. Try “List my recent store audits.”
If Vortex IQ is listed in the Claude connector directory, you can add it from there with one click instead of entering the URL manually — the sign-in flow is the same.

​
Claude Code

Add the connector as a remote MCP server from your terminal: 
claude mcp add --transport http vortexiq https://app.vortexiq.ai/mcp
Then run /mcp inside a Claude Code session to complete the OAuth sign-in in your browser.

​
Other MCP clients

Any MCP client that supports Streamable HTTP and OAuth 2.1 with PKCE can connect. Endpoints are machine-discoverable: 
GET https://app.vortexiq.ai/.well-known/oauth-authorization-server
GET https://app.vortexiq.ai/.well-known/oauth-protected-resource
The full flow — dynamic client registration, authorize, token exchange and refresh — is documented in the OAuth developer guide.

​
Verify it works

Each of these prompts exercises a different part of the connector:
  1. “List my recent store audits.” — returns audit runs with id, guid, integration, health score and completion time. Follow up with “Show the findings report for integration <id>.”
  2. “What KPIs are available, and show the 30-day KPIs for <integration>.” — returns the KPI library plus KPI cards and trends for that integration.
  3. “List my active Nerve Centre alerts and give me the 24h incident summary.” — returns active alerts plus summary counts.
  4. “Show my Brand DNA voice and tone guidelines.” — returns your Brand DNA profile.
  5. “Show my Kanban health-fix backlog.” — returns the board state per column.

​
Troubleshooting

Access tokens expire after one hour and refresh automatically; if refresh fails (for example after a long idle period), remove and re-add the connector, or re-run the sign-in from Settings → Connectors. In Claude Code, run /mcp and re-authenticate.
The connector only returns data your Vortex IQ account can access. Check that your role has access to the relevant module (Store Audit, Nerve Centre, Brand DNA and so on) in the Vortex IQ dashboard, and that the organisation actually has data there — for example, at least one completed audit run.
Some list results are capped at the first 50 items (roughly 40k characters) to stay model-friendly. Ask a narrower question or request a specific id to drill into full detail.

​
Support

Questions or issues? Email support@vortexiq.ai.