AI assistants
Connect EZQR to Claude, ChatGPT, Claude Code, Cursor and other MCP apps to manage QR codes and read analytics in conversation.
EZQR runs a hosted Model Context Protocol (MCP) server. Connect it to your AI assistant or coding agent and ask it to create QR codes, change where dynamic codes point, or summarize scans, leads and business cards, limited to the permissions you grant.
AI connections need API access, which is on the Max plan.
Choose how to connect
Go to Settings → AI connections. Under Connect an AI app, choose your app and one of two ways to connect.
| Sign in with EZQR | Workspace key | |
|---|---|---|
| Best for | Most apps (recommended) | Apps that can't sign in |
| Who it acts as | Each person, with their own role | The owner or admin who generated the key |
| Permissions | Approved on a consent screen | Chosen when the key is generated |
| Server URL | https://mcp.ez-qr.com/mcp | https://mcp.ez-qr.com/mcp/<key>, or the server URL plus an Authorization header |
| Revoke | Disconnect the app | Rotate or remove the key |
Sign in with EZQR
Add https://mcp.ez-qr.com/mcp to your app. The first time it connects, your browser opens an EZQR consent screen that shows the app, the workspace and account it will connect to, and the permissions it's asking for. Click Allow access to connect.
Each person connects as themselves, so the assistant works with your own QR codes and the leads and cards you can see.
Workspace key
The workspace MCP key is a single key for the whole workspace, for apps that can't sign in. It only works with the MCP server, not the REST API.
Only owners and admins can generate, reveal, rotate or remove it. Actions made with the key are recorded in the audit log under the name of the person who generated it.
Under Workspace MCP key, click Generate workspace key.
Choose the permissions the key should have, then click Generate key.
Click Reveal to show the key URL, then copy it into your app's setup.
For apps that take a URL, the key is part of the URL, so anyone with it can use your workspace. Keep it private, and keep config files that contain the key out of version control.
Rotate replaces the key straight away. Apps using the old key stop working until you update them. Remove deletes the key.
Set up your app
The setup card in Settings → AI connections fills in the exact config for your app. The steps below use sign-in. With a workspace key, Claude and ChatGPT use the key URL instead, and the other apps add an Authorization: Bearer <key> header.
In Claude, open Settings → Connectors → Add custom connector and paste:
https://mcp.ez-qr.com/mcpWhat your assistant can do
Each tool needs a permission. Your assistant only sees the tools its connection has been granted.
| Tool | What it does | Permission |
|---|---|---|
get_workspace | Shows which workspace the connection acts in and what it's allowed to do | None |
list_qr_codes | Lists QR codes you created, newest first, with destination, scan link, status and scan count | qr:read |
get_qr_code | Gets one QR code's details, including its schedule | qr:read |
create_qr_code | Creates a dynamic or static QR code for a link or other content | qr:write |
update_qr_code | Renames a code, changes a dynamic code's destination, or pauses and resumes it | qr:write |
get_qr_analytics | Scan analytics for one code or the whole workspace over 7, 30, 90 or 365 days. Bots are counted separately | analytics:read |
list_leads | Lists the newest 50 leads and contacts, with answers. Filter by search, form, card or tag | leads:read |
list_cards | Lists business cards with their link, holder and view, save and exchange counts | cards:read |
Permissions
| Permission | Grants |
|---|---|
qr:read | See your QR codes, destinations and their status |
qr:write | Create QR codes and change where dynamic codes point |
analytics:read | See scan analytics |
leads:read | See leads and contacts you've collected |
cards:read | See your digital business cards |
QR code tools work with the QR codes created by the connected person. With a workspace key, that's the person who generated the key. Your plan limits still apply, so the assistant can't create more dynamic codes than your plan allows.
Each connection can make up to 120 requests per minute.
Disconnect an app
Go to Settings → AI connections. Under Apps you've connected, click Disconnect next to the app. It loses access straight away.
This list shows apps you signed in to with your own account for the current workspace. To cut off apps using the workspace key, rotate or remove the key.
If someone is removed from the workspace, their connections stop working.