JetBrains IDEs
Configure JetBrains IDEs to access your Netdata infrastructure through MCP.
Supported IDEs
- IntelliJ IDEA
- PyCharm
- WebStorm
- PhpStorm
- GoLand
- DataGrip
- Rider
- CLion
- RubyMine
Transport Support
JetBrains AI Assistant currently communicates with MCP servers over stdio
only (https://www.jetbrains.com/help/ai-assistant/mcp.html).
Transport | Support | Netdata Version | Notes |
---|---|---|---|
stdio (via nd-mcp ) | ✅ Fully Supported | v2.6.0+ | Launches bridge as subprocess |
stdio (via npx mcp-remote ) | ✅ Fully Supported | v2.7.2+ | Wrap remote HTTP/SSE in stdio |
Streamable HTTP / SSE | ❌ Not Supported | - | Use a stdio launcher |
WebSocket | ❌ Not Supported | - | Accessible only through nd-mcp |
JetBrains documents a “workaround for remote servers” that relies on launching a stdio wrapper. Native HTTP/SSE support is not available yet.
Prerequisites
- JetBrains IDE installed - Any IDE from the list above
- AI Assistant plugin - Install from IDE marketplace
- Netdata v2.6.0 or later with MCP support - Prefer a Netdata Parent for full infrastructure visibility.
- Stdio launcher:
nd-mcp
bridge - Required for Netdata versions that only expose WebSocket (v2.6.0–v2.7.1)npx mcp-remote@latest
- Optional wrapper that exposes Netdata HTTP/SSE as stdio (useful for v2.7.2+)
- Netdata MCP API key exported before launching the IDE:
Each Netdata Agent or Parent has its own unique API key for MCP - Find your Netdata MCP API key
export ND_MCP_BEARER_TOKEN="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"
Installing AI Assistant
- Open your JetBrains IDE
- Go to Settings/Preferences:
- Windows/Linux: File → Settings → Plugins
- macOS: IntelliJ IDEA → Preferences → Plugins
- Search for "AI Assistant" in Marketplace
- Install and restart IDE
MCP Configuration
MCP support in JetBrains IDEs may require additional plugins or configuration. Check the plugin documentation for the latest setup instructions.
Method 1: Using nd-mcp Bridge (All Netdata versions v2.6.0+)
AI Assistant Settings:
- Go to Settings → Tools → AI Assistant
- Look for MCP or External Tools configuration
- Add Netdata MCP server:
{
"name": "netdata",
"command": "/usr/sbin/nd-mcp",
"args": [
"ws://YOUR_NETDATA_IP:19999/mcp"
]
}
External Tools (if AI Assistant doesn't support MCP directly):
- Go to Settings → Tools → External Tools
- Click "+" to add new tool
- Configure:
- Name: Netdata MCP
- Program:
/usr/sbin/nd-mcp
- Arguments:
ws://YOUR_NETDATA_IP:19999/mcp
Method 2: Using npx mcp-remote (Netdata v2.7.2+)
For detailed options and troubleshooting, see Using MCP Remote Client. JetBrains still launches this command over stdio; mcp-remote
converts the remote HTTP/SSE session into the format AI Assistant understands.
AI Assistant Settings:
{
"name": "netdata",
"command": "npx",
"args": [
"mcp-remote@latest",
"--http",
"http://YOUR_NETDATA_IP:19999/mcp",
"--allow-http",
"--header",
"Authorization: Bearer NETDATA_MCP_API_KEY"
]
}
External Tools:
- Name: Netdata MCP
- Program:
npx
- Arguments:
mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp --allow-http --header "Authorization: Bearer NETDATA_MCP_API_KEY"
Replace in all examples:
/usr/sbin/nd-mcp
- With your actual nd-mcp path (nd-mcp method only)YOUR_NETDATA_IP
- IP address or hostname of your Netdata Agent/ParentNETDATA_MCP_API_KEY
- Your Netdata MCP API keyND_MCP_BEARER_TOKEN
- Export with your API key before launching the IDE (nd-mcp method only)
Usage in Different IDEs
IntelliJ IDEA (Java/Kotlin)
Monitor JVM applications:
// Ask AI Assistant about production performance
"What's the memory usage of our Java services?"
"Show me GC patterns in the last hour"
"Are there any thread pool issues?"
PyCharm (Python)
Debug Python applications:
# Ask: What's the CPU usage when this function runs in production?
def process_data():
pass
# Ask: Show me memory patterns for the Python workers
WebStorm (JavaScript/TypeScript)
Monitor Node.js applications:
// Ask: What's the event loop latency?
// Ask: Show me API endpoint response times
// Ask: Any memory leaks in the Node processes?
DataGrip (Databases)
Analyze database performance:
-- Ask: Show me database query latency
-- Ask: What's the connection pool usage?
-- Ask: Any slow queries in the last hour?
IDE-Specific Features
Code Annotations
Add infrastructure context to your code:
@NetdataMonitor("cpu.usage > 80%")
public void resourceIntensiveMethod() {
// AI Assistant can show real-time metrics
}
Debugging with Metrics
While debugging:
- Set breakpoint
- Ask AI Assistant: "What were the system metrics when this code last ran in production?"
- Get historical context for better debugging
Performance Profiling
Combine IDE profiler with Netdata metrics:
- Run profiler in IDE
- Ask: "Show me system metrics during the profiling period"
- Correlate application and system performance
Best Practices
Development Workflow
- Before deploying: "What's the current production load?"
- During testing: "Compare metrics between dev and prod"
- After deployment: "Show me metrics changes after deployment"
Troubleshooting Production Issues
"Show me what happened at 14:32 when the error occurred"
"What were the system resources during the last OutOfMemory error?"
"Find correlated metrics during the last service degradation"
Capacity Planning
"What's the resource usage trend for this service?"
"Project memory needs based on current growth"
"When will we need to scale based on current patterns?"
Plugin Alternatives
If official MCP support is limited, consider:
MCP Bridge Plugin
Search marketplace for:
- "MCP Client"
- "Model Context Protocol"
- "External AI Tools"
Custom Plugin Development
Create a simple plugin that bridges JetBrains with Netdata:
- Use IDE Plugin SDK
- Implement MCP client
- Add tool window for Netdata metrics
Troubleshooting
AI Assistant Not Connecting
- Check MCP configuration in settings
- Restart IDE after configuration changes
No Netdata Option
- Ensure latest AI Assistant version
- Check for additional MCP plugins
- Try External Tools approach
Connection Errors
- Test Netdata access:
curl http://YOUR_NETDATA_IP:19999/api/v3/info
- Verify bridge path and permissions
- Check IDE logs for detailed errors
Limited Functionality
- Some IDEs may have restricted AI Assistant features
- Try different JetBrains IDEs for better support
- Consider using Cursor or VS Code for full MCP support
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.