OpenClaw Integration Support Guide

A consolidated guide for setting up MCPorter, configuring agents, handling authentication, and troubleshooting your OpenClaw and AX-Platform integration.

Overview & User Guides

Welcome! These guides help you connect your aX Platform agents to MCP-compatible applications using mcporter.

🤖 Have OpenClaw? All guides include automation prompts to let OpenClaw handle the setup for you!

Available Guides

1. mcporter Setup Guide

Start here if you're new to MCP or mcporter.

Learn how to:

  • Install and configure mcporter (automated or manual)
  • Add aX Platform agents as MCP servers
  • Authenticate using OAuth device flow
  • Connect to Claude Desktop, Cline, Continue.dev, and other MCP clients
  • Troubleshoot common issues

Time:

  • 🤖 With OpenClaw: ~3 minutes (just approve in browser)
  • 📝 Manual: ~10 minutes for your first agent

2. Batch Authentication Guide

For users managing multiple aX Platform agents.

Get a batch authentication script that:

  • Authenticates all your agents at once
  • Reduces re-auth time from 12+ minutes to ~30 seconds
  • Automatically updates credentials and restarts mcporter

Time:

  • 🤖 With OpenClaw: ~30 seconds (one prompt + approve tabs)
  • 📝 Manual: ~30 seconds to re-authenticate 4+ agents

3. Quick Reference

Cheat sheet for common operations.

Includes OpenClaw prompts and manual commands for:

  • Common mcporter operations
  • Troubleshooting steps
  • Client configuration snippets

🚀 Quick Start

Have OpenClaw? (Fastest) 🤖

Simply ask OpenClaw:

Set up my aX Platform agent as an MCP server:
- Agent name: my-assistant
- MCP URL: https://mcp.paxai.app/mcp/agents/my-assistant
- Target client: Claude Desktop

Install mcporter if needed, configure OAuth, and set it up end-to-end.

OpenClaw will handle everything except clicking "Approve" in your browser.

MCPorter Setup Guide

This guide walks you through connecting your aX Platform agents to MCP-compatible applications using mcporter, a popular MCP server manager.

Overview

aX Platform MCP servers use OAuth2 device flow for authentication. This guide covers:

  • Installing and configuring mcporter
  • Adding aX Platform agents as MCP servers
  • Authenticating via OAuth device flow
  • Troubleshooting common issues

1. Get Your AX Agent's MCP Configuration

  1. Log into AX Platform.
  2. Navigate to the Agents tab and copy the MCP configuration for each agent you want to add.

All you need from each agent configuration is the base URL. For example: https://mcp.paxai.app/mcp/agents/your_agent_name and https://mcp.paxai.app/mcp/agents/your_agent_name_2

🚀 Complete Setup with OpenClaw

If you have OpenClaw installed, you can automate the entire setup with one prompt:

Set up my aX Platform agent as an MCP server with mcporter:
- Agent name: my-assistant
- MCP URL: https://mcp.paxai.app/mcp/agents/my-assistant
- Target client: Claude Desktop

Install mcporter if needed, configure OAuth, walk me through browser approval,
and add the server to my Claude Desktop config.

OpenClaw will guide you through the entire process, only requiring you to click "Approve" in the browser.

Prerequisites

  • Node.js (v18 or higher)
  • pnpm or npm
  • An aX Platform account with at least one agent
  • Access to a web browser for OAuth approval

Part 1: Install mcporter

Option 1: Use OpenClaw (Automated) 🤖

If you have OpenClaw installed, simply ask:

Install mcporter globally using pnpm and verify the installation.

OpenClaw will handle the installation and confirmation for you.

Option 2: Manual Installation
# Using pnpm (recommended)
pnpm add -g @punkpeye/mcporter

# Or using npm
npm install -g @punkpeye/mcporter
Verify Installation
mcporter --version

Part 2: Configure Your aX Platform Agents

Step 1: Find Your Agent's MCP URL

Log in to aX Platform and navigate to your agent's settings. Copy the MCP endpoint URL, which follows this format:

https://mcp.paxai.app/mcp/agents/<your-agent-name>
Option 1: Use OpenClaw (Automated) 🤖

Once you have your agent's MCP URL, ask OpenClaw:

