--- title: "Troubleshoot an agent connection" source: https://support.storeconnect.com/articles/troubleshoot-an-agent-connection type: article format: markdown site: StoreConnect Support — product and developer documentation for StoreConnect site_index: https://storeconnect.com/llms.txt docs_index: https://support.storeconnect.com/llms.txt note: Append .md to any page or article URL on this site to get its Markdown form. --- # Troubleshoot an agent connection Use this article when an AI agent cannot connect to your store, or connects and then cannot do what you asked. Start from the message you were shown rather than retrying, because each cause has its own fix and retrying changes none of them. To set a connection up in the first place, see [Connect an AI agent to your store](connect-an-ai-agent-to-your-store). Most failures are one of three things: the token, the access behind it, or the address. The message tells you which. ## The sign-in screen refuses the connection The sign-in screen names what failed, above the store it was about to grant access to. ### That token isn't valid or is inactive The token is wrong, has been turned off, or has passed its expiry. Reveal the current value again from **Your agent access** in the StoreConnect Console and check the state shown beside it. Disabling or resetting access replaces the token, so a copy saved earlier stops working once an administrator has done either. Paste the current value, not one from a password manager entry you have not updated since. ### This user has no editing access to this store The token is fine. Your user has no **Store Role** of type `Content Changes` covering the store at that address. Ask an administrator for one, at `Editor` level to stage changes or `Approver` level to publish them. See [Store roles](store-roles). This message is about the store at the address you signed in at, not about every store. On a shared domain, a role that covers your store does not help if you signed in at another store's path. ### This client's redirect address is not on this store's allow list Neither your token nor your access is the problem. The product you are connecting from is not one StoreConnect accepts a browser sign-in for yet, and the list is StoreConnect's own configuration, so a store administrator cannot add to it. Email [support@storeconnect.com](mailto:support@storeconnect.com) with the product name and the address shown under the message. Meanwhile, the product can still connect by sending the bearer credential as a header. Copy it from **Your stores** in the Console rather than assembling it by hand. ### This client asked to connect to a different endpoint than this store's The client is pointed at one store and signing in at another. The message names the address the store expects. Correct the address in the client and start the sign-in again. ## The address names no store An address that names no store fails before your token is ever checked. Every message here means the address, not your access. For how addresses are built when several stores share one domain, see the shared-domain section of [Connect an AI agent to your store](connect-an-ai-agent-to-your-store). ### No store is configured at this address The path is wrong, or the store at it is not live. Your store's path is the **Path** field on its **Store** record (`s_c__Store__c.s_c__Path__c`), and it goes between the domain and `/mcp`. A store with nothing in that field is the one served at the root of the domain. :::warning The **Store URL** shown in the Console leaves the path out, so on a shared domain it shows the root store's address for every store in the list. Add your store's path yourself before you connect. ::: ### Several stores share this domain and none is marked as the default You used the domain with no path on it, and more than one store answers to that domain. Connect using your store's own path, or ask your administrator to mark one store as the default. ### Your store's "page not found" page Opening `https:///.well-known/mcp.json` and getting your store's own "page not found" page means the store is on a version earlier than v22 and has no endpoint to connect to. Nothing is broken, and retrying will not change the outcome. Email [support@storeconnect.com](mailto:support@storeconnect.com) or ask your implementation partner about upgrading. The version check is in [Connect an AI agent to your store](connect-an-ai-agent-to-your-store). The skills toolkit still works while you wait, because knowledge does not need a connection. See [Install the StoreConnect AI skills](install-ai-skills). ## The agent is connected but something does not work ### The agent cannot perform an action If an agent cannot perform an action, it is usually a permissions boundary rather than a fault. The agent works as you, so it can only do what your **Store Role** allows, on the stores that role covers. Ask your administrator to review the access for that store instead of looking for a workaround. ### The agent stopped working partway through Sign-in sessions expire after about eight hours. When a session expires, sign in again from your agent using your existing token. You do not need a new token. ### A change to your access has not taken effect A session carries the permissions you had when you signed in. If your **Store Role**, its scopes, or the stores it covers have changed, sign in again from your agent so the change applies. Until you do, the agent keeps working with the old permissions. When the cause is fixed, the sign-in screen names your store and its address, you are prompted for your token, and your agent shows the connection as active. --- ## Follow StoreConnect - [Email Newsletter](https://storeconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://storeconnect.com/partners) - [Become a Partner](https://storeconnect.com/become-a-partner) - [News](https://storeconnect.com/articles/news) - [Events](https://storeconnect.com/articles/events) - [Live Events](https://storeconnect.com/live-events) - [Feature Comparison](https://storeconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://storeconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS ## Machine-readable - [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format - [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map Every page and article on this site has a Markdown rendering: append `.md` to its URL. Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md) --- StoreConnect Support — https://support.storeconnect.com/articles/troubleshoot-an-agent-connection