MacuseMacuse
Clients

Cherry Studio

Manual Configuration

  1. Open Cherry Studio
  2. Navigate to SettingsMCP ServersAdd Server
  3. Add the following configuration:
{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}
  1. Save and restart Cherry Studio

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 "Cherry Studio" as the name, and click Create
  2. Copy the API key immediately (it is only shown once)
  3. Add the following to your Cherry Studio MCP configuration:
{
  "mcpServers": {
    "macuse": {
      "url": "http://127.0.0.1:35729/mcp",
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  }
}
  1. Save and restart Cherry Studio

If you skip creating an API key manually, Macuse can also detect Cherry Studio automatically after 3 failed connection attempts and prompt you to generate one. See Automatic Detection for details.

See the API Keys page for more details.

Verifying the Connection

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

On this page