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

# Troubleshooting

What to do for the messages you may see with the Desktop MCP.

## Check the state first

Check that the connection works with the steps in [Check it in the AI tool](https://docs.exploratory.io/en/mcp/desktop/install.md#check). If it does not, look for your message in the table below.

## When you contact support

Send these to [support@exploratory.io](mailto:support@exploratory.io): the version of Exploratory Desktop, the name and version of your AI tool, what you did, and the error message as it was shown. Hide any token or API key.

## Troubleshooting

| What you see | What to do |
| - | - |
| exploratory-mcp is not found | Start Exploratory Desktop v17 or later with MCP on. The command is added automatically when the app starts. Then restart your AI tool. |
| exploratory-mcp is not found from the AI tool (macOS) | Exploratory is open from the disk image. Move it to /Applications or \~/Applications and start it again. The command is added when the app starts. |
| The card shows "Could not install." | Hold the pointer over Details to see the output. Follow the reason shown, then choose Try again. See [Install the plugin](https://docs.exploratory.io/en/mcp/desktop/install.md#failure). |
| A marketplace named "exploratory" is already registered from a different source … | Remove it with the command the message shows, then choose Install again. |
| Your organization's settings may not allow this marketplace. | Ask your administrator. |
| A Claude Code hook cannot find node | Install Node.js and add node to your PATH. |
| A gate stops a create call, a limit is reached, or Desktop asks for approval | See [Limits and errors](https://docs.exploratory.io/en/mcp/desktop/limits.md). |
| A create or change call is refused with PERMISSION\_DENIED | Turn on Allow create, edit and delete in System Settings > MCP / CLI and choose Save. See [Limits and errors](https://docs.exploratory.io/en/mcp/desktop/limits.md). |
| You chose Don't allow on the approval window | After 5 minutes, connect again and the window appears again. See [Limits and errors](https://docs.exploratory.io/en/mcp/desktop/limits.md). |
| The Desktop MCP does not work as you expect | Check that you are signed in to Exploratory Desktop. |


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