# InfluxDB 3

Официальный MCP-сервер InfluxDB 3: агент читает и пишет данные, смотрит схему и разбирает ошибки запросов. Пригодится, когда нужно копаться в базе прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 38
- Автор: influxdata
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/influxdata/influxdb3_mcp_server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/influxdb-3

## Что делает

Сервер даёт агенту инструменты для работы с InfluxDB 3 Core, Enterprise, Cloud Dedicated, Clustered и Cloud Serverless. Через него можно выполнять SQL и InfluxQL, писать данные, управлять базами и токенами. Список инструментов зависит от профиля: при `INFLUX_MCP_TOOL_PROFILE=readonly` остаются только чтение и разведка, а всё, что пишет или администрирует, отключается.

Токен передаётся в заголовке `Bearer`, и сервер его не проверяет — права решает сам токен. Поэтому урезанный токен просто не увидит лишние базы. Ошибки приходят структурно: у них есть `error.code`, `error.recovery` и `error.retryable`. Скажем, `403` означает `not_found_or_denied`, а запрос к несуществующей таблице советует поправить ссылку через `list_tables` или `describe_table`.

Для запуска нужен Node.js v20.11 или новее, а также URL и токен инстанса InfluxDB 3. В Docker-сборке понадобится Docker. Локальная разработка идёт через pnpm — версия закреплена в `package.json`, включить её можно командой `corepack enable`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `INFLUX_DB_PRODUCT_TYPE`, `INFLUX_DB_TOKEN`, `INFLUX_DB_INSTANCE_URL`, `INFLUX_DB_MANAGEMENT_TOKEN`, `INFLUX_DB_ACCOUNT_ID`, `INFLUX_DB_CLUSTER_ID`, `INFLUX_MCP_TOOL_PROFILE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> --transport stdio influxdb-3 -- npx -y @influxdata/influxdb3-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add influxdb-3 --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> -- npx -y @influxdata/influxdb3-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "influxdb-3": {
            "command": "npx",
            "args": [
                "-y",
                "@influxdata/influxdb3-mcp-server"
            ],
            "env": {
                "INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
                "INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
                "INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
                "INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
                "INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "influxdb-3": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@influxdata/influxdb3-mcp-server"
            ],
            "env": {
                "INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
                "INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
                "INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
                "INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
                "INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> -e INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> -e INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> -e INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> -e INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> influxdb-3 npx -y @influxdata/influxdb3-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- выполнить SQL или InfluxQL по базе прямо из агента
- посмотреть список баз, таблиц и колонок перед запросом
- разобрать, почему панель перестала показывать данные после деплоя
- отличить отсутствующие данные от сломанного запроса
- дать агенту доступ только на чтение, без записи и администрирования

## Примеры запросов агенту
- Покажи список баз и таблиц в InfluxDB, потом посчитай среднюю температуру по датчикам за сутки
- Почему этот запрос InfluxQL возвращает пустой результат? Проверь измерение и колонки
- Собери ограниченный SQL-запрос по таблице `sensors` и верни строки с предупреждениями

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md