Skip to main content
Cursor supports servers natively. You can configure OpenCX at the project level (shared with your team) or globally (for your machine only).
MCP tools only work in Agent mode. If you’re in Ask mode, Cursor won’t call any tools. Switch to Agent mode before testing.

​
Setup

1

Open MCP settings

Go to Cursor Settings > MCP and click Add new global MCP server (or Add new project MCP server for project-scoped config).
2

Paste the config

{
  "mcpServers": {
    "opencx": {
      "command": "npx",
      "args": ["-y", "@opencx/mcp"],
      "env": {
        "OPENCX_API_KEY": "your-api-key-here"
      }
    }
  }
}
Replace your-api-key-here with your OpenCX API key.
3

Verify

Open a new Agent mode chat and ask: “List my recent chat sessions.”If you get results, the server is connected.

​
Project vs Global Config

ScopeFileShared with teamUse when
Project.cursor/mcp.json in repo rootYes (commit the file)Team shares the same MCP setup
Global~/.cursor/mcp.jsonNoPersonal tools across all projects
When using project-scoped config, reference OPENCX_API_KEY as an environment variable in the env block — don’t hardcode the key in a committed file. Each team member sets the key in their local shell profile or .env.

​
Agent Mode vs Ask Mode

Cursor has two chat modes:
  • Agent mode — can call MCP tools, read/write files, run commands. This is where OpenCX tools work.
  • Ask mode — read-only, no tool calls. MCP tools are unavailable.
If your prompts aren’t triggering OpenCX tools, check the mode toggle at the top of the chat panel.

​
Debugging

If the server isn’t connecting or tools aren’t appearing:
  1. Check the MCP panel — go to Cursor Settings > MCP. Each server shows a status indicator (green = connected, red = error). Click the server name to see logs.
  2. Restart the server — click the refresh icon next to the server name in the MCP panel.
  3. Check the output — Cursor shows MCP tool calls and responses inline in the chat. If a tool call fails, the error message appears in the response.
  4. Verify Node.js — run node --version in Cursor’s terminal. The MCP server requires Node.js 18+.

Get Started

API key setup and all client configs

VS Code

mcp.json and Copilot Chat

Prompt Library

Ready-to-use prompts by domain

Troubleshooting

Common issues and fixes