Одна задача на инструмент
Если в названии нужно «и» — это два инструмента. Агент угадает не ту половину, и обязательно в дорогой части.
Всё ниже — из двух источников: что на самом деле отвечают реестры и что писали публично сами мейнтейнеры, пока ждали. Без «10x установок» и без обещаний листинга, которого никто в GitHub не обещал.
Реестров два, и ведут они себя по-разному. Публикация в открытом — самообслуживание. Попадание в реестр GitHub (тот, что кормит галерею MCP в VS Code) — ручной шаг курации, который делает GitHub.
| Открытый реестр | Реестр GitHub | |
|---|---|---|
| Адрес | registry.modelcontextprotocol.io | github.com/mcp · api.mcp.github.com |
| Публикация | Автоматическая, сразу | Ручная курация |
| Версии после первого принятия | — | Синхронизируются сами |
| Опубликованные критерии | Валидность схемы | Не опубликованы |
| Опубликованный срок | Сразу | Нет |
реестр GitHub теперь умеет синхронизировать версии из открытого реестра, но добавление нового сервера по-прежнему остаётся ручной курацией.
api.mcp.github.com, 29.10.2026Холодная правда. Невидимость в галерее — состояние по умолчанию, а не дефект кода. Это не значит «плохо написан» или «отклонили». Это значит, что человек ещё не посмотрел.
Ускорить очередь нельзя. Можно убрать все причины пропустить вас, когда очередь дойдёт. Это реальные блокеры из заявок, опубликованных 28–29.10.2026.
server.json проходит текущую схемуИ name совпадает с namespace, которым вы владеете: GitHub-организация или домен с DNS-подтверждением.repository или манифест вместо негоДва мейнтейнера сами написали в заявке, что поля нет. Куратору нечего проверять.isLatest: true и версия, совпадающая с пакетомУстаревшая версия в указателе latest читается как заброшенный проект.title, readOnlyHint, destructiveHint, openWorldHint. Без них клиент не спросит подтверждение перед записью.curl, вернувший 401 с WWW-Authenticate, сильнее скриншота.Не переотправляйте заявку. В том треде один мейнтейнер «поднимал» её восемь месяцев. Листинг появился после того, как заявку взял человек, а не после напоминания. Напоминания добавляют шум в очередь, которую читают люди.
Описание инструмента — это не документация для людей. Это вся поверхность решения для модели, которой нужно выбрать один ваш инструмент или ни одного.
Если в названии нужно «и» — это два инструмента. Агент угадает не ту половину, и обязательно в дорогой части.
tvijo_review лучше process. Имя — первый токен, который видит модель, и часто единственный, по которому она ранжирует.
Отклоняйте неизвестные поля, а не игнорируйте. Молча проигнорированное поле — это неверное действие, которого пользователь не увидит.
Ограничивайте байты, строки и свежесть. Неограниченный ответ — бомба для контекста, а виноват будет ваш сервер.
Если сумма неизвестна, верните null. Ноль превращает неизвестный счёт в фальшивую квитанцию.
У каждой ошибки стабильный код и фраза «что делать дальше». «Что-то пошло не так» запускает невидимый цикл повторов.
Как только инструмент умеет тратить, интерфейс меняется. Агент с платным инструментом и без лимита — это баг-репорт, к которому потом приложат счёт.
spent_usd: null. Это честно и это не ноль.{ "prompt": "Explain how to make this function easier to test.",
"max_usd": 0.25 }
Документация — это интерфейс. Эти пять правил поймали у нас больше реальных проблем, чем любой редизайн.
Первый экран отвечает: «я смогу этим воспользоваться за пять минут?». Схемы, крайние случаи и коды ошибок — уровнем ниже, по ссылке. Страница, которая начинается с архитектуры, теряет всех, кто ещё решал.
Рабочий блок конфигурации — раньше объяснения конфигурации. Если конфиг надо собирать из трёх разделов, три из них будут неверными.
Сможет ли посторонний ответить: что это делает, сколько стоит, что сломается? Нет ответа хотя бы на один — страница не готова, как бы красиво ни выглядела.
Показывайте состояние, а не описывайте: версию, вход, остаток лимита. Кто видит состояние — не гадает и не пишет в поддержку.
Один рекомендованный маршрут. Альтернативные клиенты и ручная настройка — это выходы с маршрута, а не параллельные туннели в начале.
«Быстро» — прилагательное. «0.2.0 опубликована, реестр active, галерея count: 0, замер 29.10.2026» — квитанция. Квитанции переживают ревью.
Поиск ранжирует страницы. Ассистент цитирует предложения. Единица работы — утверждение с источником и датой, а не ключевое слово.
H1, H2 в форме вопросов, таблицы для сравнений, FAQ с настоящими вопросами, JSON-LD, llms.txt.Правило второго прохода. Если вердикт слишком точно совпадает с формулировкой вопроса — проверьте другим инструментом. Три модели, согласные в одном неверном прочтении, согласны уверенно.
Не получится. Это ручные ворота без сроков. Если запуск зависит от листинга — он уже не запланирован. Ручная установка и есть основной путь.
Если видимость и есть вся ценность, у сервера нет своей работы. Это заметит и куратор, и первый установивший.
Нет версии, эндпоинта, датированной проверки — нет и утверждения. Страница из этого не будет цитироваться.
Если люди отваливаются на установке, AEO не поможет. Сначала установка: страница только усиливает то, что уже есть.
Бесплатно, детерминированно, PASS / FAIL / NOT_RUN по каждому пункту с командой, которая это дала. Листинг не обещаем — он не в нашей власти.
Оставить заявку на аудит Доказательства по реестрам