Documentation · MCP

Connect QR Report to your AI agent

With the QR Report MCP server, your AI agent reads your QR codes, campaigns and scan numbers and answers questions about them, right where you already work.

Connector URL

https://qrreport.app/mcp
Read only

At the moment, agents can only read in QR Report: they don’t change codes, destinations or campaigns. If that changes, you’ll find it here first.

Before you start

  1. Check your role

    You are an owner or admin of the organization the agent should read.

  2. Turn on AI agents

    In the organization settings under “AI agents”, set “Access by AI agents” to “Read”. It starts as “Off”.

  3. Connect your agent

    Steps for each agent are under “Setup” below. While connecting, select every organization the agent should read.

Good to know

  • Adding an organization later: reconnect the agent and select every organization you want. Organizations are shared only while connecting.
  • Your agent must allow custom connectors (MCP servers). On team and company plans, an admin often has to turn this on first.

Setup

It works the same way for every agent: add the connector URL, sign in to QR Report in your browser, choose organizations, allow. You only enter your password on qrreport.app, never in the agent. There are no API keys to copy.

Agent providers rename their menus often. If an item is called something else for you, look for “Connectors”, “Apps” or “MCP”.

ChatGPT

  1. In ChatGPT, open Settings → Apps & Connectors (“Connectors” or “Apps”, depending on the version) and create a custom MCP connector.
  2. Name: QR Report. URL: https://qrreport.app/mcp. Authentication: OAuth.
  3. Leave client ID and client secret empty. ChatGPT signs in with its own identifier, which QR Report has on file.
  4. Save and choose “Connect”. ChatGPT opens the QR Report sign-in.

Connector URL

https://qrreport.app/mcp

Then: Sign in in your browser → choose organizations → Allow.

Connect once: the connection belongs to your account with the agent provider, not to a device.

In Business and Enterprise workspaces, an admin may have to allow custom connectors first.

After QR Report’s tools or your shared organizations change, ChatGPT often keeps showing the old state, even in new chats. What usually helps is to remove the connector in ChatGPT, connect it again and open a new chat.

Claude (web and desktop)

  1. In Claude, open Settings → Connectors and choose “Add custom connector”.
  2. Name: QR Report. URL: https://qrreport.app/mcp. Leave the advanced OAuth fields empty.
  3. Choose “Connect”. Claude opens the QR Report sign-in.

Connector URL

https://qrreport.app/mcp

Then: Sign in in your browser → choose organizations → Allow.

Connect once: the connection belongs to your account with the agent provider, not to a device.

In Team and Enterprise workspaces, a workspace owner may have to add the connector; after that, each person connects their own QR Report account. Claude Desktop uses the same connector as Claude on the web.

Grok

  1. On grok.com, open Connectors and choose “New Connector” → “Custom”.
  2. URL: https://qrreport.app/mcp.
  3. Connect. Grok opens the QR Report sign-in.

Connector URL

https://qrreport.app/mcp

Then: Sign in in your browser → choose organizations → Allow.

Connect once: the connection belongs to your account with the agent provider, not to a device.

Grok signs in through Cursor’s connector service, so the consent page shows cursor.com addresses. That is correct if you just started the connection in Grok yourself.

The consent page

Before the agent can read anything, QR Report shows a consent page. Check it briefly:

  • Client and domain: which agent wants to connect (e.g. ChatGPT, chatgpt.com) and where the sign-in code goes. QR Report only accepts agents it has reviewed and put on file.
  • “Did you just start this connection yourself?” If not, deny. Someone may have sent you a link that isn’t yours.
  • Organizations: choose every organization the agent should read, and only those. New organizations are never added automatically.
  • Permissions: always “read only”.
  • If you connect the same agent again, the new consent replaces the old one and your previous organizations are preselected. Only the selection on this page counts.

Tools

The MCP server offers these tools to your agent. The agent picks the right one for your question.

list_organizationsRead only
the shared organizations with their time zone and your role60 calls/min, 2,000/day per connection
list_qr_codesRead only
an organization’s codes: name, short code, destination URL and status, newest firstup to 50 per page · 60 calls/min, 2,000/day per connection
get_qr_codeRead only
one code in detail: status, scan address, assigned campaigns, scans in the last 7 and 30 daysscans for 7 and 30 days · 60 calls/min, 2,000/day per connection
get_scan_statsRead only
scans and estimated visitors for a period (up to 366 days), for the organization or one codeperiod up to 366 days, no future dates; per-code totals up to 50 per page · 60 calls/min, 2,000/day per connection
list_campaignsRead only
campaigns with status, period and number of codesup to 50 per page · 60 calls/min, 2,000/day per connection
get_qr_code_imageRead only
the graphic of an active code, same as the QR Report download (colors, shapes, icon or logo): as SVG for print and files or as PNG to show in the chatactive codes only; PNG at 512, 1024 or 2048 pixels · 60 calls/min, 2,000/day per connection
mcp_healthcheckRead only
only a check that the connection works60 calls/min, 2,000/day per connection

Read onlyReads data, changes nothing.

What the agent sees – and what it doesn’t

The agent sees

  • only the organizations you share when connecting,
  • QR codes with name, short code, destination URL and status, the graphic of active codes, plus campaigns with status, period and number of codes,
  • scans and estimated visitors as totals per day, week or month, for the organization or one code.

