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 адаптировать ответ под этот вариант использования.
Ответ будет содержать прямой ответ на вопрос, а также соответствующие отрывки и источники из документации.
Используйте этот механизм, когда ответ явно не присутствует на текущей странице, вам нужно уточнение или дополнительный контекст, или вы хотите получить связанные разделы документации.