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)

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

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

5. Save and restart LM Studio

Option 2: HTTP with Bearer Token

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

1. Navigate to Program > Install > Edit mcp.json in LM Studio
2. Add the server URL first (without headers):

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

3. Save and restart LM Studio, let it attempt to connect
4. After three failed connection attempts, Macuse will show a popup to generate a token
5. Click Generate Token and copy the configuration snippet
6. Update the configuration with the Bearer Token:

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

7. Save and restart LM Studio again

See the Bearer Token Authentication section for more details.

Verifying the Connection

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