> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop Setup

> Connect your Alloy MCP Server to Claude Desktop in under a minute.

## Prerequisites

1. **Claude Desktop** - [Download here](https://claude.ai/download)
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:

```bash theme={null}
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:

```json theme={null}
{
  "accessUrl": "https://mcp.runalloy.com/mcp/your-server-id/your-token"
}
```

### Step 2 - Add to Claude Desktop

#### Option A: Quick Setup (Recommended)

<Steps>
  <Step>
    Open Claude Desktop
  </Step>

  <Step>
    Go to **Settings** → **Developer** → **Custom Connectors**
  </Step>

  <Step>
    Click **Add Connector**
  </Step>

  <Step>
    Paste your `accessUrl` directly:

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

  <Step>
    Click **Save** and restart Claude Desktop
  </Step>
</Steps>

#### Option B: Manual Configuration

<Steps>
  <Step>
    Open Claude Desktop
  </Step>

  <Step>
    Go to **Settings** → **Developer** → **Edit Config**
  </Step>

  <Step>
    Add your server configuration:

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

  <Step>
    Replace the URL with your actual `accessUrl`
  </Step>

  <Step>
    Save and restart Claude Desktop
  </Step>
</Steps>

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

<CardGroup>
  <Card title="Connect your first platform" href="/mcp/getting-started/quickstart#step-4-connect-to-your-platform-1-minute" icon="arrow-right" iconType="solid" horizontal />

  <Card title="Learn about restrictions" href="/mcp/core-concepts/restrictions-guide" icon="arrow-right" iconType="solid" horizontal />

  <Card title="View available integrations" href="/mcp/core-concepts/connectors-tools" icon="arrow-right" iconType="solid" horizontal />
</CardGroup>