> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glood.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> What went wrong, what it means, and what to do about it

## Connecting

| What you see | What it is | What to do |
| - | - | - |
| The browser opens, you approve, and the client keeps waiting | The approval never reached the client | Try connecting again. If it repeats, report it — this one is ours to fix, not yours |
| "Your assistant's access has expired" | Unused for over 30 days, or the connection was revoked | Reconnect from your client |
| The assistant does not know what `whoami` is | The server is connected but the skills are not loaded | Re-run `npx skills add LoopClub/glood-agent-skills` and start a new session. See [Install the skills](/platform/skills) |
| Your client will not connect at all | It may not speak MCP authorization | Check the requirements in [Connect any MCP client](/platform/mcp-server) |
| A Custom GPT will not authorize | Custom GPTs cannot register themselves | That path needs credentials from us — email [support@glood.ai](mailto:support@glood.ai) |

## Seeing your data

| What you see | What it is | What to do |
| - | - | - |
| It cannot see an organization you belong to | You did not tick it when connecting, or you joined it afterwards | Add it at Account → Connections |
| A store you own is not found | It may still be a draft — its install never finished — or it was not ticked when you connected | Finish connecting it, or add its organization at Account → Connections |
| "no Glood app connected" on a store you use | That store has no Glood app syncing events, so nothing has been collected to report on | Connect Glood Search or Glood Personalization to it |
| "Your role does not allow that" | Your role in **that** organization, not a connection problem | Ask an admin to change your role there |
| Asking about two organizations at once fails | Deliberate — currencies, timezones and roles differ between them | Ask one organization at a time |
| "read-only" when you asked it to change something in Shopify | Deliberate: this connection reads your Shopify data and never writes it | Make the change in Shopify admin; the assistant will tell you where |
| A change that asks you to confirm | Archiving, stopping a deployment and removing a schedule are two-step by design | Read the review it shows you, then say yes |

## Errors your assistant may quote

Occasionally an assistant repeats the error code it got back. These are what
they mean.

| Code | What it means |
| - | - |
| `FORBIDDEN` | Your role in **that** organization lacks the permission. The message names which one. |
| `CROSS_ORG_SCOPE` | One call named stores in two organizations. It needs splitting into one call per organization. |
| `APP_NOT_ENABLED` | No Glood app on that store can answer that report. Connecting Glood Search or Glood Personalization is what starts collecting those events. |
| `STORE_NOT_FOUND` | Not reachable by this connection — another organization's, not granted, still a draft, or removed. |
| `REPORT_NOT_FOUND` | That report name does not exist. Ask what reports the store can answer. |
| `ORG_NOT_FOUND` | That organization is not shared with this connection. |
| `AMBIGUOUS_TARGET` | A name matched in two organizations. The error lists the candidates — pick one. |
| `VALIDATION` | The arguments were wrong: an inverted window, a missing field. The message names the field. |

<Note>
  An error is an answer, not an outage. Every one of these is something you or the
  assistant can act on — none of them mean Glood is down.
</Note>

## Numbers that look wrong

Before assuming a figure is wrong, check what the assistant said around it.

* **Did it name the window?** If not, ask. A shortened window is the single most
  common reason a number surprises someone — your data may not go back as far
  as the question did.
* **Did the result carry a note?** "the top few, not everything" and
  "unavailable rather than zero" both change what the number means. See
  [How to read the answers](/platform/using#how-to-read-the-answers).
* **Does it disagree with the dashboard?** It should not be able to — the same
  code computes both. If it does, report it.

## Still stuck

Email [support@glood.ai](mailto:support@glood.ai). Including the exact question
you asked and the error the assistant quoted makes it much faster to answer.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.