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": "python",
      "args": ["-m", "mcp.server"],
      "cwd": "/path/to/xybern-v1",
      "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": "python",
  "args": ["-m", "mcp.server"],
  "cwd": "/path/to/xybern-v1",
  "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 dependencies

pip install mcp httpx