# loki

Подключает Grafana Loki к Claude Code через MCP. Позволяет искать логи через LogQL и просматривать значения меток прямо в диалоге.

- плагин · `type=plugin` · Claude Code · ★ 5
- Автор: lexfrei
- Лицензия: BSD-3-Clause · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/lexfrei/mcp-loki
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/plugins/loki

## Что делает

Плагин даёт Claude Code доступ к логам Grafana Loki через протокол MCP. Ассистент выполняет запросы LogQL и получает потоки логов за выбранные интервалы времени. Поддерживаются относительные интервалы вроде `1h` или `30m`, формат `RFC3339` и ключевое слово `now`.

Внутри заложены готовые инструменты: `loki_query` для выборки записей, `loki_labels` для просмотра меток и `loki_series` для сопоставления селекторов. Есть отдельная проверка готовности через `loki_ready`. Для типовых задач предусмотрены шаблоны промптов, которые вычисляют частоту входящих строк или собирают ошибки по названию сервиса.

Без указания адреса плагин обращается к `http://localhost:3100`. Если сервер защищён авторизацией, понадобятся переменные окружения `LOKI_USERNAME` с `LOKI_PASSWORD` либо `LOKI_TOKEN`, а для мультитенантных систем — заголовок `LOKI_ORG_ID`.

## Установка

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

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
В чате агента (не в терминале):
```text
/plugin install loki@claude-community
```

## Когда брать
- найти ошибки сервиса через LogQL за последний час
- просмотреть список доступных меток и их значений в Loki
- посчитать частоту логов по селектору потока
- получить статистику индексов и объём записей

## Примеры запросов агенту
- Найди ошибки в логах приложения nginx за последние 2 часа через loki
- Покажи все значения метки app в Loki
- Посчитай частоту логов для селектора {app="backend"} с интервалом 5m

## Похожие
- [next-ai-drawio](https://affpapa.org/nevibecode/plugins/next-ai-drawio.md) — плагин · ★ 36427
- [terraform](https://affpapa.org/nevibecode/plugins/terraform.md) — плагин · ★ 44770
- [mcp-tunnels](https://affpapa.org/nevibecode/plugins/mcp-tunnels.md) — плагин · ★ 44770
- [gitlab](https://affpapa.org/nevibecode/plugins/gitlab.md) — плагин · ★ 44770
- [google-cloud-developer](https://affpapa.org/nevibecode/plugins/google-cloud-developer.md) — плагин · ★ 21606
- [desktop-commander](https://affpapa.org/nevibecode/plugins/desktop-commander.md) — плагин · ★ 10134

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

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