Skip to main content

Connecting from Claude

You can use the Brikly Connector from either Claude.ai in your browser or the Claude Desktop app on macOS or Windows. The setup is similar in both - sign in once, then ask questions.

What you will need​

  • A Brikly account with CostingBrik active.
  • A Claude account on the Pro, Team, or Enterprise plan (Connectors are not available on the free tier).
  • Five minutes.

Connecting from Claude.ai​

  1. Sign in to claude.ai.
  2. Open Settings (bottom-left menu) and go to Connectors.
  3. Click Add Connector (or Add custom connector).
  4. Fill in the Add custom connector dialog:
    • Name: Brikly
    • URL: https://api.brik.ly/mcp
  5. Click Add.

Claude Add custom connector dialog with Brikly name and the api.brik.ly/mcp URL filled in

  1. Claude will redirect you to Brikly to sign in. Use the same email and password you use for the Brikly web app.
  2. Approve the access request. You will be redirected back to Claude.
  3. The Brikly Connector now appears in your Connectors list.

To use it, start a new conversation and ask a question about your business. Claude will detect the Connector and call the right tools automatically. You may need to approve the first tool call - after that, Claude can use the Connector freely within the conversation.

Try this first

"What is my gross margin on a Latte?"

If Claude returns a margin and shows the cost breakdown, the Connector is working.

Connecting from Claude Desktop​

Claude Desktop uses the same Connector flow, configured per-workspace.

  1. Open Claude Desktop.
  2. Click your workspace name in the top-left to open settings.
  3. Go to Connectors and click Add Connector.
  4. Paste https://api.brik.ly/mcp as the connector URL.
  5. Sign in to Brikly in the browser window that opens.
  6. Approve access. The window closes automatically.

The Connector is now available in every conversation in this workspace.

Disconnecting​

You can remove the Connector at any time:

  • Claude.ai: Settings → Connectors → Brikly → Disconnect.
  • Claude Desktop: Workspace settings → Connectors → Brikly → Remove.

When you disconnect, Claude immediately loses access to your Brikly data. Any cached responses inside an existing conversation will still be visible, but no new tool calls can run.

What Claude can see​

When you connect, Claude receives a server-level briefing that explains:

  • That Brikly is a UK hospitality SaaS for cafe and coffee shop operators.
  • That the Connector is read-only - so it should never offer to "update" a price for you.
  • That recipe IDs and ingredient IDs are scoped to your account only.
  • The vocabulary it needs (recipe_type, cost_per_measurement, gross_margin_net, etc.) so it interprets your data correctly.

This grounding lands once per conversation. If you start a new chat and Claude seems to be guessing - or asking what kind of business you run - that briefing has not loaded. Try disconnecting and reconnecting.

Next steps​