MetricFire MCP Server

официальный

Отслеживайте свою инфраструктуру с помощью естественного языка, используя новый сервер MetricFire Model Context Protocol (MCP). Подключите MetricFire MCP Server к ИИ-ассистентам, таким как GitHub Copilot, и с помощью простых запросов ищите метрики, визуализируйте данные, создавайте оповещения и управляйте средой мониторинга без написания API-вызовов.

Что можно делать с MetricFire MCP?

  • Метрики поиска — Попросите ассистента найти метрики по шаблону или тегам, включая занятые или недействительные метрики.
  • Данные Graphite для рендеринга — Запросите данные метрик в формате JSON, CSV, raw, PNG или SVG за указанный период времени.
  • Управление оповещениями — Создавайте, обновляйте, ищите, отключайте или удаляйте оповещения, включая составные оповещения с логикой AND/OR.
  • Создание дашбордов Grafana — Попросите ассистента создать или обновить дашборды и панели на основе запросов на естественном языке.
  • Обработка каналов уведомлений — Получайте, создавайте, обновляйте или удаляйте каналы, такие как Email, Slack, PagerDuty и вебхуки.
  • Планирование отключений — Настройте повторяющиеся окна отключения (например, выходные) и свяжите их с оповещениями.

Документация

Полный указатель документации см. в llms.txt. Markdown-версии страниц документации доступны при добавлении .md к URL страниц; эта страница доступна как Markdown.

MF MCP Server

Подключайте AI-ассистентов для взаимодействия с API Hosted Graphite с помощью запросов на естественном языке.

Содержание

{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}

MetricFire MCP Server позволяет поддерживаемым AI-клиентам напрямую взаимодействовать с вашей учетной записью Hosted Graphite с помощью Model Context Protocol (MCP).

После подключения такие клиенты, как GitHub Copilot, Cursor, Claude/Claude Code и другие, могут использовать API Hosted Graphite для поиска метрик, рендеринга Graphite, управления оповещениями, каналами уведомлений, запланированными отключениями звука и другими рабочими процессами мониторинга.

MCP-сервер работает с данными и ресурсами в вашей учетной записи Hosted Graphite. Метрики должны быть предварительно отправлены и сохранены в Hosted Graphite, прежде чем их можно будет искать, отображать или использовать для оповещений.

Создание MCP-токена

В вашей учетной записи Hosted Graphite перейдите в раздел Add-Ons ⇒ MetricFire MCP Server

Создайте токен и выберите разрешения, необходимые вашему MCP-клиенту:

  • Read — доступ к метрикам, рендерам, оповещениям, каналам уведомлений, запланированным отключениям звука и другим поддерживаемым ресурсам.
  • Write — создание или изменение поддерживаемых ресурсов.
  • Delete — удаление поддерживаемых ресурсов.

Мы рекомендуем использовать минимальные разрешения, необходимые для вашего рабочего процесса.


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

Подключение MCP-клиента

Конечная точка MCP Hosted Graphite:

https://mcp.hostedgraphite.com/

Конфигурация немного различается в зависимости от MCP-клиента.

GitHub Copilot (VS Code)

Откройте палитру команд VS Code и выберите: MCP: Open User Configuration

Добавьте объект MetricFire MCP Server:

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

Сохраните конфигурацию, запустите MCP-сервер из VS Code и взаимодействуйте с агентом через Copilot Chat.

Cursor, Claude Code, Cline, Windsurf

Эти клиенты поддерживают пользовательские HTTP-заголовки. Настройте конечную точку:

https://mcp.hostedgraphite.com/

и передайте ваш токен:

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

Обратитесь к документации MCP вашего клиента для получения информации о расположении и формате конфигурации сервера.

Claude

Конфигурация браузера/интерфейса Claude может подключаться с использованием MCP-токена в URL сервера:

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

ПРИМЕЧАНИЕ: При использовании аутентификации на основе URL мы настоятельно рекомендуем токен только для чтения, если доступ на запись или удаление не требуется специально.

Доступные инструменты

После подключения ваш MCP-клиент может обнаружить инструменты, которые в настоящее время предоставляет Hosted Graphite.

Метрики

Доступны инструменты для:

  • Стандартного поиска метрик (по шаблону*)
  • Поиска тегированных метрик
  • Активных метрик
  • Недействительных метрик
  • Удаления метрик

Graphite Render

API Graphite Render можно запрашивать через MCP с поддержкой:

  • JSON
  • CSV
  • Необработанных данных
  • PNG
  • SVG

Это позволяет MCP-клиентам находить метрики и получать или визуализировать их данные за указанный период времени.

