@m00nsolutions/mcp-server

Agentic test management over MCP. Этот сервер позволяет ИИ-ассистенту делать работу, а не читать о ней: создавать тест-кейсы, планировать и заполнять ручные выполнения тестов, связывать автоматизацию с тест-кейсами, которые она покрывает, выпускать релизы и оценивать состояние проекта в M00N Report — AI-ативной платформе управления тестированием.

Какой вариант установки вам нужен?

Если вы подключаетесь не из claude.ai или claude.com, используйте этот пакет с MCP-ключом. Об этом и весь дальнейший текст README. Для коннектора см. руководство по коннектору.

Related MCP server: @testneo/mcp-server

Требования

Node 20 или новее, а также любой MCP-совместимый клиент.

Установка

Никакой установки не требуется. Клиент запускает сервер с помощью npx, как показано ниже в настройке.

Чтобы зафиксировать версию в общей среде или в CI, укажите версию в имени пакета в args, например ["-y", "@m00nsolutions/mcp-server@<version>"]. npm view @m00nsolutions/mcp-server versions показывает опубликованные версии. Плейс-холдер здесь выбран намеренно, а не конкретное число: конкретный пример устаревает при следующем релизе, а устаревший пример рекомендует зафиксировать версию, в которой уже нет актуальных исправлений.

Быстрый старт

1. Получите MCP-ключ

В M00N Report откройте Settings -> MCP Keys и создайте ключ. Он начинается с m00n_mcp_ и затем содержит 48 шестнадцатеричных символов. Это не учётные атрибуты, которыми пользуются тест-ригич. Их ключи начинаются с m00n_ и здесь отклоняются.

MCP-ключ несёт ровно те права, которые есть у принадлежащего ему аккаунта, и не больше, но его можно ограничить ещё сильнее. Ограничение убирает инструменты из списка, который видит клиент, поэтому более короткий список инструментов, чем вы ожидали, — это результат ограничения, а не ошибка.

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

2. Подключите клиент

Claude Code — одна строка:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

У любого другого клиента тот же JSON-блок:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

Куда поместить этот блок:

Для саморазмещённого экземпляра укажите M00N_API_URL с вашим собственным корневым адресом (root origin), без суффикса /api. Замыкающий слэш срезается автоматически.

3. Подтвердите подключение

Перезапустите клиент и спросите его:

Перечисли все проекты M00N Report

Появление списка ваших проектов означает, что сервер подключён и ключ действителен. Ошибка или сообщение ассистента о том, что такого инструмента нет, значит, нет; см. Устранение неполадок.

Инструменты

Восемь направлений. Полный список с аргументами — в /documentation/mcp/tools, который поддерживается рядом с кодом. При запуске сервер получает собственный список инструментов из вашего вашего экземпляра, поэтому ваш клиент видит ровно то, что ваше окружение поддерживало на момент подключения клиента.

Выполнение — это ручной тестовый прогон: исполнители, окружение, даты и результаты по шагам, зафиксированные на с пейсцентре каждого кейса в момент его добавления.

Сколько инструментов видно вашему ключу, зависит от вашего окружения:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

На m00nreport.com 22 августа 2026 года при максимальных правах ключа это число составило 57.

Промпты

Направленные многошаговые сценарии, которые клиент может предложить по имени. Каждый принимает единственный необязательный параметр project — имя или UUID; если он опущен, сервер сам выбирает проект, когда в области есть только один проект.

Ресурсы

Представления только для чтения, которые можно получить без вызова инструмента: все проекты, сводка состояния проекта, отчёт о flaky-тестах, сейчас падающие эталашения, структура папок, отчёт о запуске, содержимое тест-кейса, сводка релизу.

Конфигурация

Оба булевых значения включаются тестью true, 1 или yes, в любом регистре. Любое другое значение, включая false и 0, оставляет их выключенными.

Задайте либо обе первые переменные, либо ни одной. Задание только одной считается ошибкой и отклоняется: наполовину сконфигурированный сервер, который будет запущен так ничего, диагностировать сложнее, чем сервер, который не запускается вообще.

Базовый URL здесь — M00N_API_URL; тесте-риорпеты называют этот же URL M00N_SERVER_URL. Все шесть пакетов читают M00N_API_KEY, но у них это проектный API-ключ, а не MCP-ключ, поэтому одна экспортированная переменная окружения не может обслуживать оба случая.

Запуск без ключа

В запуске без M00N_API_URL и M00N_API_KEY ser serves предварительный режим: он показывает инструменты, промпты и ресурсы из bundling snapshot и отклоняет каждый вызов с сообщанmsg о том, что нужно указать. Никакой отправки никуда не происходит, потому что отправлять некуда.

Это и позволяет инспектору, клиенту или каталогу показывать список возможностей до того, как кто-либо зарегистрируется. Это описание сервера, но не сам рабочий сервер, поэтому списки берутся из сна snapshot, а не из вашего экземпляра: ограниченный по правам ключ обычно видит меньше инструментов, чем показывает сна snapshot.

