Connect your AI to your Bleam data (MCP connector)

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.

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.

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.

Your assistant can always 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.

For it to also change things or act, it needs configuration actions (next step). It can never buy anything.

Your assistant can also act for you. When you connect it, the authorisation window offers "Configuration actions", ticked by default: untick it to stay read-only. You can change your mind at any time in your Bleam Settings, "AI assistant (MCP)" section, "Allow configuration actions" switch.

What it opens: the bot, favourites, reposting, after-sale and Knowledge settings, but also dashboard actions. On the CRM side (Enterprise plan), your assistant can for instance record a purchase made outside Vinted, set a purchase's cost by its SKU, add a fee, and remove a manual purchase or a fee. It can also schedule reposts, price changes, deletions and publications, manage your templates and Auto stock, file your conversations, send a message or an offer and accept a buyer's offer from your messaging. What it never opens: your subscription.

Only keep this option on 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.