---
title: "Claude connector for merchants"
description: "Connect Claude to your SureBright Merchant Portal account: what you can ask it, how to connect, how every change is previewed and confirmed, and how to disconnect."
---

Connect Claude to your SureBright Merchant Portal account and you can ask it about your sales, invoices, products and plan prices in plain language, and have it make changes for you. Claude shows you a preview of every change and makes it only after you say yes.

Anyone on your store's Merchant Portal account can connect. Each person connects under their own sign-in, and Claude acts as that person.

## What you can ask Claude to do

| Area | Ask Claude to | With your confirmation, Claude can also |
|---|---|---|
| Sales | Summarise sales, shipping protection sales and attach rate for a period, list sales, show the cover on an order, and tell you what a cancellation would refund | Correct the covered product on a plan |
| Analytics | Show order insights, Warranty Intelligence, plan activation, coverage gaps, widget test results, price performance and the Abandoned Cart report | |
| Billing | List your invoices, open one, give you a download link for its PDF, and list your payment methods | Change your default payment method or remove one |
| Products and prices | List products and categories, show plan prices, price history and the status of a price publish | Turn protection on or off for a product, set its manufacturer warranty, publish category prices, set a product price |
| Leads | List recent orders you could sell a plan on and check a draft order | Quote a plan for a lead, create a draft order, send its payment link, mark it paid |
| Order Resolution | List open cases with their order lines and notes, orders missing a contract and orders waiting on a shipment | Answer a case, add a note, keep a case for yourself or hand it back, run a Lightspeed order sync |
| Abandoned Cart | List carts and messages and show how the programme is set up | Prepare and send offers, change a cart's plan or discount code, manage rules, templates and connected tools |
| Widget | Check whether a product can carry a plan, show your widget settings and preview a design on your own pages | Change the widget's theme, wording, placement and layout in a draft, then publish it or go back to an earlier version |
| Account and help | Summarise your store, say which portal features are on, search the Merchant Portal help, and list what has been done through the connector | Update your store's contact details, revoke an API key |

If a feature is not switched on for your store, Claude says so and points you to SureBright support.

## Connect Claude to your store

The connector's address is:

```
https://mcp.surebright.com/store-admin
```

<Steps>
  <Step title="Add the connector">
    In Claude, open **Settings → Connectors → Add custom connector**, paste the address above and click **Add**, then **Connect**.
  </Step>
  <Step title="Sign in to SureBright">
    A **Sign in to SureBright** page opens. It names the app asking for access and says where you will be sent back to. Either enter **Your Shopify store address** (`your-store.myshopify.com`) and click **Continue with Shopify**, or click **I'm already signed in to the Merchant Portal** to use the portal sign-in you already have open.
  </Step>
  <Step title="Allow access">
    After the portal sign-in a page asks whether to allow the app, by name, **to read your store** or **to read and change your store**, and names your store. Click **Allow**. **Cancel** sends you back to the app with nothing connected.
  </Step>
  <Step title="Start asking">
    Back in Claude the connector shows **Connected**. Open its tool list to see what it offers for your account, or just ask Claude about your store.
  </Step>
</Steps>

Good to know:

- You must sign in with an account that is on the store's Merchant Portal account. Any other sign-in is refused: **Sign in with an account that can open your store's SureBright app.**
- A sign-in link that sits unused for ten minutes expires. Start again from the app.
- The connector works in Claude on the web and on desktop, and in other AI apps that support remote connectors with sign-in.

### Read only, or read and change

The **Allow** page tells you which kind of access you are giving:

| The page says | Claude can |
|---|---|
| **read your store** | Look things up. It is never offered a way to change anything |
| **read and change your store** | Look things up and make changes, each one only after you confirm it. This is what Claude asks for |

## How Claude makes a change

1. You ask for a change.
2. Claude shows you a preview of exactly what would change. Nothing has happened yet.
3. You say yes, and Claude makes that change once. If you say no, or do not answer within a few minutes, nothing changes.

Claude can only confirm the preview you saw: a confirmation cannot be reused for a different change.

Widget changes never reach shoppers straight away. They go into a draft of your widget settings. Claude can show the draft on your own product and cart pages (`preview_design`), publish it after your confirmation (`publish_draft`), throw it away (`discard_draft`) or bring back an earlier version (`rollback_config`). Before new wording is saved, Claude checks it against SureBright's wording rules for the widget (`check_content_compliance`). Asking for coverage on a product or category (`request_coverage`) sends a request for SureBright to review; it does not grant coverage.

<Warning>
SureBright can switch changes off, for all stores, for one store or for one kind of change, without notice, for example while a change is under review. Looking things up continues to work.
</Warning>

## What Claude cannot get

- **Bulk export files.** The sales export and the billed-orders export are not offered through the connector. Download them from the Merchant Portal.
- **Links that work without a sign-in**, such as a bank account's verification page. These are removed from Claude's answers.

Shoppers' names, notes and product text that appear in results are treated as information, never as instructions to Claude.

