Claude Code

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.

Add the server

User scope (all projects):

claude mcp add --transport http --scope user nexara https://dev.nexara.ac/mcp \
  --header "Authorization: Bearer $NEXARA_KEY"

Or per project, in .mcp.json at the repo root. ${NEXARA_KEY} is expanded from your environment, so the key never lands in git:

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

If you leave the header out, Claude Code runs the OAuth flow instead (loopback redirect, consent in your browser).

Load context at session start (optional)

Add a line to your project's CLAUDE.md:

Before starting, call the nexara `context_bundle` tool with the task as intent. Record decisions with `context_propose`.

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