Skip to main content
If you already have the Cogniscape CLI installed, a single command configures Claude Desktop automatically — no manual JSON editing required: 
cogniscape setup mcp
Restart Claude Desktop after running the command. That’s it. The command is idempotent: running it again will update the configuration with your current key. To remove the MCP Reader from Claude Desktop: 
cogniscape setup mcp --uninstall

​
Claude Desktop (manual setup)

Open Claude Desktop and go to Settings > Developer > Edit Config to open the claude_desktop_config.json file. The file is typically located at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Paste the following into the config file: 
{
  "mcpServers": {
    "cogniscape": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.cogniscape.app/mcp-reader/mcp?customer_key=YOUR_KEY"]
    }
  }
}
Restart Claude Desktop after saving.
Replace YOUR_KEY with your customer key, available on the Customer Portal.

​
Claude Code (CLI)

Run this command in your terminal to add Cogniscape as an MCP server available across all your projects: 
claude mcp add --transport http --scope user cogniscape https://api.cogniscape.app/mcp-reader/mcp?customer_key=YOUR_KEY
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: 
{
  "mcpServers": {
    "cogniscape": {
      "type": "http",
      "url": "https://api.cogniscape.app/mcp-reader/mcp?customer_key=YOUR_KEY"
    }
  }
}
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: 
codex mcp add --url https://api.cogniscape.app/mcp-reader/mcp?customer_key=YOUR_KEY 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: 
{
  "mcp": {
    "cogniscape": {
      "type": "remote",
      "url": "https://api.cogniscape.app/mcp-reader/mcp?customer_key=YOUR_KEY"
    }
  }
}
Restart OpenCode after saving. Run opencode mcp list to verify the server is connected.