Connect VictoriaLogs

Choose your client and follow the steps below.

Visual Studio Code

Install the MCP extension

Open VS Code and install GitHub Copilot (includes MCP support) from the Extensions Marketplace, or confirm it's already installed.

Open your MCP settings

Press Ctrl+Shift+P (or ⌘+Shift+P on macOS) and search for MCP: Add Server, or manually edit:

.vscode/mcp.json

Add the server configuration

Paste the following into your mcp.json file:

{
  "servers": {
    "victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/victoriametrics-community/mcp-victorialogs"
      ],
      "env": {
        "VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_INSTANCE_BEARER_TOKEN",
        "VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE_ENTRYPOINT",
        "VL_INSTANCE_HEADERS": "YOUR_VL_INSTANCE_HEADERS",
        "MCP_SERVER_MODE": "YOUR_MCP_SERVER_MODE",
        "MCP_LISTEN_ADDR": "YOUR_MCP_LISTEN_ADDR",
        "MCP_DISABLED_TOOLS": "YOUR_MCP_DISABLED_TOOLS",
        "MCP_HEARTBEAT_INTERVAL": "YOUR_MCP_HEARTBEAT_INTERVAL"
      }
    }
  }
}

Set required environment variables

When prompted, provide values for:

VL_INSTANCE_BEARER_TOKEN VL_INSTANCE_ENTRYPOINT VL_INSTANCE_HEADERS MCP_SERVER_MODE MCP_LISTEN_ADDR MCP_DISABLED_TOOLS MCP_HEARTBEAT_INTERVAL

Start using it

Open Copilot Chat and the VictoriaLogs tools will be available automatically.

Cursor

Open Cursor Settings

Go to Cursor Settings → MCP and click + Add new global MCP server, or manually edit:

~/.cursor/mcp.json

Add the server configuration

Paste the following into your mcp.json:

{
  "mcpServers": {
    "victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/victoriametrics-community/mcp-victorialogs"
      ],
      "env": {
        "VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_INSTANCE_BEARER_TOKEN",
        "VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE_ENTRYPOINT",
        "VL_INSTANCE_HEADERS": "YOUR_VL_INSTANCE_HEADERS",
        "MCP_SERVER_MODE": "YOUR_MCP_SERVER_MODE",
        "MCP_LISTEN_ADDR": "YOUR_MCP_LISTEN_ADDR",
        "MCP_DISABLED_TOOLS": "YOUR_MCP_DISABLED_TOOLS",
        "MCP_HEARTBEAT_INTERVAL": "YOUR_MCP_HEARTBEAT_INTERVAL"
      }
    }
  }
}

Set required environment variables

Provide values for:

VL_INSTANCE_BEARER_TOKEN VL_INSTANCE_ENTRYPOINT VL_INSTANCE_HEADERS MCP_SERVER_MODE MCP_LISTEN_ADDR MCP_DISABLED_TOOLS MCP_HEARTBEAT_INTERVAL

Start using it

Open Cursor's AI chat — the VictoriaLogs tools will appear automatically.

ChatGPT (Desktop)

Open ChatGPT Desktop settings

Click your profile icon → Settings → Beta features and ensure MCP plugin support is enabled.

Add the MCP server

Navigate to Settings → MCP Servers → + Add Server and paste:

{
  "mcpServers": {
    "victorialogs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/victoriametrics-community/mcp-victorialogs"
      ],
      "env": {
        "VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_INSTANCE_BEARER_TOKEN",
        "VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE_ENTRYPOINT",
        "VL_INSTANCE_HEADERS": "YOUR_VL_INSTANCE_HEADERS",
        "MCP_SERVER_MODE": "YOUR_MCP_SERVER_MODE",
        "MCP_LISTEN_ADDR": "YOUR_MCP_LISTEN_ADDR",
        "MCP_DISABLED_TOOLS": "YOUR_MCP_DISABLED_TOOLS",
        "MCP_HEARTBEAT_INTERVAL": "YOUR_MCP_HEARTBEAT_INTERVAL"
      }
    }
  }
}

Set required environment variables

Provide values for:

VL_INSTANCE_BEARER_TOKEN VL_INSTANCE_ENTRYPOINT VL_INSTANCE_HEADERS MCP_SERVER_MODE MCP_LISTEN_ADDR MCP_DISABLED_TOOLS MCP_HEARTBEAT_INTERVAL

Start using it

Start a new chat — VictoriaLogs tools will be available when the server is connected.

Claude Desktop

Open Claude Desktop config

Open the Claude Desktop configuration file at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add to the mcpServers object

Merge the following into the "mcpServers" key:

{
  "victorialogs": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "ghcr.io/victoriametrics-community/mcp-victorialogs"
    ],
    "env": {
      "VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_INSTANCE_BEARER_TOKEN",
      "VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE_ENTRYPOINT",
      "VL_INSTANCE_HEADERS": "YOUR_VL_INSTANCE_HEADERS",
      "MCP_SERVER_MODE": "YOUR_MCP_SERVER_MODE",
      "MCP_LISTEN_ADDR": "YOUR_MCP_LISTEN_ADDR",
      "MCP_DISABLED_TOOLS": "YOUR_MCP_DISABLED_TOOLS",
      "MCP_HEARTBEAT_INTERVAL": "YOUR_MCP_HEARTBEAT_INTERVAL"
    }
  }
}

Set required environment variables

Replace the placeholder values for:

VL_INSTANCE_BEARER_TOKEN VL_INSTANCE_ENTRYPOINT VL_INSTANCE_HEADERS MCP_SERVER_MODE MCP_LISTEN_ADDR MCP_DISABLED_TOOLS MCP_HEARTBEAT_INTERVAL

Restart Claude Desktop

Quit and reopen Claude Desktop. The VictoriaLogs tools will appear in the tools menu.