# MCP Setup

The configurations below connect your client to the Ideasoft MCP server (`https://mcp.myideasoft.com/mcp`).

<CodeTabs>

```jsonc title="Claude Desktop"
// claude_desktop_config.json
{
  "mcpServers": {
    "ideasoft": {
      "url": "https://mcp.myideasoft.com/mcp",
      "headers": {
        "security": "<store-domain>,<access-token>"
      }
    }
  }
}
```

```jsonc title="Cursor"
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "ideasoft": {
      "url": "https://mcp.myideasoft.com/mcp",
      "headers": {
        "security": "<store-domain>,<access-token>"
      }
    }
  }
}
```

```jsonc title="VS Code"
// .vscode/mcp.json
{
  "servers": {
    "ideasoft": {
      "type": "http",
      "url": "https://mcp.myideasoft.com/mcp",
      "headers": {
        "security": "<store-domain>,<access-token>"
      }
    }
  }
}
```

</CodeTabs>

**ChatGPT** has no JSON configuration: enable developer mode under Settings → Connectors → advanced settings and create a connector with the server URL. The `security` header can't be sent, so only unauthenticated tools (`get*ApiParams`, `getCurrentDateTime`) work.

:::info{title="security header"}
The `security` header is only required for the `callApi` tool; `get*ApiParams` and `getCurrentDateTime` work without authentication. Its value is formatted as `<store-domain>,<access-token>`, e.g. `your-store.myideasoft.com,eyJ...`.
:::

OpenAPI definition: [mcp.openapi.json](/mcp.openapi.json)
