Connecting an AI Assistant (MCP Setup)

Connecting an AI assistant to your QR codes

The whole setup is a URL and a token, pasted into your assistant once. This walks through it for each of the common clients, and explains what the connection can and cannot do.

Create an account to get a token A scan analytics dashboard: a rising bar chart next to a world map dotted with scan locations.

Claude (desktop, web, and Claude Code)

In the Claude apps, open Settings → Connectors and choose Add custom connector. The server URL is https://mcp.getdynamicqr.com, and your token goes in an Authorization header with the value Bearer followed by a space and the token.

In Claude Code, the same connection is a line in your MCP config: an entry with "type": "http", the url, and the same Authorization header. Your dashboard prints the whole block ready to copy, with a placeholder where the token goes.

Either way, Claude will list the available tools once it connects. If it shows nothing, the token is usually the cause — a revoked one and a mistyped one look identical from the client side.

ChatGPT

ChatGPT supports MCP servers as connectors. Add a new one, give it the server URL, and supply the token as a bearer credential when it asks for authentication.

The tools it gets are exactly the ones Claude gets — the server does not know or care which assistant is on the other end, beyond recording the name so your dashboard can tell you what is connected.

Cursor, Windsurf, Zed, Cline and other editors

These all read a JSON config file listing MCP servers. The block is the same shape in each: a name for the server, "type": "http", the URL, and an Authorization header carrying Bearer and your token.

Your dashboard shows this block filled in for your own install, so it is a copy and one substitution rather than something to assemble by hand. After saving the config, restart the editor — most of them read MCP servers at startup only.

What to ask once it is connected

The useful questions are the ones that are awkward in a dashboard:

  • "Which of my QR codes got the most scans this month?"
  • "Which codes have never been scanned?" — usually the most valuable one, because a code with no scans is either somewhere nobody looks or printed wrong.
  • "Point the café menu code at https://…/autumn-menu.pdf"
  • "Create a code for the new booking page and put it in the Events folder"
  • "Pause the summer promotion code — the landing page is down"

The assistant will show you each action before it takes it. Re-pointing a code takes effect for every printed copy within seconds.

If it is not connecting

Three things account for nearly every failure. The token — it is shown once and never again, so a half-copied one is common; make a new one rather than hunting for the old one. The plan — the connection refuses with a readable message on plans that do not include AI assistant access, and your assistant will show you that message. The header — it has to be Authorization: Bearer <token>, with the word Bearer and a space in front.

Your AI Assistants page lists everything that has ever connected, with the time it was last active. If nothing appears there, the handshake never reached us, which points at the URL or the header rather than at anything on this side.

What you need before you start

Two things, and one of them takes a click.

An account on a Pro or Team plan

AI assistant access rides those two tiers. Everything else here works the same whichever assistant you use.

A token

Made in the dashboard under AI Assistants. Shown once, because only a one-way hash of it is stored — copy it before closing the tab.

The server URL

This install serves MCP at <code>https://mcp.getdynamicqr.com</code>. Your dashboard shows it again alongside a ready-made config block for editors.

An MCP client

Claude, ChatGPT, Cursor, Windsurf, Zed, Cline — anything that supports custom MCP servers.

Built for

Clients this has been set up against.

Claude ChatGPT Claude Code Cursor Windsurf Zed

The short version

Five steps, once.

1

Sign in and open AI Assistants from the dashboard sidebar.

2

Create a token and name it after the machine or app it will live in.

3

Copy the token immediately — it is not recoverable afterwards.

4

In your assistant, add a custom MCP server with our URL and the token as a bearer header.

5

Ask it "which of my QR codes were scanned this week?" to confirm it works.

Questions people ask

Straight answers to what usually decides whether this is the right tool for the job.

Where do I find the server URL?
On the AI Assistants page in your dashboard, next to the config block. It is the same address for every account — what identifies you is the token, not the URL.
I lost my token. Can I get it back?
No, and neither can we — only a one-way hash of it is stored, which is what stops a database copy being a set of live credentials. Create a new token and paste that one in instead; revoke the old one while you are there.
Can I connect more than one assistant?
Yes, and it is the better way to do it: create a separate named token for each, so revoking the one on a laptop you no longer have does not unplug the rest. Your dashboard lists each connection with what it is and when it was last active.
Does the assistant see my whole account?
It sees your QR codes, folders and scan analytics, and it can create codes, re-point them and pause them. It cannot delete anything, cannot reach your password or billing, and cannot see any other account.
What happens if my plan lapses?
The connection stops working and your assistant is told why, in a sentence it can read back to you. Your tokens stay listed so you can revoke them, and upgrading again makes them work with no change at your end.

Need an account first?

Free plan available forever. No credit card required. Get started in under 60 seconds.

Create an account to get a token