LM Studio

Requirements

LM Studio version 0.3.17 or later is required for MCP support.

Quick Setup

Click the button below to automatically add Macuse to LM Studio:

Manual Configuration

LM Studio uses the same mcp.json format as Cursor for server configuration.

Option 1: stdio (Recommended)

Open LM Studio
Navigate to the Program tab in the right sidebar
Select Install > Edit mcp.json
Add the following configuration:

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

Save and restart LM Studio

Option 2: HTTP with API Key

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

Open Macuse Settings → Connections, click +, enter "LM Studio" as the name, and click Create
Copy the API key immediately (it is only shown once)
Navigate to Program > Install > Edit mcp.json in LM Studio and add the configuration:

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

Save and restart LM Studio

If you skip creating an API key manually, Macuse can also detect LM 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

Open LM Studio and start a new chat with a loaded model
Ask the AI to "list available Macuse tools"
If configured correctly, the AI will show the available toolboxes