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 EZQRWorkspace key
Best forMost apps (recommended)Apps that can't sign in
Who it acts asEach person, with their own roleThe owner or admin who generated the key
PermissionsApproved on a consent screenChosen when the key is generated
Server URLhttps://mcp.ez-qr.com/mcphttps://mcp.ez-qr.com/mcp/<key>, or the server URL plus an Authorization header
RevokeDisconnect the appRotate 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/mcp

What your assistant can do

Each tool needs a permission. Your assistant only sees the tools its connection has been granted.

ToolWhat it doesPermission
get_workspaceShows which workspace the connection acts in and what it's allowed to doNone
list_qr_codesLists QR codes you created, newest first, with destination, scan link, status and scan countqr:read
get_qr_codeGets one QR code's details, including its scheduleqr:read
create_qr_codeCreates a dynamic or static QR code for a link or other contentqr:write
update_qr_codeRenames a code, changes a dynamic code's destination, or pauses and resumes itqr:write
get_qr_analyticsScan analytics for one code or the whole workspace over 7, 30, 90 or 365 days. Bots are counted separatelyanalytics:read
list_leadsLists the newest 50 leads and contacts, with answers. Filter by search, form, card or tagleads:read
list_cardsLists business cards with their link, holder and view, save and exchange countscards:read

Permissions

PermissionGrants
qr:readSee your QR codes, destinations and their status
qr:writeCreate QR codes and change where dynamic codes point
analytics:readSee scan analytics
leads:readSee leads and contacts you've collected
cards:readSee 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.