> For the complete documentation index, see [llms.txt](https://docs.m-xr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.m-xr.com/marso-studio/integrations/ai-chat/marso-mcp-troubleshooting.md).

# Marso MCP troubleshooting

### Signing in and your key

| What you see                                                                 | What to do                                                                                                                                 |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Claude says "Detected: No sign-in" when you add the connector                | That's expected. Choose **Sign in when needed** and save. You sign in when your agent first uses Marso.                                    |
| *This endpoint takes an OAuth token from your chat app, not a Marso API key* | Your key is in the connector's headers. Remove it, add the connector with just its URL, and paste the key when you sign in.                |
| Your agent says no Marso API key is linked                                   | Go to [mcp.api.marso.app/link](https://mcp.api.marso.app/link), sign in and click **Link key**.                                            |
| *That does not look like a Marso key*                                        | Paste the whole key. Marso keys start `mxr_live_`.                                                                                         |
| Marso says the key is invalid or has been revoked                            | Create a new key under **API Keys** in Marso Studio, then use **Replace key** at [mcp.api.marso.app/link](https://mcp.api.marso.app/link). |
| Your work lands in a different Marso Studio account                          | The key linked to your sign-in belongs to that account. Replace it with a key from your own account.                                       |

See [AI chat](https://docs.m-xr.com/marso-studio/integrations/ai-chat.md) for the full setup.

### Plans and credits

| What you see                                                      | What to do                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Your plan does not include this feature.*                        | Your account is on the Free plan, or your trial has ended. Marso MCP needs a paid plan or the trial. Pick one in **Plans** in Marso Studio, then ask your agent to try again. See [Plans](https://docs.m-xr.com/marso-studio/reference/credits-and-billing.md#plans). |
| *Insufficient credits. Please purchase more credits to continue.* | Top up, or ask your agent for less. See [Credits & billing](https://docs.m-xr.com/marso-studio/reference/credits-and-billing.md).                                                                                                                                     |
| *Your plan carries 10 objects to the reference image phase…*      | Your plan caps how many objects one detection carries on. Deselect some, or move to a plan with a higher cap. See [Choosing what to keep](https://docs.m-xr.com/marso-studio/reference/scene-generation.md#choosing-what-to-keep).                                    |

### Your own files

Marso MCP can't open files on your computer, so your agent gives you an upload link. Drop the file on that page, then go back to the chat: the agent carries on by itself. It can also use a file at a public `https` link.

* **Images:** PNG, JPEG or WebP, up to 5 MB.
* **3D models:** GLB, USDZ or FBX, or a zip with one FBX and its textures, up to 50 MB. For a bigger model, add it in Marso Studio with a **Load 3D Model** node. It then appears in your Library, where your agent can find it.
* **Upload links** last 30 minutes. If one has expired, ask your agent for a new one.
* You can upload up to 100 files a day.

### Runs

| What you see                                                                                 | What to do                                       |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| *You already have … executions in progress. Wait for one to finish before starting another.* | Up to 5 runs go at once. Wait for one to finish. |
| *Rate limit exceeded. Please retry shortly.*                                                 | Wait a moment, then ask your agent to try again. |

### Blender and Isaac Sim

| What you see                                                   | What to do                                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Your agent says no Blender or Isaac Sim is connected           | Check the app is open with **Connect to Marso Agents** switched on, and that the add-on's key belongs to the same Marso Studio account. See [Your agent in Blender and Isaac Sim](https://docs.m-xr.com/marso-studio/integrations/ai-chat.md#your-agent-in-blender-and-isaac-sim). |
| *Marso refused the API key*, in the add-on                     | Replace the key in the add-on's settings.                                                                                                                                                                                                                                          |
| *Another Blender connected with this account and took over.*   | Only one Blender connects per account. Reconnect the one you want to use.                                                                                                                                                                                                          |
| A render link has expired                                      | Links last a day. Ask your agent to send the render again.                                                                                                                                                                                                                         |
| *'…' is not available to agents. It stays in the Marso panel.* | Your agent asked for a step that only the Marso panel does, such as Retexture. Do it in the panel yourself.                                                                                                                                                                        |
| Your agent can't build or change objects in Blender            | Building models goes through Blender's own MCP server. Check it's running in Blender and switched on in your chat: see [Blender](https://docs.m-xr.com/marso-studio/integrations/blender.md), part 2.                                                                              |

Still stuck? See [Contact Support](https://docs.m-xr.com/marso-studio/help-and-support/contact-support.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.m-xr.com/marso-studio/integrations/ai-chat/marso-mcp-troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
