Skip to main content
AI assistant

Connect your AI to your Bleam data (MCP connector)

5 steps

Already using an AI assistant — Claude, ChatGPT or another? Bleam's MCP connector gives it access to your Bleam data, so you can ask it about your sales, your catalogue and your automations, and get answers backed by your real numbers. The server is hosted by Bleam: there is nothing to install, just a URL to paste and a connection to authorise.

1

What it's for (three questions to ask your assistant)

Once the connector is plugged in, your AI assistant can fetch your data to answer. For instance:

- "Which brand brings me the most margin this quarter?"
- "Which items have been in stock for more than 90 days?"
- "Are my automatic reposts running properly?"

The point: you ask in plain language, inside the tool you already use, and the answer relies on your real sales and your real catalogue — not on generalities.

2

The connector's address

Only one thing to remember, the same for everyone:

https://api.bleam.app/mcp

It is a remote server hosted by Bleam: nothing to download, nothing to run on your computer. You paste this URL into your tool, a Bleam window opens so you can log in and authorise access, and that's it.

3

Plugging it into your tool

The steps depend on the tool, but the principle is always the same: add a connector, paste the URL, sign in to Bleam and authorise.

- Claude (web and desktop app): Settings → Connectors → Add custom connector, paste the URL, then Connect.
- Claude Code: claude mcp add --transport http bleam https://api.bleam.app/mcp, then /mcp in a session to authenticate.
- ChatGPT: Settings → Connectors → Add remote MCP server, the URL, then OAuth.
- Codex CLI: codex mcp add ("Streamable HTTP" transport, the URL), then codex mcp login bleam.
- OpenCode: declare the server in opencode.json — authentication starts automatically.

The site's dedicated page shows each procedure in detail, with the commands to copy.

4

What your AI can read

By default, the connector is read-only. Your assistant can look at:

- an overview of your account and your settings;
- diagnostics (what is currently stuck on your accounts);
- your scheduled tasks and your backups;
- your statistics, your sales and your purchases.

It cannot buy anything, sell anything, or trigger a repost.

5

Allowing (or not) settings changes

If you want to, your assistant can also change some settings — but only after an explicit authorisation from you. In your Bleam Settings, "AI assistant (MCP)" section, turn on "Allow configuration actions".

What it opens: the bot, favourites, reposting, after-sale and Knowledge settings. What it never opens: your subscription, and the triggering of a sale or a repost.

Only enable this option if you trust the connected assistant. You can turn it off at any time, and the access granted to the connector stays revocable on your side.

Frequently asked questions

See also

Did this guide answer your question?

Ready to try Bleam?

Free trial, no commitment, cancel in one click.

Start with Bleam