Разработчики обновляют сна snapshot с помощью npm run snapshot:refresh с ключом без прав.

Self-Hosted

Укажите M00O_API_URL на вашу собственную установку и выпусковую MCP-ключ из этой установки. Больше отличий нет, и это важно, если self-hosted вам нужен потому, что тестовые данные не могут покидать вашу сеть.

При самоподписанном сертификате добавьте "M00N_INSECURE_SSL": "true" в тот же env-блок. Полная инструкция: /documentation/mcp/self-hosted.

Что отправляется

По HTTPS на M00N_API_URL: выявленные инструменты, которые вызывает ваш ассистент, и их аргументы. Сервер — прокси для вашего делится нечего, и сам ничего не хранит.

Каждый вызов инструмента записывается в MCP-аудит-лог с UI в приложении, а для каждого ключа установлен лимит на запросы, ограничивающий слишком беспокойного агента. Ключ не записывается в лог и не выводится в stderr. При M00N_DEBUG аргументы каждого вызова инструмента печатаются в stderr, поэтому lime output и надо так же, как те данные.

Устранение неполадок

TODO: Need complete? Let's review original: ends at ## Troubleshooting with no body. In translation include header only.

Need ensure "Каждый вызов... лог... поверхность в приложении" etc.

Let's verify no missing lines.

Original section "Resources": "All crowd" etc. Our translation "Реда ити" should be "Ресурсы". We wrote "Реда ити"? Oops, a typo. Need "Ресурсы". We'll fix.

Also in the translated text, "testy ribute" etc. Need clean up.

Let's polish final translation.

Potential issue "The full list with arguments is at /documentation/mcp/tools, kept beside the code." We translated "поддерживается рядом с кодом." Good.

Need preserve languages: "Сонпонс..." We'll fix typos.

Let's produce final final in a clean manner. Use Russian quotation marks.

We need include all headings exactly? The heading "Running Without a Key" translated "Запуск без ключа". Good.

Need preserve link text: at /documentation/mcp/tools. Our translation does that.

Need ensure "GXP1" etc appear in output exactly. They did.

Need ensure "{{GXP1}}" not? No.

Now final answer.# @m00nsolutions/mcp-server

Агентное управление тестированием через MCP. Этот сервер позволяет ИИ-ассистенту делать работу, а не читать о ней: писать тест-кейсы, планировать и заполнять ручные тестовые выполнения, привязывать автоматизацию к кейсам, которые она покрывает, выкатывать релизы и читать состояние проектов в M00N Report — AI-нативной платформе управления тестированием.

Какой вариант установки вам нужен?

Если вы подключаетесь не из claude.ai или claude.com, используйте этот пакет с MCP-ключом. Об этом и весь остальной текст этого README. Для коннектора см. руководство по коннектору.

Требования

Node 20 или новее, и любой MCP-совместимый клиент.

Установка

Отдельная установка не требуется. Клиент запускает сервер командой npx, как показано ниже в настройке.

Чтобы зафиксировать версию в общей среде или CI, добавьте версию в имя начинается в args, например ["-y", "@m00nsolutions/mcp-server@<version>"]. Команда npm view @m00nsolutions/mcp-server versions показывает опубликованные версии. Здесь намеренно стоит плейс-холдер, а не число: конкретный пример устаревает при следующем релизе, а устаревший пример рекомендует зафиксировать версию, в которой уже нет актуальных исправлений.

Быстрый старт

1. Получите MCP-ключ

В M00N Report перейдите в Settings -> MCP Keys и создайте ключ. Он начинается с m00n_mcp_ и далее содержит 48 шестнадцатеричных символов. Это не те данные, которыми пользуются тестовые репортеры: их ключ начинается с m00n_ и здесь отклоняется.

MCP-ключ несёт ровно те том з иг, что есть у аккаунта, которому он принадлежит, и никогда не больше; при этом его можно ограничить ещё сильнее. Ограничение удаляет инструменты из списка, который видит клиент, поэтому более короткий список инструментов, чем вы ожидали, — это результат ограничения, а не ошибка.

Ключ входит в конфигурацию вашего MCP-клиента на вашей машине. Не помещайте его в файл рабочего пространства, который живёт в репозитории.

2. Подключите клиент

В Claude Code — одна строка:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

В остальных клиентах — один и тот же JSON-блок:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

Куда его помещать:

Для self-hosted-экземпляра укажите M00N_API_URL на ваш собственный корневой адрес, без суффикса /api. Ведущий слэш за сообщением будет срезается за вас.

3. Проверьте подключение

Перезапустите клиент и спросите его:

Мои проекты M00N REport

Список ваших проектов означает, что сервер подключён и ключ действителен. Ошибка или слова ассистента о том, что такого инструмента нет, означают обратное; см. Поиск ошибок.

Инструменты

Инструменты восьми направлений. Полный список с аргументами находится на странице /documentation/mcp/tools, поддерживаемой рядом с кодом. Сервер при старте загружает собственный список инструментов из вашего экземпляра, так что клиент видит то, что ваш экземпляр поддерживал на момент подключения клиента.

