Быстрый старт с Tracer MCP

Tracer MCP — это реализация Model Context Protocol, которая позволяет AI-ассистентам работать с данными Tracer. Доступен удалённый сервер — локальная установка не требуется.

Адрес сервера

https://mcp.apptracer.ru

Транспорт

Сервер работает по Streamable HTTP. Устаревший HTTP+SSE не поддерживается.

Авторизация

Все запросы требуют заголовок:

Authorization: Bearer <ваш личный токен AppTracer>

Получить токен можно в интерфейсе Tracer: Настройки → Токены.

Что умеет сервер

Удалённый MCP сейчас поддерживает работу с крэшами: просмотр списков крашевых групп, вариантов стектрейсов, деталей событий, трендов и crash-free rate.

Пример конфигурации

Если ваш MCP-клиент поддерживает Streamable HTTP напрямую, добавьте в mcp.json:

{
  "mcpServers": {
    "apptracer": {
      "type": "http",
      "url": "https://mcp.apptracer.ru",
      "headers": {
        "Authorization": "Bearer <ваш личный токен AppTracer>"
      }
    }
  }
}

Поле "type": "http" обязательно: без него часть клиентов трактует запись как stdio-сервер и пропускает её.

Если клиент не поддерживает Streamable HTTP

Используйте прокси mcp-remote:

{
  "command": [
    "npx",
    "-y",
    "mcp-remote",
    "https://mcp.apptracer.ru",
    "--header",
    "Authorization: Bearer <ваш личный токен AppTracer>"
  ]
}

Инструменты

Сервер предоставляет инструменты для навигации по организациям/приложениям и для работы со сбоями:

Инструмент	Назначение
`apptracer_list_orgs`	Список организаций. Точка входа: сначала получите `org_id`.
`apptracer_get_org`	Информация об организации по `org_id`.
`apptracer_list_apps`	Список приложений в организации.
`apptracer_get_app`	Информация о приложении по `app_id`.
`apptracer_get_crash_list`	Список групп сбоев в приложении с фильтрацией по TQL.
`apptracer_get_crash_tql_configuration`	Доступные термы и операторы TQL для фильтрации сбоев.
`apptracer_get_crash_tql_options`	Доступные значения для терма TQL.
`apptracer_get_crash_variants`	Варианты стектрейсов внутри одной крашевой группы.
`apptracer_get_crash_details`	Детали событий краша: стектрейс, логи, thread dumps, custom data, комментарии.
`apptracer_get_crash_trends`	Временной ряд количества крашей.
`apptracer_get_crash_free_rate`	Crash-free rate устройств во времени.

Полное описание каждого инструмента и его параметров агент получает от самого MCP-сервера.

Типовой сценарий

Получить список организаций: apptracer_list_orgs.
Найти приложение: apptracer_list_apps --org-id 123.
Посмотреть список крашей: apptracer_get_crash_list --app-id 456.
Получить детали группы: apptracer_get_crash_details --app-id 456 --crash-id <id>.
Построить тренд: apptracer_get_crash_trends --app-id 456 --crash-id <id>.