Clients
JetBrains
Works with IntelliJ IDEA, WebStorm, PyCharm, GoLand, Rider, and other JetBrains IDEs.
Manual Configuration
Option 1: stdio (Recommended)
- Open your JetBrains IDE
- Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add
- Add the following configuration:
{
"mcpServers": {
"macuse": {
"command": "/Applications/Macuse.app/Contents/MacOS/macuse",
"args": ["mcp"]
}
}
}- 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:
- Open Macuse Settings → Connections, click +, enter your IDE name (e.g. "WebStorm") as the name, and click Create
- Copy the API key immediately (it is only shown once)
- Add the following to your JetBrains MCP configuration:
{
"mcpServers": {
"macuse": {
"url": "http://127.0.0.1:35729/mcp",
"headers": {
"Authorization": "Bearer <your_api_key>"
}
}
}
}- 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
- Open your JetBrains IDE and start a new AI Assistant chat
- Ask the AI to "list available Macuse tools"
- If configured correctly, the AI will show the available toolboxes