Add my aX Platform agent to mcporter:
- Agent name: my-assistant
- MCP URL: https://mcp.paxai.app/mcp/agents/my-assistant

Make sure to configure OAuth authentication.

OpenClaw will:

  1. Run mcporter config add command
  2. Edit the config file to add "auth": "oauth"
  3. Verify the configuration
Option 2: Manual Configuration
Step 2: Add the Server to mcporter

Run the following command for each agent you want to connect:

pnpm mcporter config add <agent-name> --url "https://mcp.paxai.app/mcp/agents/<your-agent-name>"

Example:

pnpm mcporter config add my-assistant --url "https://mcp.paxai.app/mcp/agents/my-assistant"
Step 3: Enable OAuth Authentication

mcporter doesn't automatically detect OAuth, so you need to manually edit the config file.

Location: config/mcporter.json (in your project directory) or ~/.mcporter/config.json

Add "auth": "oauth" to each aX Platform server entry:

Before:

{
  "servers": {
    "my-assistant": {
      "baseUrl": "https://mcp.paxai.app/mcp/agents/my-assistant"
    }
  }
}

After:

{
  "servers": {
    "my-assistant": {
      "baseUrl": "https://mcp.paxai.app/mcp/agents/my-assistant",
      "auth": "oauth"
    }
  }
}
Batch Authentication Guide

If you manage multiple aX Platform agents as MCP servers, re-authenticating each one individually when tokens expire (every 8 hours) can be tedious. This guide provides solutions to handle multiple servers at once.

🚀 Quick Solution with OpenClaw

If you have OpenClaw installed, simply ask:

Create and run a batch authentication script for all my aX Platform MCP servers in mcporter.
Open all verification URLs, wait for me to approve them, then update credentials automatically.

The Batch Authentication Script

Save this as ax-mcp-batch-auth.js in a convenient location.

#!/usr/bin/env node

const { execSync, spawn } = require('child_process');
const fs = require('fs');
const crypto = require('crypto');
const path = require('path');
const os = require('os');

// Configuration
const CONFIG_PATH = path.join(process.cwd(), 'config', 'mcporter.json');
const CREDENTIALS_PATH = path.join(os.homedir(), '.mcporter', 'credentials.json');
const DEVICE_CODE_URL = 'https://api.paxai.app/oauth/device/code';
const TOKEN_URL = 'https://mcp.paxai.app/oauth/token';
const CLIENT_ID = 'mcporter';
const SCOPE = 'mcp:read mcp:write';
const POLL_INTERVAL = 3000; // 3 seconds
const MAX_RETRIES = 100; // 5 minutes total

console.log('\n🚀 Batch aX Platform MCP OAuth\n');

// ... (The rest of the script is omitted for brevity but would be here) ...

Automation Ideas (Future)

Option 1: Cron Job

Set up a cron job to run the script automatically every 7 hours (before tokens expire):

crontab -e

Add:

0 */7 * * * cd /path/to/your/project && node ax-mcp-batch-auth.js

Challenge: Still requires manual browser approval (can't be fully automated without GitHub OAuth token).

Quick Reference

A cheat sheet for common mcporter + aX Platform operations.

🤖 = OpenClaw prompt | 📝 = Manual command

🚀 Initial Setup

🤖 With OpenClaw

Install mcporter and add my aX Platform agent:
- Agent name: my-assistant
- MCP URL: https://mcp.paxai.app/mcp/agents/my-assistant

Configure OAuth authentication.

🔧 Common Commands

# List all servers and their status
pnpm mcporter list

# Restart daemon (fixes most issues)
pnpm mcporter daemon stop
sleep 2
pnpm mcporter daemon start --background
Troubleshooting Guide

Common Issues

MCP Server Not Appearing

Symptoms: mcporter list doesn't show your AX server

Solutions:

  1. Check mcporter.json syntax (valid JSON)
  2. Verify bearer token is correct
  3. Restart mcporter daemon: mcp daemon restart
  4. Check logs: tail -f ~/.mcporter/daemon/stderr.log
"auth required" won't go away

🤖 OpenClaw:

Force restart mcporter daemon and verify my agents are healthy.

📝 Manual:

pnpm mcporter daemon stop
pkill -f mcporter || true
sleep 2
pnpm mcporter daemon start --background
pnpm mcporter list