# Troubleshooting

> Symptom, cause and fix for the problems people meet most — connecting, plan limits, access, timeouts, and keys on the wrong plane.

Kind: troubleshooting · ~3 min · Verified v0.66.1 · Next: [Recipes](https://pr-765-stg.superartifacts.app/docs/recipes.md)

Find the symptom, then the fix. Codes link to [Error codes](https://pr-765-stg.superartifacts.app/docs/reference/errors.md).

| Symptom | Cause | Fix |
| --- | --- | --- |
| The agent says it has no Super Artifacts tools. | It was never connected, the sign-in was not approved, or the chat started before it was. | Copy your agent's connect prompt from [MCP tools](https://pr-765-stg.superartifacts.app/docs/reference/mcp.md#connect), paste it, approve the sign-in, then start a new chat. |
| A prompt or skill uses a tool name you cannot find in the tool list. | It is a name from before 29 September 2026. | Old names are deprecated but still resolve; use the current names on [MCP tools](https://pr-765-stg.superartifacts.app/docs/reference/mcp.md). |
| A publish is refused with `plan_limit`. | The workspace's retained storage is full, or a list is over its cap. | Published pages keep serving. Ask your agent what to delete (below), or add storage on [Plans and pricing](https://pr-765-stg.superartifacts.app/docs/reference/plans.md). |
| A link opens a page titled **You need access**. | The artifact is private and you are not on it. | Press **Request access**; the author is asked. Or ask them to share it, or open it through a project you can see. |
| Adding an artifact to a project is refused until you confirm. | The project is shared or public and the artifact is private: the project would let its audience open it. | Tell your agent you mean it and it will confirm, or leave the artifact out. |
| A publish is refused with `missing_prompt`. | The agent left out why the page was built. | Ask it to publish again with one sentence saying why. |
| A publish is refused with `missing_index`. | There is no `index.html` page at the top level. | Ask the agent to put the page at `index.html`, not in a folder. |
| A tool call fails with `mcp_timeout` after 55 seconds. | The call took longer than the proxy waits. It may still have finished. | Reading is safe to repeat. Before redoing a change, have the agent check it did not already happen (below). |
| `unauthorized` with a key that works elsewhere. | The key belongs to another copy of Super Artifacts (a plane). Production keys start `sa_live_`, staging keys `sa_stg_`; older keys start `sa_live_` everywhere. | Ask the agent which account it uses (below), and get a key from that plane's Agents page. |
| You expect search to need an account. | It does not. Docs search runs in the browser from a static index. | Press ⌘K or Ctrl K on any docs page, signed in or not. |
| **Webhooks**, **Domains** or **Metrics** shows a "Coming soon" screen. | Those pages are in the navigation but not built yet. | Nothing to fix; there is no setting behind them today. |

## Prompts for the fixes above

**Which account is my agent using?**

```prompt
Which Super Artifacts account and environment are you connected to? Call super_whoami and tell me the handle and the environment in one line. Do not publish anything.
```

**After a timeout**

```prompt
That Super Artifacts call timed out. Before you try again, check with super_artifacts whether it already happened, and only redo it if it did not.
```

**Storage is full**

```prompt
My Super Artifacts storage is full. List my artifacts and their versions, and suggest old versions or artifacts I could delete. Delete nothing until I say which.
```