Оповещения

AI-ассистенты могут работать с вашими метриками Hosted Graphite для создания значимых составных оповещений с использованием логики И/ИЛИ, что упрощает оповещение о проблемах на уровне сервиса, а не о порогах отдельных метрик.

Например: «Найди соответствующие метрики CPU, памяти, диска и сети для моих production-серверов и создай составное оповещение, которое отправит мне email, когда несколько сигналов укажут на проблему на уровне сервиса».

Инструменты оповещений поддерживают:

  • Создание и обновление оповещений
  • Поиск и получение оповещений
  • Удаление оповещений
  • Отключение и включение звука оповещений
  • Статус и историю оповещений
  • Критерии составных оповещений с использованием логики И/ИЛИ

Дашборды

AI-клиенты могут ссылаться на метрики, хранящиеся в вашей учетной записи Hosted Graphite, и использовать их для создания, обновления и управления дашбордами Grafana с помощью запросов на естественном языке. Вместо ручного поиска метрик, создания панелей и настройки визуализаций по одной за раз, вы можете попросить вашего AI-ассистента создать дашборд вокруг сервиса, хоста, приложения или компонента инфраструктуры, который вы хотите мониторить.

Например: «Найди соответствующие метрики CPU, памяти, диска и сети для моих production-серверов и создай комплексный дашборд обзора инфраструктуры».

Инструменты дашбордов поддерживают:

  • Создание дашбордов Grafana
  • Обновление существующих дашбордов
  • Поиск и получение дашбордов
  • Удаление дашбордов
  • Создание и настройку панелей дашбордов
  • Использование метрик Hosted Graphite для создания дашбордов на основе запросов на естественном языке

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

Каналы уведомлений

MCP-клиенты могут работать с каналами уведомлений Hosted Graphite (Email, Slack, PagerDuty, MS Teams, вебхуки и т. д.), включая получение каналов и их привязку к оповещениям. В зависимости от разрешений токена поддерживаемые каналы также можно создавать, обновлять или удалять.

Запланированные отключения звука

Инструменты запланированных отключений звука позволяют MCP-клиентам создавать и управлять повторяющимися окнами отключения (например, выходные). Запланированные отключения звука — это отдельные ресурсы, которые можно связывать с оповещениями через Alert API.

Как это работает

MetricFire MCP Server предоставляет MCP-интерфейс для поддерживаемых API Hosted Graphite. Подключенный AI-клиент выбирает подходящий MCP-инструмент на основе запроса и выполняет его с использованием разрешений, связанных с вашим MCP-токеном.

Интеграция MCP не заменяет существующий сбор метрик. Продолжайте отправлять данные в Hosted Graphite с помощью существующих агентов, интеграций или поддерживаемых протоколов.

Для получения дополнительных сведений о базовых API см. документацию по API Hosted Graphite, а если вам нужна помощь с подключением MCP-клиента, свяжитесь с нами по адресу: support@metricfire.com

MCP в настоящее время недоступен для пользователей, которые включили аддон Hosted Graphite из Heroku Marketplace. Свяжитесь с нами, чтобы узнать, как перенести ваши учетные записи Heroku HG на выделенную учетную запись HG и воспользоваться всеми доступными функциями, такими как MCP и Logging.


Инструкции для агента

Эта документация опубликована с помощью GitBook. GitBook — это платформа документации, разработанная так, чтобы и люди, и AI-агенты могли эффективно читать, перемещаться и анализировать технический контент. Узнайте больше на gitbook.com.

Запросы к этой документации

Если вам нужна дополнительная информация, которая напрямую не доступна на этой странице, вы можете запросить документацию, задав вопрос.

Выполните HTTP GET-запрос на следующий URL с параметрами запроса ask и goal:

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask — это непосредственный вопрос: он должен быть конкретным, самодостаточным и написанным на естественном языке. goal — это то, чего пользователь в конечном итоге пытается достичь, причина, по которой ему нужен ответ. Предоставление этой информации помогает GitBook дать вам лучший и более релевантный ответ. Цель наиболее полезна, когда она описывает результат, который хочет получить пользователь, а не перефразирует вопрос. Например, с ask=how do I create an API token, такая цель, как automate deployments from our CI pipeline, позволяет GitBook адаптировать ответ под этот вариант использования.

Ответ будет содержать прямой ответ на вопрос, а также соответствующие отрывки и источники из документации.

Используйте этот механизм, когда ответ явно не присутствует на текущей странице, вам нужно уточнение или дополнительный контекст, или вы хотите получить связанные разделы документации.