# Nosto setup for PopMCP You paste two values into PopMCP from the Nosto admin: your account ID and a token, usually the API_APPS token. Each other token opens one more part of Nosto and is optional. - Auth: API credentials - Setup time: 2 min - API base URL: https://api.nosto.com - Credentials screen: https://my.nosto.com - Provider docs: https://docs.nosto.com/techdocs/apis/rest ## Approval required before this works Nosto's help says API tokens are created by its support or by some of its extensions, and its API docs ask you to request access through support. If the token you need is already listed in your account, there is nothing to wait for. - Typical wait: None if the token is already on your Authentication Tokens page. Otherwise it depends on Nosto support, which does not publish how long this takes. - Cost: Nosto does not publish a price for API access. PopMCP adds nothing to this. - Blocked until approved: Each missing token blocks only its own part of Nosto. Without API_APPS, the tools for products, recommendations, identities, orders and sessions will not work. - Works meanwhile: Check Account Settings, Authentication Tokens first: a token you already have connects straight away, and any other can be added later by connecting again. ## Before you begin - A Nosto account you can sign in to at my.nosto.com - At least one API token. Nosto's help says tokens are created by its support or by some of its extensions, so if the row you need is missing, ask Nosto support - No app or redirect URL is needed ## Get your credentials ### 1. Copy your account ID Sign in at my.nosto.com. Your account ID is in the top right corner, under your shop name, and looks like `shopify-12345678`. Paste it into Account ID in PopMCP. A link to the admin works too, since the ID comes right after my.nosto.com. Screen: https://my.nosto.com ### 2. Open Authentication Tokens Open Account Settings, then Authentication Tokens. Each row is one token, named by the part of Nosto it opens, such as `API_APPS` or `API_PRODUCTS`. Screen: https://my.nosto.com ### 3. Copy the API_APPS token On the API_APPS row, click Decrypt and copy the token from the pop-up. Paste it into Apps token in PopMCP. If the row is not there, ask Nosto support for it through the chat in the admin. Say which API you want, why, and how many requests you expect. Screen: https://my.nosto.com ### 4. Add any other tokens you have In PopMCP, open More options and paste any other tokens from the same page. `API_SEARCH` adds private search fields and Search Templates. `API_PRODUCTS` sends full product records. `API_EMAIL` handles the email blacklist, marketing consent and GDPR requests. `API_RATES` sets exchange rates. `API_SETTINGS` changes store settings. `API_LIM` reaches the LIM skill, on accounts that have it. You can skip them all and add them later by connecting again. ### 5. Connect in PopMCP Click connect. PopMCP tries the Apps and Search tokens straight away. Nosto has no read call for the other tokens, so PopMCP tells you those are checked the first time a tool uses them. ## Fields PopMCP asks for - Account ID (accountId) [required]: In the top right corner of the Nosto admin, under your shop name. It is also the first part of the address after my.nosto.com. - Apps token (appsToken): Account Settings, then Authentication Tokens, then click Decrypt on the API_APPS row. It covers products, recommendations, identities, orders, segments and sessions. Leave it blank only if you paste another token under More options. Stored encrypted. - Search token (optional) (searchToken): From the API_SEARCH row. Adds private search fields and Search Templates. Public search works without it. - Products token (optional) (productsToken): From the API_PRODUCTS row. Sends full product records, discontinues products and asks for a recrawl. - Email token (optional) (emailToken): From the API_EMAIL row. Manages the email blacklist, marketing consent, data takeouts and data erasure. - Rates token (optional) (ratesToken): From the API_RATES row. Sets exchange rates on a multi-currency store. - Settings token (optional) (settingsToken): From the API_SETTINGS row. Changes the account's store settings. - LIM token (optional) (limToken): From the API_LIM row. Asks Nosto's LIM skill for recommendations. Only on accounts with LIM turned on. ## Verify PopMCP marks the Nosto connection Verified and names the store when it can read a product. It also lists any token it could not check yet. Ask the AI for your best sellers from the last week, and it answers from your store. ## Troubleshooting ### "Nosto did not accept the Apps token." Cause: The token was copied in part, was revoked, or came from another row. Fix: Open **Account Settings**, **Authentication Tokens**, click **Decrypt** on the **API_APPS** row and copy it again. A public token will not work. ### There is no API_APPS row Cause: Nosto's help says tokens are created by its support or by some extensions. Fix: Ask Nosto support through the chat in the admin. Say which API you want, why, and how many requests you expect. ### A tool says it needs a token this connection does not have Cause: Each part of Nosto has its own token, and that one was not pasted. Fix: Copy the token named in the message, connect Nosto again, and paste it under **More options**. ### PopMCP says search did not answer for this account Cause: The account ID is wrong, or Search is not turned on for this store. Fix: Check the account ID in the top right corner of the admin. If it is right, ask Nosto whether this store has Search. ### A 429 from Nosto Cause: Nosto limits requests by points per second, and a heavy query costs more points. Fix: Wait a few seconds, then try again. --- Source: https://www.docs.popmcp.com/docs/integrations/nosto/