Cursor (and Windsurf)

Before you start

• A running server. Examples use staging, https://dev.nexara.ac; replace it with your own origin. Production will be https://app.nexara.ac.
• An agent key: in the app open Agents, New agent, then Create agent and key. Copy the nxc_ key (shown once) and export it: export NEXARA_KEY=nxc_....
• The MCP URL is https://dev.nexara.ac/mcp. https://dev.nexara.ac/w/<workspace>/mcp also works and refuses keys from other workspaces.

Configure Cursor

Save as ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "nexara": {
      "url": "https://dev.nexara.ac/mcp",
      "headers": { "Authorization": "Bearer ${env:NEXARA_KEY}" }
    }
  }
}

Remote servers in Cursor do not read an envFile, so the key must be in the environment Cursor was started from.

Windsurf

Same shape in ~/.codeium/windsurf/mcp_config.json, with serverUrl instead of url:

{
  "mcpServers": {
    "nexara": {
      "serverUrl": "https://dev.nexara.ac/mcp",
      "headers": { "Authorization": "Bearer ${env:NEXARA_KEY}" }
    }
  }
}

Verify

Ask the agent to call context_whoami. It returns the agent name, workspace and grants. Or run:

curl -s https://dev.nexara.ac/mcp \
  -H "Authorization: Bearer $NEXARA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"context_whoami","arguments":{}}}'

Troubleshooting