Skip to main content

Prerequisites

  1. Cursor IDE - 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: Configure Cursor

Add to your project’s .cursor/mcp.json file:
{
  "mcpServers": {
    "Alloy Automation": {
      "url": "https://mcp.runalloy.com/mcp/<server-id>/<token>"
    }
  }
}

Option B: Global Settings

Create ~/.cursor/mcp.json in your home directory:
{
  "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

I