# Bold Commerce setup for PopMCP

You paste one API access token from Bold Account Center into PopMCP. Bold gives each store its own token, so PopMCP reads the shop from the token and the connection is locked to that shop.

- Auth: API credentials
- Setup time: 2 min
- API base URL: https://api.boldcommerce.com
- Credentials screen: https://account.boldcommerce.com/
- Provider docs: https://developer.boldcommerce.com/guides/checkout/quick-start

## Before you begin

- A Bold Account Center login for the organization the shop belongs to. Sign up at account.boldcommerce.com if you do not have one.
- The Bold products you want the AI to use already set up on the shop. A tool for a product the shop does not have answers that nothing was found.
- A decision on what the AI may change: View scopes for a look-only connection, Manage scopes for the areas it should edit.

## Get your credentials

### 1. Open API access tokens

Sign in to [Bold Account Center](https://account.boldcommerce.com/), choose API access tokens in the left-hand menu, then click Create API access token.

Screen: https://account.boldcommerce.com/

### 2. Name it and tick the scopes

Enter a name such as `PopMCP` in API access token name, then tick the scopes. For every tool to work, tick all of them under Core, Checkout, Subscriptions and Price Rules. For a look-only connection, tick only the View scopes. Always include Shops read, because it tells PopMCP which shop the token is for. Click Create.

Screen: https://account.boldcommerce.com/

### 3. Copy the API access token

A dialog shows a shared secret and the API access token. Copy the API access token. PopMCP does not need the shared secret. Both disappear when you close the dialog, so copy the token before you click Done.

Screen: https://account.boldcommerce.com/

### 4. Paste the token into PopMCP

In PopMCP, paste the token into API access token and click Connect Bold Commerce. PopMCP asks Bold which shop the token belongs to and shows the connection under that shop's name.

## Fields PopMCP asks for

- API access token (apiToken) [required]: In Bold Account Center: API access tokens, Create API access token. Name it, tick the scopes, choose Create, then copy the API access token, not the shared secret. Stored encrypted.

## Verify

PopMCP shows Bold Commerce as Verified under your shop's name. Asking the AI which shop it is connected to, or how many subscriptions are active, returns real answers.

## Troubleshooting

### Bold did not accept this API access token

Cause: Bold answered 401: the token was copied incompletely, or it has been deleted.

Fix: Make a new token in Bold Account Center under API access tokens, since Bold shows each one only once, and paste it again.

### Bold refused this token

Cause: Bold answered 403 when PopMCP asked which shop the token belongs to. The token most likely has no Shops read scope.

Fix: Make a new token that includes Shops read, and connect again.

### Bold could not find a shop for this token

Cause: Bold answered 404 for the token's shop.

Fix: Check in Bold Account Center that the shop is connected to your organization, then make the token again.

### A tool answers that the token probably lacks a scope

Cause: The token was made without that scope. PopMCP names the scope in the answer.

Fix: Make a new token with that scope added, then reconnect Bold Commerce with it.

### A tool says Bold found nothing with that id

Cause: The id belongs to another list, or the shop does not have that Bold product. Bold keeps separate customer lists with different ids for the shop and for Subscriptions.

Fix: Get the id from the matching list tool, such as bold_list_subscription_customers for subscription tools.

### Bold would not open a checkout order

Cause: Bold refused to open that order by its public id, which may be wrong.

Fix: Check the public_order_id, which comes from bold_initialize_order or the store order's bold_cashier_public_order_id note attribute.

---

Source: https://www.docs.popmcp.com/docs/integrations/bold-commerce/