Skip to main content
After you install it, an AI tool can use Exploratory Desktop. In Exploratory Desktop, System Settings installs the Desktop MCP plugin into the AI tools on this computer. It takes about 5 minutes. You need Exploratory Desktop and the AI tool you want to install into (Claude Code, Codex, Antigravity or Cursor) on the same computer. There is no separate procedure for each AI tool: Claude Code, Codex, Antigravity and Cursor all install from the same card.

Install

Install from System Settings

In Exploratory Desktop, choose your name at the bottom left of the screen, then choose System Settings in the menu that opens (1 and 2 in the picture). The menu that opens when you choose your name at the bottom left of Exploratory Desktop. 1 is your name and 2 is System Settings
  1. In the menu on the left, choose MCP / CLI.
  2. Find the “Install the Exploratory Desktop plugin” card.
  3. Choose Install on the row of the AI tool you use.
The "Install the Exploratory Desktop plugin" card in MCP / CLI in System Settings The card says:
Installs the Desktop MCP plugin into the AI tools on this computer. After installing, restart that AI tool.
The card lists Claude Code, Codex, Antigravity and Cursor. An AI tool that is not on this computer shows Not found on this computer. The command is added automatically when the app starts, so there is no step to register it. Next, on the same screen, do this.
  1. Turn on the MCP switch. It is off by default.
  2. Only when you want the AI to create or change charts, notes and other content, check Allow create, edit and delete. Without it, the AI can only read.
  3. Choose Save at the bottom of the screen.
If you do not save, the MCP switch and the Allow create, edit and delete setting do not take effect.

Check it in the AI tool

  1. When the install ends, restart that AI tool.
  2. The first time an AI tool connects, Desktop shows a window titled “An AI tool is asking for your approval”. Choose Allow only for an app you started yourself. If you choose Don’t allow, see If something does not work.
  3. In Exploratory Desktop, open the project you want to use.
  4. In the AI tool, ask this.
    This works with Allow create, edit and delete off too. To try creating something, turn on Allow create, edit and delete and save, then ask for a chart instead, such as a bar chart of a column of your own data.
  5. Check the connection.
    • In Claude Code, open /mcp and check that exploratory-desktop is connected.
    • In Codex, run codex mcp list and check that exploratory-desktop is listed.
    • In Antigravity, check that the plugin appears under Customizations > Installed in the app.
    • In Cursor, check that the Cursor row of the card shows “Installed - v” followed by the plugin version.
If a call says that MCP is turned off, go back to System Settings and check that you turned the MCP switch on and chose Save.

Differences between AI tools

The card works the same way, but what it installs differs a little. Restart the AI tool after installing, whichever one it is. The buttons on the card change with its state. Choosing Remove opens a confirmation.

When the install fails

When an install fails, the second line of that AI tool’s row shows “Could not install.” in red. Details is right after it, then a sentence that gives the reason (for example “Check that you are connected to the internet.”), and a Try again button at the right of the row. When updating an installed plugin fails, a Remove button also appears to its right. Hold the mouse pointer over Details to see the output of the command that ran, in a pop-up. It shows up to the last 2,000 characters of the output. If it is long, you can scroll inside the pop-up vertically. The pop-up stays when you move the pointer into it. Click Details to keep it open. Copy at the top right copies the output. The image is an example of how the error details look when updating an installed plugin failed. The command output in the pop-up is a sample and differs from real output.
  1. Hold the mouse pointer over Details.
  2. Choose Copy at the top right.
The card when updating an installed plugin failed, with the pointer over Details (example) If the reason does not let you fix it, send the copied output to support. When it is fixed, choose Try again.

Install by hand

Use this when you do not use the card. The plugin is not in the official plugin directories. Add the repository exploratory-io/exploratory as a marketplace, then install the plugin exploratory. Run the commands in a terminal yourself, or ask an AI tool to run them. Claude Code
You can also open /plugin in Claude Code, add the marketplace exploratory-io/exploratory and select exploratory. In the Claude app, open Settings > Plugins, choose Add marketplace > From repository, enter exploratory-io/exploratory, then install exploratory. A plugin installed from the terminal also appears there as “Installed locally”. The local MCP runs in Cowork (when it runs on this computer) and in the Code tab. It does not run in a regular chat. Codex
Antigravity
Needs Git. The plugin appears in the Antigravity app under Customizations > Installed. Cursor Install it with the card. There is no separate step to do by hand: the card copies the plugin, with its skills, to ~/.cursor/plugins/local/exploratory.

Update and remove

It depends on how you installed it.
  • Installed with the card (Claude Code, Codex, Antigravity, Cursor): choose Reinstall on the card to install the latest plugin again (this is also how you update). To remove it, choose Remove on the same card.
  • Installed by hand (Claude Code, Codex, Antigravity): use the commands in the table below to update and remove. Cursor has no by-hand method; use the card.
The Desktop MCP stops when you quit Exploratory Desktop. Removing the plugin does not affect your Server MCP connection.

If it does not work

Troubleshooting lists the messages and what to do.