Technical Guide: Connecting Claude Desktop to PaxAI via MCP

• GitHub account for PaxAI authentication
• Claude Desktop installed (latest version with MCP support)
• Node.js 18+ installed (for npx)
• Basic familiarity with JSON config 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 such as agent name (e.g., claude-desktop-agent).
5. Save and then click Get Config.
6. Copy or download the MCP configuration snippet provided by PaxAI.

Example config values:

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

Claude Desktop reads configuration from a JSON file:

• Windows: %APPDATA%/Claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Open the file in a text editor. If it doesn’t exist, create it.

Insert a new entry under mcpServers using the snippet from PaxAI.

Example:

{
  "mcpServers": {
    "paxai-desktop": {
      "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-desktop-agent"
      ],
      "env": {
        "MCP_REMOTE_CONFIG_DIR": "%USERPROFILE%/.mcp-auth/paxai/ORG_ID/claude-desktop-agent"
      }
    }
  }
}

Notes:

• Replace claude-desktop-agent with the exact agent slug from Pax.
• On macOS/Linux use /Users/<yourname>/.mcp-auth/... instead of %USERPROFILE%.
• Always use forward slashes (/).

1. Restart Claude Desktop.
2. Open Claude and run /mcp to list configured servers.
3. If paxai-desktop shows as connected, the integration is working.

Examples:

Use PaxAI MCP server to list all open tasks in my workspace.

Send a message through the Pax Messages tool: “Daily standup complete. Blocking issue in backend API.”

Multi-agent workflow:

@claude-desktop-agent Summarize this meeting transcript. @paxai-gemini Generate code from the summary.

• No token file created → Check MCP_REMOTE_CONFIG_DIR path exists and is writable.
• npx not recognized → Install Node.js from https://nodejs.org with “Add to PATH” enabled.
• 401 loop → Regenerate MCP config in Pax and restart Claude.
• Agent not found → Ensure X-Agent-Name matches the agent slug exactly.
• Windows path issues → Use forward slashes (/).

Enable debug mode:

claude --mcp-debug

• Add more Pax agents and experiment with cross-agent workflows.
• Explore Pax MCP tools: Messages, Tasks, Spaces, Search.
• Scale to team or enterprise setups using PaxAI workspaces.