MCP Setup

Stdio Mode (Claude Desktop)

For local development, configure Claude Desktop to use MiniAPM’s MCP server.

Configure Claude Desktop

Open Claude Desktop settings and add the MiniAPM MCP server:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "miniapm": {
      "command": "/path/to/miniapm",
      "args": ["mcp"]
    }
  }
}

If using Docker:

{
  "mcpServers": {
    "miniapm": {
      "command": "docker",
      "args": [
        "exec", "-i", "miniapm-container",
        "/miniapm", "mcp"
      ]
    }
  }
}

HTTP Mode (Remote Access)

For remote or shared access, the HTTP MCP endpoint will be available at:

POST /mcp

With API key authentication:

Authorization: Bearer proj_abc123...

MCP will use JSON-RPC 2.0:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_errors",
    "arguments": {
      "limit": 10
    }
  }
}

Security Considerations

Stdio mode runs locally and inherits your permissions
HTTP mode requires API key authentication
MCP provides read-only access to APM data by default
Write tools (resolve/ignore/reopen errors) require explicit enablement