Skip to main content
Logo

Setting Up AI Access

Add-on required. This feature requires the AI MCP add-on to be active on your store. View add-ons

This guide walks you through creating a new AI Connection, approving it from your browser, and connecting it to your AI tool. For a dedicated Claude Desktop walkthrough, see Connecting Claude Desktop.

Before You Start

  • You need Owner or Admin access to the store you want to connect.
  • You need the AI tool's redirect URI. This is a URL the AI tool gives you for its own connector (look in its documentation — Claude Desktop and ChatGPT both list theirs).
  • The AI MCP add-on must be active on your store.

Creating a New Connection

1

Open the sidebar menu and go to Store SettingsAI Connections.
2

Tap Create. A full-screen form opens with three sections: Basics, Client, and Access.
3

Enter a descriptive Name like "Claude Desktop - Finance Review". You will see this name later in the list.
4

Pick a Preset. Choose Claude Desktop, Claude Code, ChatGPT, Cursor, or Custom. The preset auto-fills the redirect URI and the Public/Confidential setting for you — you can still edit them afterwards.
5

Confirm or edit the Redirect URIs. For Claude Desktop and ChatGPT, paste the URL their connector dialog gave you. For Claude Code and Cursor, the preset already fills in the loopback URL each CLI uses. You can add up to 5 URIs.
6

Confirm the Connection Type. Public (PKCE, no secret) is the right choice for desktop AI apps and CLI tools. Confidential (issues a client secret) is only for server-to-server scripts.
7

Select the Permissions the AI needs. Grant only what you are comfortable sharing.
8

Tap Create. You will see your Client ID (and Client Secret, if Confidential) in a one-time reveal dialog — copy them before closing it.

What does the Preset do?

For Claude Code and Cursor, the preset fills in a http://127.0.0.1:<port>/callback loopback redirect URI that both CLI tools use out of the box, and sets the connection to Public (PKCE). For Claude Desktop and ChatGPT, the preset sets Confidential and leaves the redirect URI blank so you can paste the URL their "Add custom connector" dialog gave you. Pick Custom if your AI tool is not in the list.

Public vs Confidential in plain terms

Public connections use PKCE (a cryptographic proof-key exchange) and do not issue a client secret — they are simpler and fully supported by every modern AI tool. Confidential connections issue a client secret you paste alongside the Client ID; they are slightly more robust for AI tools that can safely store the secret (desktop apps and backend scripts). The preset picks a sensible default for each AI tool; you can always toggle it.

Secrets are shown only once

If you chose Confidential, the Client Secret is displayed exactly once after you create the connection. Copy it immediately and store it somewhere safe. If you lose it, you must delete the connection and create a new one.

Form Field Reference

NameRequired

A descriptive label so you can identify the connection later.

Example: Claude Desktop - Finance Review

PresetRequired

Pick the AI tool you are connecting. Auto-fills the redirect URI and connection type. Pick Custom for tools not in the list.

Example: Claude Desktop

Redirect URIsRequired

1 to 5 URLs the AI tool uses to receive the authorization code. The preset pre-fills this for CLI tools (Claude Code, Cursor) with a loopback URL. Desktop AI apps accept http://localhost and http://127.0.0.1 URLs; other URLs must be https:// in production.

Example: http://127.0.0.1:33418/callback

Connection TypeRequired

Public (PKCE, no secret) or Confidential (issues a client secret). The preset picks a sensible default; you can toggle it.

Example: Public

PermissionsRequired

One or more of the six read-only scopes. Grant only what the AI needs.

Example: read:orders, read:reports

Approving the Connection

After the connection exists in Fuze Store and you have your Client ID, switch to your AI tool to finish the handshake.

1

Paste the Client ID into your AI tool's connector form. Paste the Secret too, if you chose Confidential.
2

Start the connection from your AI tool. It opens your default browser.
3

You land on a Fuze Store consent screen showing the client name, the store, and the list of requested permissions.
4

If you own multiple stores, pick the one you want to connect.
5

Review the permissions carefully. If anything looks wrong, tap Reject.
6

Tap Approve. The browser returns to your AI tool, which shows "Connected".
7

Start asking questions. The AI will now read the data you approved.

Sign into Fuze Store first

If the consent screen asks you to log in, enter your Fuze Store credentials. Once you are signed in, the consent flow resumes automatically. You only need to do this once per session.

Managing Your Connections

The AI Connections list shows every connection you have created. Each entry includes the name, connection type, and a badge list of its permissions.

Revoking a Connection

1

Go to Store SettingsAI Connections.
2

Find the connection you want to remove.
3

Tap Revoke and confirm.

Revoking removes all access tokens immediately. The AI tool will lose access within seconds. You can always create a new connection later.

When to Revoke

  • The AI tool is no longer in use.
  • You suspect credentials have been compromised.
  • You want to grant different permissions — revoke and create a new connection.
  • A staff member who set up the connection has left the team.

Troubleshooting

"Invalid client" in the AI tool
Your Client ID is wrong. Double-check it matches exactly what Fuze Store shows in the AI Connections list.

"redirect_uri mismatch"
The redirect URI you entered in the AI tool must exactly match one of the URIs you saved on the Fuze Store side. Check for typos, trailing slashes, and http vs https.

"Invalid store selection" on the consent screen
You tried to pick a store you don't own. Only stores where you are Owner or Admin appear in the dropdown.

"No eligible stores" on the consent screen
None of your stores have the AI MCP add-on active. Add it to the store you want to connect from AccountAdd-ons.

Nothing happens when the AI tool opens a browser window
You need to be signed into your Fuze Store account in the browser. Open fuze-store.com in a new tab, sign in, then retry the connection.