KocoroShopify Integration Guide
Connect Kocoro to your Shopify store so your agent can query products, orders, customers, and inventory in natural language. You create a custom app in your Shopify admin with read-only scopes, then paste the access token into Kocoro. The whole flow takes about 5 minutes.
Before you begin
- A Shopify account with permission to develop apps for your store.
- Kocoro installed and initialized, with at least one agent created.
- 1
Open Settings in your Shopify admin
Sign in to your Shopify admin (admin.shopify.com), then click "Settings" in the bottom-left corner.
- Shopify admin: https://admin.shopify.com
Fig. 1 — Open Settings from the bottom-left of the Shopify admin. - 2
Go to Apps and click "Develop apps"
In the settings sidebar, select "Apps", then click "Develop apps" in the top-right corner.
Fig. 2 — Settings → Apps → Develop apps. - 3
Create a legacy custom app
On the App development page, click "Create legacy custom app".
If you don't see this button, custom app development may need to be allowed first by the store owner.Fig. 3 — Click "Create legacy custom app". - 4
Name the app and create it
In the dialog, enter an app name (e.g. Kocoro), choose an app developer, then click "Create app".
Fig. 4 — Enter the app name and click "Create app". - 5
Configure the Admin API integration
On the app page, open the "Configuration" tab and click "Configure" on the "Admin API integration" card.
Fig. 5 — Configuration → Admin API integration → Configure. - 6
Select the read-only access scopes and save
Under "Admin API access scopes", search for and check the following 7 read-only scopes one at a time (the search box doesn't accept multiple scopes at once), then click "Save":
read_productsread_ordersread_customersread_inventoryread_locationsread_draft_ordersread_price_rules- Kocoro only requests read (read_*) scopes — it never modifies your store data.
If the "Install app" button is still grayed out after clicking "Save", click "Save" once more.Fig. 6 — Check the 7 read-only scopes and click Save. - 7
Install the app
Click "Install app" in the top-right corner, then click "Install" in the confirmation dialog.
Fig. 7 — Confirm the installation. - 8
Copy the Admin API access token
After installing, open the "API credentials" tab and copy the Admin API access token (it starts with shpat_). Also note your store domain (e.g. yourstore.myshopify.com, shown in the sidebar).
The token is only revealed once — copy it right away and keep it safe.Fig. 8 — Copy the access token and note the store domain. - 9
Connect Shopify in Kocoro
Open Kocoro, go to Settings → Customize → MCP Servers, and turn on "Shopify". In the "Connect Shopify" dialog, enter your store domain and the Admin API access token, then click "Connect".
- The token is used once to establish the connection and is never stored on your Mac.
Fig. 9 — Enter the store domain and token in Kocoro, then connect.
Done — ask your agent about your store
Once connected, your agent can query the store directly — try "What were yesterday's orders?", "Which products are low on stock?", or "Find my top customers this month".