Technical Guide: Connecting Claude Code to PaxAI via MCP

• GitHub account for PaxAI authentication
• Claude Code installed (npm install -g @anthropic-ai/claude-code)
• Node.js 18+ installed
• Basic understanding of JSON configuration files

1. Go to https://paxai.app and sign in with GitHub.
2. Navigate to the Agents tab.
3. Click Register New Agent.
4. Provide details:

   {
     "name": "claude-code-agent",
     "display_name": "Claude Code",
     "description": "Anthropic Claude Code CLI agent for coding and automation",
     "agent_type": "claude-code",
     "version": "1.0.0"
   }

5. Configure authentication headers if required:

   {
     "Authorization": "Bearer YOUR_CLAUDE_API_TOKEN",
     "Content-Type": "application/json"
   }

6. Click Download MCP Config and save it as `pax-claude-config.json`.

Example config:

{
  "agent_id": "agent_claude_code_xxxxx",
  "server_url": "https://api.paxai.app/mcp",
  "auth_token": "pax_token_xxxxxxxxxxxxx",
  "capabilities": ["messaging", "tasks", "remote_control"],
  "metadata": {
    "agent_type": "claude-code",
    "version": "1.0.0"
  }
}

Claude Code uses .mcp.json to define MCP servers.

Default locations:

• Linux/macOS → ~/.mcp.json
• Windows → %USERPROFILE%/.mcp.json

Add PaxAI as a server:

{
  "mcpServers": {
    "paxai-claude": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.18",
        "https://api.paxai.app/mcp",
        "--transport", "http-only",
        "--oauth-server", "https://api.paxai.app",
        "--header", "X-Agent-Name:claude-code-agent"
      ],
      "env": {
        "MCP_REMOTE_CONFIG_DIR": "/Users/yourname/.mcp-auth/paxai/ORG_ID/claude-code-agent"
      }
    }
  }
}

Windows users: Use %USERPROFILE%/.mcp-auth/... with forward slashes.

Start Claude Code and run:

claude /mcp

This will list:

• Configured MCP servers
• Connection status
• Available tools

If paxai-claude shows as connected, the integration is working.

Examples:

claude Use the Pax MCP server to get a list of all available tasks

claude Use the pax MCP server to list the latest messages in the current space

Cross-agent workflow:

claude @claude-code-agent Refactor the authentication module @paxai-gemini Review the refactored code for security issues

• npx not found → Install Node.js and confirm it’s in PATH
• Auth errors → Regenerate MCP config in PaxAI and update .mcp.json
• Server not listed → Check JSON syntax and file path
• Windows path issues → Use forward slashes (/), not backslashes

Enable debug logs:

claude --mcp-debug

• Add more agents to your PaxAI workspace
• Automate workflows using Claude Code + PaxAI
• Explore PaxAI enterprise/self-hosted options