Troubleshooting

If the Connector is not behaving the way you expect, work through the checks below before getting in touch.

"The assistant doesn't know what Brikly is"

When you connect, the Connector sends a one-page briefing to the AI assistant - what Brikly is, what data is available, currency conventions, and so on. If the assistant is asking what kind of business you run, or quoting in the wrong currency, that briefing has not loaded.

This is almost always caused by stale connection state on the AI assistant side. The briefing is sent once when the connection opens. If your session opened before a Brikly update, you are still on the old briefing.

Fix: disconnect and reconnect.

• Claude.ai: Settings → Connectors → Brikly → Disconnect, then reconnect from the same screen.
• Claude Desktop: Workspace settings → Connectors → Brikly → Remove, then re-add it.
• ChatGPT: Settings → Apps & Connectors → Brikly → Disconnect, then reconnect.

After reconnecting, start a fresh conversation. The new briefing lands on the next tool call.

"It cannot find a recipe I know exists"

A few possibilities:

The name does not match. The Connector matches recipe names case-insensitively but does not guess. "Latte" will find your Latte recipe. "Lattte" (typo) will not. Try a partial name: costing_list_recipes(search="latt").

The recipe is inactive. Inactive (retired) recipes are excluded by default. If you ask about something you've recently retired, the assistant will return "not found". You can ask the assistant to "include inactive recipes" if needed.

The recipe belongs to a different tenant. The Connector is strictly scoped to your account. If you have multiple Brikly accounts, make sure you connected the right one. Sign out and reconnect using the correct credentials if needed.

"Margins are quoted as ratios, not percentages"

If the assistant says "margin is 0.74" rather than "margin is 74%", the briefing has not loaded. Disconnect and reconnect (see above).

"Currency is wrong (showing $ instead of £, or vice versa)"

Brikly stores costs in your tenant's base currency. The assistant should read the symbol from the response and not assume a default. If it is consistently quoting in the wrong currency, that is a sign the briefing has not loaded - disconnect and reconnect.

If your tenant's base currency itself is wrong, that is a Brikly settings issue, not a Connector issue. Check Settings → Region in the Brikly web app.

"The assistant tried to update a price for me"

The Connector is read-only and the briefing tells the assistant this clearly. If it ever offers to "update", "edit", or "save" something on your behalf, that is a hallucination - the action will not actually run, but the response is misleading.

Treat any write-style suggestion as a recommendation only. To actually change a price, edit a recipe, or add a supplier, use the Brikly web app.

If you see this happening regularly, please let us know - it is feedback we use to tighten the briefing.

"It keeps asking me to approve every tool call"

Both Claude and ChatGPT prompt for the first tool approval per conversation. After that they should run silently within the same chat. If you are being prompted for every single call, check the AI assistant's settings:

• Claude: Settings → Tools & approvals - some workspaces require explicit approval per call. This is a Claude-side preference, not a Brikly setting.
• ChatGPT: Settings → Apps - similar approval-mode preference.

"The Connector worked before but now returns errors"

If you suddenly see authentication errors, try disconnect and reconnect first. If errors persist after reconnecting, the Brikly API may be in a maintenance window - check status.brik.ly (if available for your account) or contact support.

"I want to revoke access without disconnecting"

You can revoke the OAuth token directly from the Brikly web app:

1. Sign in to the Brikly web app.
2. Go to Settings → Connections.
3. Find the entry for the AI assistant in question.
4. Click Revoke.

This invalidates the token immediately. The assistant will get an authentication error on its next call. To reconnect, you will need to remove the Connector in the AI assistant and re-add it.

You can also use this page to spot-check Recent activity - which tool was queried, when, and from which assistant. Useful if something feels off and you want to see exactly what the AI assistant has been pulling.

Still stuck?

Get in touch - tell us which AI assistant you are using and what you asked. Brikly logs every Connector tool call, so we can usually trace what happened.