Cursor

Automatic Setup

1. Open Macuse from your menu bar
2. Click the Server card
3. Under Quick Setup, click the Install button next to Cursor
4. Macuse will open Cursor via deeplink and prompt you to confirm the installation
5. Restart Cursor to apply changes

Manual Configuration

If automatic setup doesn't work, you can manually configure Cursor.

Option 1: stdio (Recommended)

1. Open Cursor Settings (Cmd + ,)
2. Search for "MCP" and open MCP settings
3. Add a new MCP server with this configuration:

{
  "macuse": {
    "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
    "args": ["mcp"]
  }
}

Save and restart Cursor.

Option 2: HTTP with API Key

If stdio doesn't work, you can connect via HTTP using an API Key:

1. Open Macuse Settings → Connections, click +, enter "Cursor" as the name, and click Create
2. Copy the API key immediately (it is only shown once)
3. Edit ~/.cursor/mcp.json with the complete configuration:

{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}

4. Restart Cursor

See the API Keys page for more details.

Verifying the Connection

1. Open Cursor and start a new AI chat
2. Ask the AI to "list available Macuse tools"
3. If configured correctly, the AI will show the available toolboxes