Zero-Friction Setup

Zero-Friction Setup¶

Add Xybern to your MCP config with a single API key. The server auto-registers the agent session on first connect, no pre-registration step required.

Claude Desktop / Claude Code¶

Edit ~/.claude/claude_desktop_config.json (Claude Desktop) or your project's .mcp.json (Claude Code):

{
  "mcpServers": {
    "xybern": {
      "command": "xybern-mcp",
      "env": {
        "XYBERN_API_KEY": "xb_your_key_here",
        "XYBERN_AGENT_NAME": "claude-code-prod"
      }
    }
  }
}

Cursor / Windsurf¶

Add to your MCP settings (Settings → MCP Servers → Add):

{
  "name": "xybern",
  "command": "xybern-mcp",
  "env": {
    "XYBERN_API_KEY": "xb_your_key_here"
  }
}

Environment variables¶

Variable	Required	Description
`XYBERN_API_KEY`	Yes	Your Xybern API key (starts with `xb_`)
`XYBERN_BASE_URL`	No	API base URL. Defaults to `https://www.xybern.com/api/v1`
`XYBERN_AGENT_ID`	No	Pin to a specific registered agent. Auto-registers and caches if unset.
`XYBERN_AGENT_NAME`	No	Display name for auto-registered agent. Defaults to `mcp-agent`

Info

The auto-registered agent ID is cached in ~/.xybern/mcp_agent_id so the same identity is reused across sessions without re-registering.

Install¶

pip install "xybern[mcp]"      # installs the xybern-mcp command

xybern-mcp must be on the PATH of the process that launches your MCP client; if it is not, use the full path (which xybern-mcp) as the command.