🇬🇧 English version
🎓 Полевое руководство · обновлено 29.10.2026

Ваш MCP-сервер не спрятан.
Он в чьей-то очереди.

Всё ниже — из двух источников: что на самом деле отвечают реестры и что писали публично сами мейнтейнеры, пока ждали. Без «10x установок» и без обещаний листинга, которого никто в GitHub не обещал.

01 🎯 Ворота, которые не баг

Реестров два, и ведут они себя по-разному. Публикация в открытом — самообслуживание. Попадание в реестр GitHub (тот, что кормит галерею MCP в VS Code) — ручной шаг курации, который делает GitHub.

Наблюдаемое поведение двух реестров
Открытый реестрРеестр GitHub
Адресregistry.modelcontextprotocol.iogithub.com/mcp · api.mcp.github.com
ПубликацияАвтоматическая, сразуРучная курация
Версии после первого принятия—Синхронизируются сами
Опубликованные критерииВалидность схемыНе опубликованы
Опубликованный срокСразуНет
реестр GitHub теперь умеет синхронизировать версии из открытого реестра, но добавление нового сервера по-прежнему остаётся ручной курацией.
347комментариев в одном треде онбординга#1257, 29.10.2026
327участников в этой очереди#1257, 29.10.2026
~8 месот заявки до листинга у первого попавшего#1257: 19.10.2025 → 30.06.2026
0результатов по нашему серверу на стороне GitHubapi.mcp.github.com, 29.10.2026
🧊

Холодная правда. Невидимость в галерее — состояние по умолчанию, а не дефект кода. Это не значит «плохо написан» или «отклонили». Это значит, что человек ещё не посмотрел.

02 🧱 Заявка, которая переживёт куратора

Ускорить очередь нельзя. Можно убрать все причины пропустить вас, когда очередь дойдёт. Это реальные блокеры из заявок, опубликованных 28–29.10.2026.

⚠️

Не переотправляйте заявку. В том треде один мейнтейнер «поднимал» её восемь месяцев. Листинг появился после того, как заявку взял человек, а не после напоминания. Напоминания добавляют шум в очередь, которую читают люди.

03 🧰 Инструменты, которые агент сможет выбрать

Описание инструмента — это не документация для людей. Это вся поверхность решения для модели, которой нужно выбрать один ваш инструмент или ни одного.

🎯

Одна задача на инструмент

Если в названии нужно «и» — это два инструмента. Агент угадает не ту половину, и обязательно в дорогой части.

🏷️

Глагол + предметная область

tvijo_review лучше process. Имя — первый токен, который видит модель, и часто единственный, по которому она ранжирует.

🔒

Строгие схемы

Отклоняйте неизвестные поля, а не игнорируйте. Молча проигнорированное поле — это неверное действие, которого пользователь не увидит.

📦

Ограниченный вывод

Ограничивайте байты, строки и свежесть. Неограниченный ответ — бомба для контекста, а виноват будет ваш сервер.

🙈

Неизвестно — это не ноль

Если сумма неизвестна, верните null. Ноль превращает неизвестный счёт в фальшивую квитанцию.

🧯

Ошибка — это контент

У каждой ошибки стабильный код и фраза «что делать дальше». «Что-то пошло не так» запускает невидимый цикл повторов.

04 💸 Деньги в цикле агента

Как только инструмент умеет тратить, интерфейс меняется. Агент с платным инструментом и без лимита — это баг-репорт, к которому потом приложат счёт.

{ "prompt": "Explain how to make this function easier to test.",
  "max_usd": 0.25 }

05 🎨 UX документации для инструментов разработчика

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

🪜

1 · Постепенное раскрытие

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

📋

2 · Сначала копипаста

Рабочий блок конфигурации — раньше объяснения конфигурации. Если конфиг надо собирать из трёх разделов, три из них будут неверными.

❓

3 · Тест трёх вопросов

Сможет ли посторонний ответить: что это делает, сколько стоит, что сломается? Нет ответа хотя бы на один — страница не готова, как бы красиво ни выглядела.

🔎

4 · Видимое состояние

Показывайте состояние, а не описывайте: версию, вход, остаток лимита. Кто видит состояние — не гадает и не пишет в поддержку.

🧭

5 · Один путь и названные выходы

Один рекомендованный маршрут. Альтернативные клиенты и ручная настройка — это выходы с маршрута, а не параллельные туннели в начале.

🧾

Бонус · Квитанции вместо прилагательных

«Быстро» — прилагательное. «0.2.0 опубликована, реестр active, галерея count: 0, замер 29.10.2026» — квитанция. Квитанции переживают ревью.

06 📣 Цитирование, а не ранжирование

Поиск ранжирует страницы. Ассистент цитирует предложения. Единица работы — утверждение с источником и датой, а не ключевое слово.

🪞

Правило второго прохода. Если вердикт слишком точно совпадает с формулировкой вопроса — проверьте другим инструментом. Три модели, согласные в одном неверном прочтении, согласны уверенно.

07 📈 Единственный цикл, который стоит крутить

08 ⚠️ Когда это НЕ работает

🚫

Когда галерея нужна завтра

Не получится. Это ручные ворота без сроков. Если запуск зависит от листинга — он уже не запланирован. Ручная установка и есть основной путь.

🧲

Когда продукт — это листинг

Если видимость и есть вся ценность, у сервера нет своей работы. Это заметит и куратор, и первый установивший.

🕳️

Когда нечего показать кроме «работает»

Нет версии, эндпоинта, датированной проверки — нет и утверждения. Страница из этого не будет цитироваться.

🔁

Когда цикл — на самом деле баг-репорт

Если люди отваливаются на установке, AEO не поможет. Сначала установка: страница только усиливает то, что уже есть.

Нужен аудит вашего сервера?

Бесплатно, детерминированно, PASS / FAIL / NOT_RUN по каждому пункту с командой, которая это дала. Листинг не обещаем — он не в нашей власти.

Оставить заявку на аудит Доказательства по реестрам