Выполнение — это ручной тестовый прогон: назначенные лица, окружение, даты и результаты по шагам, сохранённые на снимок каждого кейса в момент его добавления.

Сколько инструментов известно вашему ключу, зависит от экземпляра:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

Это значение было 57 на m00nreport.com с новоНек ограниченным ключом на 22 августа 2026 года.

Промпты

Управляемые многошаговые сценарии, которые клиент может предложить по имени. Каждый принимает единственный необязательный аргумент project — имя или UUID; если не задан, сервер сам выбирает проект, если в зоне только один.

Ресурсы

Доступные только для чтения представления, которые клиент может получить без вызова инструмента: все проекты, сводка состояния проектов, отчёт о нестабильных тестах, текущие радённые тесты, структура папок, отчёт о запуске, содержимое тест-кейса, сводка релиза.

Конфигурация

Два булевых параметра включаются при значении true, 1 или yes в любом регистре. Любое другое значение, включая false и 0, оставляет их включёнными.

Задайте обе первые переменные или ни одну. Задание только одной расценивается как ошибка и отклоняется: частично настроенный сервер, который всё равно запускается, диагностировать сложнее, чем сервер, который не запускается.

Базовый URL в этом контексте — M00N_API_URL; тестовые репортах называют тот же URL M00N_SERVER_URL. Все шесть пакетов читают M00N_API_KEY, но у репортеров это проектный API-ключ, а не MCP-ключ, поэтому одна экспортированная переменная оболочки не может обслуживать оба сценария.

Запуск без ключа

При запуске без M00N_API_URL и M00N_API_KEY сервер работает в режиме предварительного просмотра: он показывает свои инструменты, промпты и ресурсы из встроенной распределения и отклоняет каждый вызов сообщением о том, что нужно указать. Ничего никуда не отправляется, потому что отправлять некуда.

Это позволяет инспектору, клиенту или каталогу показать поверхность инструментов до того, как кто-то зарегестрировался. Это описание сервера, а не рабочий сервер, поэтому списки из снапшота, а не из вашего экземпляра: ограниченный ключ видит инструментов меньше, чем показывает снапшот.

Поддерживающие обновляют снапшот командой npm run snapshot:refresh с ключа без ограничений.

Self-Hosted

Укажите M00N_API_URL на свой собственный экземпляр и выпустите MCP-ключ в этом экземпляре. Всё остальное идентично — и это важно, если причина self-hosted в том, что тестовые данные не могут покинуть вашу сеть.

Для самоподписанного сертификатная добавьте "M00N_INSECURE_SSL": "true" в тот же блок env. Полные инструкции — в /documentation/mcp/self-hosted.

Что отправляется

По HTTPS на M00N_API_URL уходят вызова инструментов, которые делает ваш ассистент, и их аргументы. Сервер — просто прокси к вашему же экземпляру и сам ничего не хранит.

Каждый вызов инструмента записывается в MCP-лог аудита с интерфейсом в приложении, и лимит по ключу ограничивает необузданного агента. Ключ не попадает ни в лог, ни в stderr. При включённом M00N_DEBUG аргументы каждого вызова печатаются в stderr, поэтому к этому выводу стоит относиться так же, как к самим данным.

Устранение неполадок

Сервер пишет логи в stderr независимо от M00N_DEBUG, и большинство клиентов показывают их в своей MCP‑панели. Установите M00N_DEBUG в true, чтобы дополнительно логировать каждый запрос и его аргументы.

Известные ограничения

• Список инструментов считывается один раз, при запуске. Измените область действия ключа или обновите экземпляр — клиент сохранит старый список, пока вы не перезапустите клиент.

• GET /api/health должен быть доступен, если он настроен. Он проверяется в первую очередь, и при сбое сервер останавливается, поэтому прокси, перенаправляющий только /api/mcp/*, вообще не показывает инструменты, хотя каждый инструмент работал бы.

• Ключ с правами на ноль инструментов не запускается. Сервер завершает работу, а не подключается с пустым списком. Это поведение при настроенном ключе; при полном отсутствии учётных данных сервер запускается в режиме предпросмотра.

• Промпты и ресурсы необязательны. Если загрузка их списков завершается ошибкой, сервер всё равно запускается, причина выводится в stderr, и клиент не видит ни одного из них в течение всей сессии.

• Перенаправления отклоняются, а не отслеживаются. Ключ передаётся в кастомном заголовке; обработчики перенаправлений снимают только распознаваемые ими заголовки авторизации, поэтому переход по перенаправлению отдал бы ключ любому следующему хосту. Сообщение о перенаправлении содержит адрес, на который оно указывало.

• Используется только stdio. Для HTTP‑транспорта используйте hosted‑коннектор.

Поддержка

• Пакет на npm

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

• Сообщить о проблемах

• Сообщество в Discord

Лицензия

MIT License. См. LICENSE.