Warp

Manual Configuration

Option 1: stdio (Recommended)

1. Open Warp
2. Navigate to Settings → Features → MCP Servers, or edit ~/.warp/mcp.json directly
3. Add the following configuration:

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

4. Save and restart Warp

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 "Warp" as the name, and click Create
2. Copy the API key immediately (it is only shown once)
3. Add the following to your Warp MCP configuration:

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

4. Save and restart Warp

See the API Keys page for more details.

Verifying the Connection

1. Open Warp 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