Skip to main content

Connecting an external AI (MCP)

Besides the built-in AI Analyst, Qubix can be connected to your own AI assistant — Claude Desktop, Claude Code, Cursor or any client that supports MCP (Model Context Protocol). The assistant then answers questions about your campaigns using live data — with exactly the same access and permissions you have in the interface.

What you need​

  • A personal token (PAT) — create it on the MCP/API page. More — MCP/API.
  • Your Qubix address in the form https://<your-domain>/api/mcp.
The token is shown once

The token is shown only at the moment you create it. Copy it right away and keep it safe — Qubix stores only its hash and cannot show it again. Lost it? Press Regenerate to get a new one (the old one stops working immediately).

How to connect​

You need two things: the address https://<your-domain>/api/mcp and the header Authorization: Bearer <your-token>. The rest depends on the client.

Claude Code (CLI)​

Bash
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
  --header "Authorization: Bearer qbx_YOUR_TOKEN"

Restart Claude Code — the Qubix tools become available in the chat.

Claude Desktop​

Open Settings → Connectors → Add custom connector, set the address https://<your-domain>/api/mcp and add the header Authorization: Bearer qbx_YOUR_TOKEN.

Cursor​

Add the server to ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

JSON
{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

What the assistant can do​

Once connected, the assistant can read your analytics and perform actions — all within your permissions:

  • Analytics — the dashboard, geo, offers, networks, traffic sources, the Facebook screens, the visitor funnel, and a drill-down for any single ad, campaign, offer, creative, PWA, geo or traffic source.
  • Creatives — semantic search ("find creatives like a fake-chat screenshot") and the top performing creative themes.
  • Britva — view the automation rules, paused ads and firing history; create, edit and release rules.
  • Actions — pause and resume ads and campaigns; manage offers, networks, traffic sources and tracker campaigns.
  • Free-form queries — for questions the ready-made tools do not cover.
Your data only

The assistant sees exactly what you see in the interface: an admin gets the whole account, a buyer gets only their team's data. Actions are limited by your permissions just like in the admin panel.

Actions are real

Pausing an ad, deleting a rule or an offer through the assistant changes your real campaigns. In chat clients such actions are performed only after your confirmation — read what the assistant proposes before approving.

Security​

  • The token is your access key — treat it like a password, do not put it in shared files or public repositories.
  • One token per user. To revoke access, open the MCP/API page and press Revoke (or Regenerate to replace it).

What's next​

AI Analyst chat

the built-in assistant, no setup needed.

MCP/API

the endpoint, your token and the full method catalog.

AI (overview)

the analyst data behind the tools.

On this page