Skip to main content

​
Prerequisites

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

​
Setup Instructions

​
Step 1 - Get Your Access URL

First, create an MCP server if you haven’t already: 
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"}'
Copy the accessUrl from the response: 
{
  "accessUrl": "https://mcp.runalloy.com/mcp/your-server-id/your-token"
}

​
Step 2 - Add to Claude Desktop

1
Open Claude Desktop
2
Go to Settings → Developer → Custom Connectors
3
Click Add Connector
4
Paste your accessUrl directly:
https://mcp.runalloy.com/mcp/<server-id>/<token>
5
Click Save and restart Claude Desktop

​
Option B: Manual Configuration

1
Open Claude Desktop
2
Go to Settings → Developer → Edit Config
3
Add your server configuration:
{
  "mcpServers": {
    "Alloy Automation": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway@latest",
        "--streamableHttp",
        "https://mcp.runalloy.com/mcp/<server-id>/<token>"
      ]
    }
  }
}
4
Replace the URL with your actual accessUrl
5
Save and restart Claude Desktop
That’s it! Claude can now access all your connected business platforms.

​
Testing Your Connection

In Claude Desktop, try these commands: 
"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

Connect your first platform

Learn about restrictions

View available integrations