> ## 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.

# Cursor IDE Setup

> Connect your Alloy MCP Server to Cursor IDE in under a minute.

## Prerequisites

1. **Cursor IDE** - [Download here](https://cursor.sh)
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: Configure Cursor

#### Option A: Project Settings (Recommended)

Add to your project's `.cursor/mcp.json` file:

```json theme={null}
{
  "mcpServers": {
    "Alloy Automation": {
      "url": "https://mcp.runalloy.com/mcp/<server-id>/<token>"
    }
  }
}
```

#### Option B: Global Settings

Create `~/.cursor/mcp.json` in your home directory:

```json theme={null}
{
  "mcpServers": {
    "Alloy Automation": {
      "url": "https://mcp.runalloy.com/mcp/<server-id>/<token>"
    }
  }
}
```

Replace the URL with your actual `accessUrl` and restart Cursor.

## Testing Your Connection

In Cursor's AI chat, try these commands:

```
"What MCP tools are available?"
"List my Slack channels"
"Create a task in Notion"
```

## Use Cases in Cursor

### Automated Documentation

```
"Document this function and create a Notion page with the documentation"
```

### Code Review Notifications

```
"Send a Slack message to #dev-team that the PR is ready for review"
```

### Issue Tracking

```
"Create a GitHub issue for this TODO comment"
```

## Troubleshooting

### Tools Not Available

* Ensure Cursor was restarted after configuration
* Check that your `accessUrl` is complete with token
* Verify the configuration syntax is correct

### Connection Errors

* Check your internet connection
* Ensure your MCP server is still active
* Verify your API key hasn't expired

## Next Steps

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

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

  <Card title="Learn about authentication" href="/mcp/security/authentication-security" icon="arrow-right" iconType="solid" horizontal />
</CardGroup>