Cursor

Project file .cursor/mcp.json, or ~/.cursor/mcp.json for every project.

Save the file. Open Cursor Settings → MCP and turn mcp-reference-server on. A green dot means the handshake worked. In Agent chat, ask: search open tickets.

Hosted server

Streamable HTTP

{
  "mcpServers": {
    "mcp-reference-server": {
      "url": "https://your-app.onrender.com/mcp"
    }
  }
}

Code Engine

Same shape. Different host.

{
  "mcpServers": {
    "mcp-reference-server": {
      "url": "https://your-app.xxxx.ca-tor.codeengine.appdomain.cloud/mcp"
    }
  }
}

Local npx

Cursor starts the process. stdio is the default. Node.js 18 or newer is required.

{
  "mcpServers": {
    "mcp-reference-server": {
      "command": "npx",
      "args": ["-y", "mcp-reference-server"],
      "env": { "MCP_MODE": "stdio" }
    }
  }
}

When a key is required

Auth is off on a fresh server. When auth mode is write or all, add the header on the hosted entry. Over stdio, put the key in MCP_API_KEY.

{
  "mcpServers": {
    "mcp-reference-server": {
      "url": "https://your-app.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer <key>"
      }
    }
  }
}

An older Cursor setup reaches the same host through uvx mcp-proxy and /sse. The url block above is the current Streamable HTTP entry. Render and Code Engine are separate ticket stores from a laptop stdio process.