Cursor and Claude Desktop

In addition to command-line tools like Claude Code and Codex, Mios works with graphical editors and desktop AI applications, including Cursor and Claude Desktop.

The in-app MCP page

Because desktop applications often lack terminal hooks or open outside git repositories, Mios provides customized connection snippets directly in the web app:

1. Open your browser and navigate to https://app.mios-ai.com/pages/mcp.
2. Select your target project using the project dropdown.
3. The page generates verified configuration JSON and one-click installation deep links tailored to your environment.

Connecting Cursor

You can connect Cursor in two ways:

One-click install link

On the MCP setup page at https://app.mios-ai.com/pages/mcp, click the Install in Cursor button. Your browser will prompt to open the Cursor application and register the Mios MCP server automatically.

Manual JSON configuration

Alternatively, copy the mcpServers JSON block displayed on the page and paste it into your Cursor settings file:

{
  "mcpServers": {
    "mios": {
      "command": "/path/to/bun",
      "args": ["/path/to/mios/mcp/src/mcp.ts"],
      "env": {
        "MIOS_TOKEN": "mios_pat_your_token_here",
        "MIOS_URL": "https://api.mios-ai.com"
      }
    }
  }
}

Connecting Claude Desktop

Claude Desktop runs as a standalone desktop application rather than inside a code repository. Therefore, it cannot infer your project from a local git remote.

To connect Claude Desktop:

1. On the MCP setup page at https://app.mios-ai.com/pages/mcp, make sure you have selected the specific project you want to query.
2. Copy the Claude Desktop configuration snippet. Notice that it includes the MIOS_WORKSPACE environment variable set to your project ID.
3. Open your Claude Desktop configuration file (claude_desktop_config.json) and paste the snippet inside the mcpServers object.
4. Restart Claude Desktop.

Remember that the Commun space cannot be assigned to an agent. Always select a specific project workspace when configuring MCP clients.