The agent doesn’t see

  • individual scans, IP addresses, devices or locations, and no breakdown by country or city,
  • organizations you haven’t shared, even if you are a member there,
  • your password, payment details or member lists,
  • any way to create, change, pause or delete anything.

Numbers match the web view: same counting rules, same organization time zone and the same visible period as your plan. If your plan limits a period, QR Report tells the agent. Periods go up to 366 days at a time; long lists come in pages (up to 50 entries).

How the agent explains or calculates with the numbers is up to the agent. When in doubt, check important numbers in QR Report.

Connected apps

Your connections

Under Settings → AI agents → Your connections you see every connection you made yourself: agent, shared organizations, when it was connected, when it was last used and when it ends at the latest. This works for every member, not only owners and admins.

“Disconnect” ends the connection right away after a confirmation, for all of its organizations; the agent gets no more data after that. Disconnecting only in the agent does not end the consent in QR Report, so always disconnect here as well.

Signing out of QR Report doesn’t disconnect your agent – use “Disconnect” for that. Changing your password ends all agent connections.

To change organizations or add one: reconnect the agent and select every organization it should read on the consent page. Your previous ones are then preselected.

Open your connections

In the organization: AI agents

Owners and admins decide in the organization settings under “AI agents” whether agents may read the organization (“Access by AI agents”: “Off” or “Read”). The setting starts as “Off”. While it is “Off”, no agent reads from this organization; after switching back to “Read”, a new consent is needed, so reconnect.

Transparency in your team: owners and admins see there which members have connected an agent to the organization (agent, connected on, last used, ends on) and can remove any consent. For client organizations of an agency, agency staff appear without name and email.

A connection ends on its own

  • 90 days after the consent at the latest (then simply reconnect),
  • when you change your QR Report password,
  • for one organization, when you leave it or are no longer an owner or admin there.

Security and protocol

For those who want to look closer:

Why no API key?

QR Report connects agents only via OAuth: every connection is bound to your account and the organizations you shared, expires on its own and can be revoked in QR Report immediately. An API key would have none of that – it would sit in plain text on your computer, never expire and be tied to no person and no consent.

  • Stateless: https://qrreport.app/mcp speaks Streamable HTTP without sessions; every request carries its own token.
  • Without a valid token, the server answers 401 with a WWW-Authenticate header pointing to /.well-known/oauth-protected-resource. The authorization server is https://qrreport.app (/.well-known/oauth-authorization-server).
  • Client registration via Client ID Metadata Documents (CIMD), pinned: QR Report only accepts client URLs it has reviewed, with redirect URIs on file, and never fetches third-party documents. There is no open Dynamic Client Registration. Grok uses Cursor’s client document (cursor.com).
  • Authorization code flow with PKCE (S256) and the resource parameter, scope mcp:read.
  • Opaque tokens bound to the audience https://qrreport.app/mcp. QR Report only stores a hash, never the token itself.
  • Access token: 15 minutes. Refresh tokens rotate on every use and expire after 30 days without use; if a refresh token that was already used is presented again, the connection ends. A connection lasts 90 days at most.
  • Changing your password in QR Report ends all agent connections. A revocation takes effect on the agent’s next call.
  • No API keys: there are no long-lived keys and no full-access credentials to copy. The agent never gets your QR Report password.

The agent sees the answers – treat them like any other information from your account; what the agent provider does with them is governed by its privacy terms. Values in answers (names, URLs) are data, not instructions to the agent.

Your agent provider sees the answers

What QR Report sends to the agent is processed by the provider (e.g. OpenAI, Anthropic or xAI) under its own terms. Check its privacy notice and settings, and only share organizations whose data may go there.

Text in your data is data

Code names, campaign names and destination URLs are written by people on your team. QR Report marks them as data, not instructions, for the agent and removes hidden control characters. If your agent has other tools, still keep an eye on what it does with this content.

Example questions for your agent

  • “Which codes had the most scans last week?”
  • “Compare scans in September with August for the whole organization.”
  • “Which campaigns are running right now, and how many codes does each have?”
  • “Summarize how scans developed over the last three months for my weekly report.”

Troubleshooting

401Not signed in: the connection expired, was revoked or ended after 90 days, or you changed your password.Reconnect the agent. For ChatGPT, remove the connector and add it again if needed.
403Not allowed: the request came from an origin QR Report doesn’t accept, or the consent page was submitted outside the sign-in flow.Start the connection again in the agent instead of opening an old link.
415Wrong format: the token endpoint only accepts form or JSON requests. This is a client issue, not your account.Update the agent; if the error persists, email us.
429Too many calls: more than 60 tool calls per minute or 2,000 per day on this connection.Wait briefly; the response says how long. If that doesn’t help, narrow the question.
503Temporarily unavailable: agent access is briefly switched off, for example for maintenance.Try again later; your connection stays in place.

Organization missing from the list

The consent page only lets you choose organizations that have “Access by AI agents” set to “Read” and where you are an owner or admin. If the setting was just turned on or the organization is new, reconnect the agent and select it.

Help

Something doesn’t work or looks odd? Disconnect under Settings → AI agents → Your connections and email us at support@qrreport.app. We answer setup questions at the same address.