Claude Desktop Setup

​

Prerequisites

1. Claude Desktop - Download here
2. Alloy MCP Server - Already created with an access URL

​

Setup Instructions

​

Step 1 - Get Your Access URL

curl -X POST https://mcp.runalloy.com/api/servers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My MCP Server"}'

{
  "accessUrl": "https://mcp.runalloy.com/mcp/your-server-id/your-token"
}

​

Step 2 - Add to Claude Desktop

​

Option A: Quick Setup (Recommended)

https://mcp.runalloy.com/mcp/<server-id>/<token>

​

Option B: Manual Configuration

{
  "mcpServers": {
    "Alloy Automation": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@latest",
        "--streamableHttp",
        "https://mcp.runalloy.com/mcp/<server-id>/<token>"
      ]
    }
  }
}

​

Testing Your Connection

"What tools do you have access to?"
"Show me available platforms to connect"
"Help me connect to Slack"

​

Troubleshooting

​

No Tools Available

• Verify your access URL is complete (includes server ID and token)
• Check that your server hasn’t been deleted
• Ensure Claude Desktop was restarted after configuration

​

Connection Failed

• Confirm the URL in your config matches your accessUrl exactly
• Check your internet connection
• Verify your API key is still valid

​

Next Steps