MacuseMacuse
Clients

JetBrains

Works with IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider, and other JetBrains IDEs.

Manual Configuration

  1. Open your JetBrains IDE
  2. Go to SettingsToolsAI AssistantModel Context Protocol (MCP)Add
  3. Add the following configuration:
{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}
  1. Save and restart your IDE

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

If you skip creating an API key manually, Macuse can also detect JetBrains IDEs 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 your JetBrains IDE and start a new AI Assistant chat
  2. Ask the AI to "list available Macuse tools"
  3. If configured correctly, the AI will show the available toolboxes

On this page