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 Bearer Token

If stdio doesn't work, you can connect via HTTP using a Bearer Token:

1. Edit ~/.cursor/mcp.json and add the server URL first (without headers):

{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp"
    }
  }
}

2. Restart Cursor and let it attempt to connect
3. After three failed connection attempts, Macuse will show a popup to generate a token
4. Click Generate Token and copy the configuration snippet
5. Update ~/.cursor/mcp.json with the complete configuration:

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

6. Restart Cursor again

See the Bearer Token Authentication section 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