Connect Claude
Connect your own Claude to your shop's reports through the Comecero MCP connection, and ask about sales, MRR, churn, storefront and usage in plain words.
You can connect your own Claude to your shop's reports and ask questions in plain words, such as "What was my MRR last month?" or "Which traffic source brought in the most revenue in October?". Claude reads the same reports as the Reports API, through the Comecero MCP connection (MCP, the Model Context Protocol, is how Claude connects to other services).
It can only read, and only your own shop.
Turn it on
The connection is on for every live shop. You find it under Settings > AI connections in your dashboard. If that page says it is not turned on for your shop (for example, a shop that is not live yet), ask Comecero support to turn it on.
Connect
- In Claude, open Settings, then Connectors, and add a custom connector.
- Use this address as the connector URL:
https://mcp.comecero.com/ - Claude sends you to Comecero to sign in. The page shows your shop, live or test mode, and where you go back to. Check that you go back to claude.ai or claude.com (or this computer, for the Claude desktop app and Claude Code), then choose Allow.
- Ask Claude a question about your shop.
The connection reads the mode you were signed in to: connect from live mode for live data, from test mode for test data.
If the sign-in page warns that the app you go back to is not Claude, choose Cancel unless you added that app yourself and trust it: whoever it is will be able to read your reports. The page shows no warning for an app on your own computer, so only allow one you started yourself.
What it can and cannot do
| It can | It cannot |
|---|---|
| Read your shop's business, storefront and usage reports | Change, add or delete anything |
| Run read-only questions on those reports | See any other shop |
| See your customers' names, emails, addresses or card details (the reports don't hold them) |
Claude has four tools:
| Tool | What it does |
|---|---|
list_reports | The reports, what each shows, and whether it takes a period and a currency |
get_report | One report for a period of days: the Reports API's columns, up to 10,000 rows |
describe_data | The report tables Claude may query, their columns and how to call each one |
run_query | One read-only SELECT on those report tables |
run_query accepts one SELECT (or WITH ... SELECT) on the report tables only, called with your own shop and mode. It refuses anything else, such as other tables, settings, writing, or functions that reach outside the reports, and tells Claude why so it can ask again. A question returns at most 10,000 rows and may take up to 15 seconds.
Limits
- About 30 requests a minute per connection, 10 at once.
- 600 report queries an hour per shop, shared by all its connections, live and test. A question usually uses one or two; reading the data's description can use up to 29.
- 20 refused queries in an hour (asking outside the reports, or anything ClickHouse refuses without a known reason) pause the connection for your whole shop until Comecero support looks at it. Ordinary mistakes, such as a wrong column or report name, don't count.
See and remove connections
Settings > AI connections lists each connected Claude, when it was connected and last used, and your shop's last 50 questions across all its connections, in the mode you are signed in to (the questions, never the answers). Remove signs a connection out within a minute.
A connection stops after 90 days, or when the person who allowed it is no longer a user of your shop or may no longer see reports. These are checked each time Claude renews its sign-in, about once an hour, so it may go on for up to an hour. Connect again to go on. If Comecero turns the connection off for your shop, every connection is signed out within a minute.
Privacy
Your reports are read only to answer your Claude's questions. Comecero keeps a record of each question for 90 days: what was asked, which tool, when, how long it took, how many rows came back, and whether it was answered or why not. You and Comecero use it to see how the connection is used. The answers are not kept.