Connect an AI assistant to BasiQR

You can connect an AI assistant such as Claude to your BasiQR account and ask it about your labels in plain words: “Which collection got the most scans this week?”, “What’s in my Spring collection?”, “Which pieces are people saving to their vault?” It answers from your live figures. If you allow it, it can also do the work for you: “Create a collection for the summer range”, “Add 20 items of the linen shirt”, “Point the summer QR code at the new page”.

Assistants connect through MCP (the Model Context Protocol), an open standard that many AI apps support. You decide what each assistant may do and which collections it may use, and you can change that or disconnect it at any time.

Before you start

• A BasiQR brand account on the Collection or House plan. Connecting AI assistants and your own systems comes with those plans (see pricing).
• API access turned on. If Settings → API keys in the app says API access isn’t enabled, write to us at support@basiqr.com.
• Team members can connect too. The assistant then sees only the collections the account owner shared with them, with the same access they were given.

The address to connect to is:

https://dev.basiqr.com/mcp

What an assistant can see and do

It can read your account the way you see it in the app:

• your collections, products and items, and their history of changes;
• scans and vault saves over the last day, week, month or longer, by product, by day and by country;
• your share links, and the alerts about copied codes;
• what you have left to create with.

With your permission, it can also change things:

• create collections, products and items;
• create QR redirects and share links;
• edit products and items, change where a QR code points, update or remove redirects and share links, and mark alerts as dealt with.

When you connect, you choose one of:

A few things to know before you allow changes:

• Creating collections, products and items uses your plan’s allowance, exactly as it does in the app, and can’t be undone. Redirects, share links and alert statuses cost nothing.
• Claude asks you before every edit or removal.
• Some things are never available to an assistant, whatever you allow: managing API keys, your team or your account.

Connect Claude (sign in with BasiQR)

This works on claude.ai and in the Claude desktop and mobile apps. You sign in to BasiQR, so there is no key to copy.

1. In Claude, open Settings → Connectors and click Add custom connector. On Claude’s Team and Enterprise plans only an Owner can add one; members then click Connect on it.
2. Name it BasiQR and paste the address https://dev.basiqr.com/mcp exactly, with no slash at the end.
3. Leave the advanced settings empty. If Claude offers a choice of OAuth client, keep Claude’s own published identity: BasiQR only accepts Claude’s apps this way.
4. Click Add, then Connect. Claude opens BasiQR. Sign in if you aren’t already.
5. BasiQR shows what Claude is asking for. Choose what Claude may do (see the table above), then All collections or Specific collections (up to 50).
6. Click Approve. You’re back in Claude, and BasiQR is ready in your chats.

The approval page is valid for 10 minutes. If it expires, start again from Claude.

Claude Code

Add the server, then sign in from inside Claude Code:

claude mcp add --transport http basiqr https://dev.basiqr.com/mcp

Run /mcp in a Claude Code session, choose basiqr, then authenticate. Your browser opens the same BasiQR page; it lists the app as Claude Code.

Connect with an API key

Signing in with BasiQR works with Claude’s apps for now. Any other assistant, tool or script that can add a remote MCP server with its own request header connects with an API key instead.

1. In the app, open Settings → API keys and click New key.
2. Give it a name, an expiry date, the collections it may use and what it may do (the same choices as above), then click Create key.
3. Copy the key straight away: it’s shown only once.
4. In your assistant, add a remote MCP server with the address https://dev.basiqr.com/mcp and this header, with your key in place of bqr_…:

Authorization: Bearer bqr_…

For example, in Claude Code:

claude mcp add --transport http basiqr https://dev.basiqr.com/mcp \
  --header "Authorization: Bearer bqr_…"

Keep the key private, like a password: anyone who has it can do what the key allows. Use one key per assistant or tool, so revoking one never breaks the others.

Change or remove access

Every connection is listed in the app.

• Settings → Connected apps shows each app you signed in from (Claude, Claude Code), with its tools, its collections and when it was last used. Edit permissions changes what it may do; Disconnect stops it at once.
• Settings → API keys shows each key. Edit tools changes what it may do; Revoke stops it at once.

A change to what an assistant may do applies to its next request. Claude may keep showing its old list of tools until you start a new conversation.

Limits

• 60 requests a minute for each connection or key. That’s plenty for a conversation; a long run of changes may need a short pause.
• A Claude connection lasts 90 days. After that Claude asks you to approve it again.
• One connection per app. Connecting the same app again, for example from a second Claude account, replaces the first connection.
• To change which collections a connection may use, connect again. What it may do can be changed in place.
• Turning API access off pauses every connection and key on the account until it’s back on.
• Not available to assistants yet: uploading or editing images, and exporting the catalog as a file.

If something doesn’t work

• “Unknown application” on the BasiQR page. The app isn’t one of Claude’s apps. Connect it with an API key instead. In Claude, check the connector’s advanced settings are empty.
• “API access isn’t enabled for this account.” Your plan doesn’t include assistants yet, or access is off. Write to us, then connect again.
• “This connection request was not found or has expired.” It’s older than 10 minutes, or was already answered. Start again from Claude.
• A connection that worked asks you to connect again. It was disconnected, replaced by a newer connection of the same app, or reached 90 days. Connect again.
• “This connection isn’t allowed to use …” The assistant tried something you didn’t allow. Change what it may do in Settings → Connected apps or Settings → API keys, then start a new conversation.
• “Write tools won’t work on …” in Connected apps. Some of the connection’s collections are ones you can only read. Ask the account owner for edit access, or connect again without them.
• A collection is missing from the answers. It wasn’t chosen when you connected, or, for a team member, it isn’t shared with you.
• “Rate limit exceeded.” Wait a minute and try again.

Anything else: write to support@basiqr.com. If a BasiQR page showed a Reference, include it.

Privacy

An assistant reads your BasiQR data only when you ask it something, and only within what you allowed. What the assistant’s maker does with the answers is covered by its own privacy policy. How BasiQR handles your data, including connected apps, is in our privacy policy.