IDE Configuration

Cursor / VS Code / Claude Desktop

npx -y mcp-remote@latest https://your-domain/api/mcp

In the MCP configuration for each IDE, use the MCP URL above and add the required environment variables.

Cline / Windsurf

{
  "mcpServers": {
    "open-history": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-domain/api/mcp"],
      "env": {
        "MCP_OPEN_API_USER_ID": "your-user-id",
        "MCP_OPEN_API_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----"
      }
    }
  }
}

Required environment variables

• MCP_OPEN_API_USER_ID
• MCP_OPEN_API_PRIVATE_KEY or MCP_OPEN_API_PRIVATE_KEY_FILE
• MCP_SESSION_COOKIE for admin APIs

Usage notes

• /api/open/* uses automatic request signing.
• /api/documents*, /api/admin/*, /api/user/*, and /api/auth/* rely on session cookie forwarding.

Security suggestions

• Keep private keys on the server side only.
• Rotate keys immediately if they leak.
• Prefer a dedicated API user in production instead of reusing the primary admin account.