Claude Desktop

Connect Claude Desktop to the Aphelios MCP server so you can ask questions about your shipments in natural language.

Configuration

Claude Desktop communicates over stdio, so it needs mcp-remote to bridge to the Aphelios HTTP server.

Add the following to your Claude Desktop config file:

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

{
  "mcpServers": {
    "aphelios": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.aphelios.ai/v1/mcp",
        "--header",
        "Authorization: Bearer aph_live_YOUR_API_KEY",
        "--header",
        "Accept: application/json, text/event-stream"
      ]
    }
  }
}

Replace aph_live_YOUR_API_KEY with your actual API key.

Node.js not found?

If Claude Desktop can't find npx, set the full path in command and add your Node.js bin directory to PATH:

{
  "mcpServers": {
    "aphelios": {
      "command": "/usr/local/bin/npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.aphelios.ai/v1/mcp",
        "--header",
        "Authorization: Bearer aph_live_YOUR_API_KEY",
        "--header",
        "Accept: application/json, text/event-stream"
      ],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Adjust the path to match your Node.js installation. Common locations:

Install method	Typical path
nvm	~/.nvm/versions/node/v20.x.x/bin
Homebrew (macOS)	/opt/homebrew/bin
System (Linux)	/usr/local/bin
fnm	~/.local/share/fnm/aliases/default/bin

Usage

After restarting Claude Desktop, you should see the Aphelios tools available. Try:

• "Where is shipment MAEU123456789?"
• "Show me all delayed shipments"
• "Which containers have their last free day expiring this week?"
• "List shipments arriving at Los Angeles tomorrow"
• "Get full details for container MSKU1234567"