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

# Setup

> Install the Cogniscape MCP on your preferred AI client.

## Claude (web, Desktop, mobile)

The installed Claude Desktop app does not natively accept Streamable HTTP connectors, but the **claude.ai web interface does**, and the Desktop, iPhone, and Android apps all inherit connectors from the web account. Configure once on the web and it works everywhere.

<Steps>
  <Step title="Open the custom connector dialog">
    Sign in at claude.ai and open the [Add custom connector](https://claude.ai/settings/connectors?modal=add-custom-connector) dialog directly.
  </Step>

  <Step title="Fill in the fields">
    * **Name:** `Cogniscape`
    * **Remote MCP server URL:** `https://mcp.cogniscape.app`

    <Frame>
      <img src="https://mintcdn.com/personal-d2400470/N15mNcj7FX_znZnN/images/claude-web-custom-connector.png?fit=max&auto=format&n=N15mNcj7FX_znZnN&q=85&s=b712f319fdce918207c8f7ae2a68ecc8" alt="Claude custom connector dialog with Name and Remote MCP server URL fields" width="655" height="502" data-path="images/claude-web-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="Authenticate">
    Click **Add**. Claude will open the Cogniscape OAuth flow. Sign in with your Cogniscape account to authorize the connector.
  </Step>

  <Step title="Use it anywhere">
    The connector is now available on claude.ai, Claude Desktop, and the Claude iOS and Android apps under the same account. No per-device setup.
  </Step>
</Steps>

***

## Claude Code (CLI)

Run this command in your terminal to add Cogniscape as an MCP server available across all your projects:

```bash theme={null}
claude mcp add --transport http --scope user cogniscape https://mcp.cogniscape.app
```

To verify the server is connected, run `/mcp` inside a Claude Code session. To limit the server to a single project, replace `--scope user` with `--scope local`.

***

## Cursor

Open Cursor and go to **Settings > MCP**, then click **Add new MCP Server**. Alternatively, create or edit the file `~/.cursor/mcp.json` for global access:

```json theme={null}
{
  "mcpServers": {
    "cogniscape": {
      "type": "http",
      "url": "https://mcp.cogniscape.app"
    }
  }
}
```

For project-level configuration, place the file at `.cursor/mcp.json` in your project root instead. The server should appear with a green status indicator in Cursor settings after saving.

***

## Codex (OpenAI CLI)

Run this command in your terminal:

```bash theme={null}
codex mcp add --url https://mcp.cogniscape.app cogniscape
```

This saves the configuration to `~/.codex/config.toml`. Restart Codex CLI to pick up the new server.

***

## OpenCode

Create or edit `opencode.json` in your project root and add:

```json theme={null}
{
  "mcp": {
    "cogniscape": {
      "type": "remote",
      "url": "https://mcp.cogniscape.app"
    }
  }
}
```

Restart OpenCode after saving. Run `opencode mcp list` to verify the server is connected.