## Disconnect Claude from your store

In Claude, open **Settings → Connectors**, choose the SureBright connector and remove it. Claude's access to your store ends. Reconnecting starts the sign-in again.

Each connection is separate. If you connected from a second app, or a colleague connected under their own sign-in, remove each one on its own.

## Troubleshooting

| You see | Do this |
|---|---|
| The tool list looks out of date | Claude remembers a connector's tools. Open the connector's menu in **Settings → Connectors** and choose **Refresh tools list** |
| A change did not happen | Check that you confirmed the preview; the first step only shows what would change. Claude may also ask for your approval before it makes a change. Approve it and ask again |
| Claude cannot connect to a store (`connect_store` is refused) | The account you signed in with is not on that store's Merchant Portal account, or the store is not yet set up in SureBright |
| Widget tools say the store is not set up | Your store has no widget set up in the Merchant Portal's **Widget Studio** yet. Set it up there first |

## Connector tools by area

Claude names the tool it is using. This table tells you what each one belongs to. Tools in the last column make a change and always ask for your confirmation first.

| Area | Looks things up | Makes a change |
|---|---|---|
| Account | `get_store_summary` | `update_store_contact` |
| Billing | `list_invoices`, `get_invoice`, `get_invoice_pdf`, `list_payment_methods` | `update_default_payment_method`, `delete_payment_method` |
| Developers | `list_api_keys` | `delete_api_key` |
| Analytics | `get_sales_summary`, `get_shipping_summary`, `get_order_insights`, `get_warranty_intelligence`, `get_warranty_activation`, `get_coverage_gaps`, `get_widget_experiments`, `get_pricing_performance`, `get_cart_recovery_report` | |
| Sales | `list_sales`, `get_cancellation_refund_quote`, `list_shipping_contracts`, `get_order_coverage` | `update_covered_product` |
| Products and prices | `list_products`, `get_plan_prices`, `list_categories`, `get_category_prices`, `get_price_publish_status`, `list_price_history` | `update_product_warranty_status`, `update_manufacturer_warranty`, `update_category_prices`, `update_product_price_override` |
| Leads | `list_leads`, `get_draft_order_status` | `create_lead_quote`, `create_draft_order`, `send_draft_order_invoice`, `update_draft_order_paid` |
| Order Resolution | `list_resolution_cases`, `list_case_order_lines`, `list_case_notes`, `list_missing_contracts`, `list_pending_fulfillment`, `list_lightspeed_pending_warranties` | `update_case_answer`, `update_case_hold`, `create_case_note`, `create_lightspeed_order_sync` |
| Abandoned Cart | `list_carts`, `get_cart`, `list_cart_messages`, `get_recovery_setup`, `check_abandonment_rule` | `update_cart_line_plan`, `update_cart_offer`, `create_cart_offer`, `send_cart_offer`, `send_bulk_cart_offers`, `update_discount_code`, `cancel_cart_follow_up`, `send_message_retry`, `send_access_request`, `update_recovery_settings`, `update_offer_rule`, `delete_offer_rule`, `update_message_template`, `delete_message_template`, `update_tool_settings`, `delete_tool_connection`, `send_test_message` |
| Features and help | `get_store_features`, `search_help_articles` | |
| Widget | `connect_store`, `get_integration_status`, `resolve_product`, `check_product_support`, `check_coverage`, `get_coverage_request`, `get_widget_config`, `get_change_history`, `get_draft_diff`, `list_design_presets`, `preview_design`, `check_content_compliance` | `update_widget_theme`, `update_widget_content`, `update_widget_placement`, `set_widget_layout`, `update_cart_widget`, `apply_design_preset`, `publish_draft`, `discard_draft`, `rollback_config`, `request_coverage` |
| Connector | `get_connector_activity` | |

The lookup tools answer with the same figures and records the Merchant Portal shows, including the portal's own notes on how each figure is counted. `get_invoice_pdf` returns a download link that works for a limited time. `get_connector_activity` lists every call made through the connector for your store: who, which tool, when, and the outcome.

## Related

<CardGroup cols={2}>
  <Card title="Ray" href="/merchant-portal/ray">
    The assistant inside the Merchant Portal.
  </Card>
  <Card title="Merchant Portal overview" href="/merchant-portal/overview">
    What each section of the portal is for.
  </Card>
</CardGroup>

<Accordion title="For developers">
  The connector is a remote MCP server with OAuth sign-in, so it also works in any MCP client that supports OAuth. The read permission is the `store.read` scope and is always granted; the change permission is `store.write` and is granted when the client asks for it. A client without `store.write` is never shown a change tool. Every change tool takes an extra `confirm_token` argument: called without it, the tool returns a preview and a token; called again with the same arguments and the token, it makes the change. A token stands for exactly that preview, lasts a few minutes and works once. Dates in tool inputs are `YYYY-MM-DD` in the store's day. Removing the connector revokes the connection, and the access and refresh tokens issued for it stop working.
</Accordion>
