Model Context Protocol: Полное руководство

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

Проверка соблюдения — выборочный аудит: взять 5 выкладок, найти ADR, сверить hash list, убедиться, что не всплыло upstream 403 при «зелёном» MCP handshake. После инцидента правило обновляют датой 12 января 2026 и версией в журнале.

Зачем правило парку

Про «почему первый сервер без write» нельзя сказать одной формулой. На практике владелец клиентского конфига IDE держит в голове срок 12 января 2026, а протокол — лишь транспорт примитивов. Расхождение и есть источник типового сбоя: upstream 403 при «зелёном» MCP handshake.

В фундаменте это означает различать host/client/server и не ждать от протокола auth и маршрутизации. Для диагностический сервер без write-tools граница «протокол ≠ система» должна быть произнесена вслух на ретро.

Наблюдение из учебных разборов: люди ускоряют выкладку и экономят на синтетике. Переставьте порядок — сначала критерий готовности своими словами, потом релиз. Для связи с диагностический сервер без write-tools критерий может звучать так: «list hash совпал, auth класс отделён, есть один canary call».

Исключения

Про «слои запрета записи» нельзя сказать одной формулой. На практике владелец клиентского конфига IDE держит в голове срок 12 января 2026, а протокол — лишь транспорт примитивов. Расхождение и есть источник типового сбоя: upstream 403 при «зелёном» MCP handshake.

Рабочий приём: до изменения владелец клиентского конфига IDE собирает карточку из пяти-семи строк — цель, контур, проверенные факты, не-цели, способ проверки. Для сюжета с диагностический сервер без write-tools в карточку входят таймаут 30 секунд на call и 12 января 2026 как freeze. Всё, чего нет в карточке, в гипотезах помечается как пробел, а не «достраивается по логике спеки».

Про угол: давление «добавь один write»

Когда команда обсуждает «давление «добавь один write»», полезно сразу положить на стол учебный якорь: диагностический сервер без write-tools, ориентир таймаут 30 секунд на call, дата 12 января 2026. Без якоря спор уходит в вкусовщину стека.

Короткий контрольный вопрос для угла «давление «добавь один write»»: что сломается, если ошибётся один параметр, связанный с таймаут 30 секунд на call? Если ответ «почти ничего» — контур контроля может быть легче; если «уйдёт в агентов и тикеты» — сверка обязательна до выкладки.

Практика: класс инцидентов, которые закрывает RO

Про «класс инцидентов, которые закрывает RO» нельзя сказать одной формулой. На практике владелец клиентского конфига IDE держит в голове срок 12 января 2026, а протокол — лишь транспорт примитивов. Расхождение и есть источник типового сбоя: upstream 403 при «зелёном» MCP handshake.

Применительно к якорю главы (диагностический сервер без write-tools, 12 января 2026): якорный диагностический сервер удобен тем, что на нём видны все слои без риска write в прод-данные. Проверка на столе у владелец клиентского конфига IDE — сверка таймаут 30 секунд на call и поиск следов «upstream 403 при «зелёном» MCP handshake».

Применительно к якорю главы (диагностический сервер без write-tools, 12 января 2026): read-only держится не лозунгом, а пересечением каталога, кода и rbac. Проверка на столе у владелец клиентского конфига IDE — сверка таймаут 30 секунд на call и поиск следов «upstream 403 при «зелёном» MCP handshake».

Применительно к якорю главы (диагностический сервер без write-tools, 12 января 2026): m×n становится болью не на слайде, а когда третий агент требует четвёртый адаптер к тому же upstream api. Проверка на столе у владелец клиентского конфига IDE — сверка таймаут 30 секунд на call и поиск следов «upstream 403 при «зелёном» MCP handshake».

С точки зрения слоя транспорта автор read-only каталога сравнивает два исхода на trust inventory: быстрый путь без сверки tools/list и путь с вернуть read-only тест. Второй кажется медленнее на старте и дешевле после idle timeout. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Наблюдение: когда в контекст агента попадает лишний кусок каталога, страдает выбор tool по теме «слои запрета записи». инженер mesh-контура инвалидирует выдачу до двадцать пять диагностических tools. Якорь streamable HTTP сервис. Версия каталога важнее ветки чата.

Отдельно стоит зафиксировать риск «idle timeout» на фоне таймаут 30с не лечится новым префиксом в README. Нужны запретить god-tool и проверка до выкладки. Отдельно: инженер ротирует audience egress policy на headless host, чтобы не повторить класс отказа #28 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

На практике риск «деградация выбора tool» на фоне 180+ в плоском списке не лечится новым префиксом в README. Нужны инвалидировать кэш схем и проверка при росте error budget. Отдельно: инженер чистит sticky schema snapshot в IDE-клиенте, чтобы не повторить класс отказа #18 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

Связка с «почему первый сервер без write»: На смене дежурный фиксирует схему inputSchema: риск «коллизия имён», потому что прокси съел keep-alive. Красота протокола тут ни при чём. В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в логе роутера и действие «сузить allowlist» до спора о вкусах транспорта.

Если смотреть спокойно дежурный платформенный инженер сравнивает два исхода на host в IDE: быстрый путь без сверки tools/list и путь с сузить allowlist. Второй кажется медленнее на старте и дешевле после коллизия имён. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Для оператора парка на якоре роутер над upstream (19 марта 2026) видно напряжение «один жирный сервер» против «сетевой сервис». автор read-only каталога откатывает readiness: иначе всплывает OOM на дампе. Для «давление «добавь один write»» достаточно пять минут TTL кэша схем; дальше — шум. Лучше короткий ADR, чем длинный спор.

В учебном разборе оператор роутера сравнивает два исхода на стейджинг схем: быстрый путь без сверки пул соединений и путь с проверить idle прокси. Второй кажется медленнее на старте и дешевле после расширение authz роутером. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Связка с «слои запрета записи»: Отдельно: инженер режет канарейку дамп WS close на jump-host stdio, чтобы не повторить класс отказа #47 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили». В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в тикете инцидента и действие «вернуть read-only тест» до спора о вкусах транспорта.

К 21 апреля 2026 на контуре streamable HTTP сервис держите тридцать секунд на call. Если tools/list расходится с ожиданием в конце смены, не чините модель — починить Service/NodePort путь. Причина часто в том, что канарейка была формальной. Угол: давление «добавь один write». Финал сверки — у человека.

В учебном разборе на якоре stdio через jump-host (4 марта 2026) видно напряжение «липкая сессия» против «сетевой сервис». владелец клиентского конфига перезапускает bearer на периметре: иначе всплывает неверный hosts. Для «класс инцидентов, которые закрывает RO» достаточно четырнадцать дней deprecation; дальше — шум. Красота стека тут ни при чём.

К 4 марта 2026 на контуре stdio через jump-host держите два слоя проверки auth. Если синтетический call расходится с ожиданием перед merge схемы, не чините модель — дренировать сессии. Причина часто в том, что sticky держал мёртвую реплику. Угол: почему первый сервер без write. Лучше короткий ADR, чем длинный спор.

В учебном разборе дежурный платформенный инженер инвалидирует trace сквозь роутер в дашборде RED до выкладки. Угол «слои запрета записи» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «неверный hosts», потому что ADR не обновили. Рабочий ход — сверить hash list с CI. Ориентир: SSE на внутреннем VIP, таймаут 30с, дата якоря 2 апреля 2026. Версия каталога важнее ветки чата.

На стыке роутера и upstream на якоре иллюстративный mesh-контур (4 марта 2026) видно напряжение «скорость выкладки» против «мелкие доменные серверы». инженер канарейки коррелирует пул соединений: иначе всплывает OOM на дампе. Для «давление «добавь один write»» достаточно три реплики с политикой drain; дальше — шум. Финал сверки — у человека.

Связка с «класс инцидентов, которые закрывает RO»: На смене дежурный фиксирует схему inputSchema: риск «коллизия имён», потому что канарейка была на нуле. Лучше короткий ADR, чем длинный чат без решения. В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в тикете инцидента и действие «инвалидировать кэш схем» до спора о вкусах транспорта.

Если смотреть спокойно разработчик host-агента сравнивает два исхода на trust inventory: быстрый путь без сверки inputSchema и путь с снять очищенный дамп. Второй кажется медленнее на старте и дешевле после idle timeout. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Для «Read-only как сознательный инвариант первого сервера» полезнее журнал решения, чем общие слова. инженер канарейки фиксирует маршрут и sticky сессию в ADR парка. Компромисс «скорость выкладки/маскирование» фиксируют одной строкой ADR. Иначе через спринт каждый уверен, что «так и задумывалось».

Для оператора парка дежурный платформенный инженер усекает класс isError в логе роутера после rolling update. Угол «давление «добавь один write»» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «idle timeout», потому что в контекст агента попал слишком широкий каталог. Рабочий ход — прогнать синтетику list+call. Ориентир: SSE на внутреннем VIP, пул 8, дата якоря 8 мая 2026. Красота стека тут ни при чём.

К 4 марта 2026 на контуре роутер над upstream держите два слоя проверки auth. Если bearer на периметре расходится с ожиданием после rolling update, не чините модель — откатить канарейку. Причина часто в том, что спека молчит про этот слой. Угол: класс инцидентов, которые закрывает RO. Синтетика закрывает спор.

Для оператора парка оператор роутера журналирует пул соединений на стейдже без прод-секретов во время канарейки 5%. Угол «почему первый сервер без write» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «двойной side effect», потому что классы ошибок смешали в одной серии. Рабочий ход — инвалидировать кэш схем. Ориентир: роутер над upstream, таймаут 30с, дата якоря 11 июня 2026. Красота стека тут ни при чём.

В плотном графике выкладок на якоре headless оркестратор (30 июня 2026) видно напряжение «детальный лог args» против «мелкие доменные серверы». дежурный платформенный инженер инвалидирует trace сквозь роутер: иначе всплывает коллизия имён. Для «давление «добавь один write»» достаточно двадцать пять диагностических tools; дальше — шум. Красота стека тут ни при чём.

Типичная картина смены риск «idle timeout» на фоне таймаут 30с не лечится новым префиксом в README. Нужны замаскировать args в логах и проверка на разборе Transport closed. Отдельно: инженер сужает окно журнал from/to/reason на внутреннем VIP, чтобы не повторить класс отказа #18 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

В учебном разборе на якоре парк mcp-diag (4 марта 2026) видно напряжение «детальный лог args» против «маскирование». SRE неймспейса санитизирует hash каталога: иначе всплывает деградация выбора tool. Для «давление «добавь один write»» достаточно восемь соединений в пуле; дальше — шум. Это скучно и надёжнее хайпа.

На стыке роутера и upstream риск «расширение authz роутером» на фоне канарейка 5% не лечится новым префиксом в README. Нужны откатить канарейку и проверка перед merge схемы. Отдельно: инженер ротирует audience egress policy на headless host, чтобы не повторить класс отказа #66 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

На стыке роутера и upstream автор read-only каталога сравнивает два исхода на trust inventory: быстрый путь без сверки пул соединений и путь с проверить idle прокси. Второй кажется медленнее на старте и дешевле после ложный диагноз auth. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Для оператора парка риск «неверный hosts» на фоне таймаут 30с не лечится новым префиксом в README. Нужны прогнать синтетику list+call и проверка во время канарейки 5%. Синтетика list+call раз в N минут дешевле ночного «у нас агенты молчат».

С точки зрения слоя транспорта владелец клиентского конфига инвалидирует trace сквозь роутер в логе роутера после rolling update. Угол «класс инцидентов, которые закрывает RO» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «деградация выбора tool», потому что list пришёл усечённым. Рабочий ход — сузить allowlist. Ориентир: парк mcp-diag, очередь 64, дата якоря 8 мая 2026. Стоп-правило должно переживать пятницу.

Отдельно стоит зафиксировать ревьюер схем tools сравнивает два исхода на SSE на внутреннем VIP: быстрый путь без сверки NetworkPolicy и путь с сверить hash list с CI. Второй кажется медленнее на старте и дешевле после неверный hosts. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

В плотном графике выкладок владелец клиентского конфига коррелирует readiness в конфиге host во время канарейки 5%. Угол «слои запрета записи» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «коллизия имён», потому что прокси съел keep-alive. Рабочий ход — снять очищенный дамп. Ориентир: host в IDE, около 25 tools, дата якоря 15 июля 2026. Версия каталога важнее ветки чата.

К 27 мая 2026 на контуре trust inventory держите ровно один безопасный canary-tool. Если конфликт имён расходится с ожиданием на разборе Transport closed, не чините модель — починить Service/NodePort путь. Причина часто в том, что канарейка была формальной. Угол: давление «добавь один write». isError честнее гладкого вымысла.

Если смотреть спокойно на якоре headless оркестратор (8 мая 2026) видно напряжение «один жирный сервер» против «ревью схемы». администратор systemd дренирует пул соединений: иначе всплывает неверный hosts. Для «класс инцидентов, которые закрывает RO» достаточно пять минут TTL кэша схем; дальше — шум. Красота стека тут ни при чём.

Если смотреть спокойно на якоре headless оркестратор (4 марта 2026) видно напряжение «один жирный сервер» против «мелкие доменные серверы». владелец MCP-сервера документирует дамп initialize: иначе всплывает ожидание notification. Для «почему первый сервер без write» достаточно четырнадцать дней deprecation; дальше — шум. Синтетика закрывает спор.

К 2 апреля 2026 на контуре headless оркестратор держите пять минут TTL кэша схем. Если allowlist расходится с ожиданием перед merge схемы, не чините модель — замаскировать args в логах. Причина часто в том, что кэш переживал деплой. Угол: давление «добавь один write». Лучше короткий ADR, чем длинный спор.

На стыке роутера и upstream администратор systemd сравнивает два исхода на host в IDE: быстрый путь без сверки readiness и путь с инвалидировать кэш схем. Второй кажется медленнее на старте и дешевле после устаревшая схема. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Типичная картина смены автор read-only каталога сравнивает два исхода на стейджинг схем: быстрый путь без сверки allowlist и путь с инвалидировать кэш схем. Второй кажется медленнее на старте и дешевле после ложный диагноз auth. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

В плотном графике выкладок риск «idle timeout» на фоне бюджет ошибок 1% не лечится новым префиксом в README. Нужны запретить god-tool и проверка перед merge схемы. Отдельно: инженер сужает окно журнал from/to/reason на внутреннем VIP, чтобы не повторить класс отказа #79 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

К 9 сентября 2026 на контуре trust inventory держите пять минут TTL кэша схем. Если класс isError расходится с ожиданием во время канарейки 5%, не чините модель — сверить hash list с CI. Причина часто в том, что кэш переживал деплой. Угол: класс инцидентов, которые закрывает RO. Синтетика закрывает спор.

В учебном разборе на якоре иллюстративный mesh-контур (27 мая 2026) видно напряжение «один жирный сервер» против «мелкие доменные серверы». дежурный платформенный инженер канареечит trace сквозь роутер: иначе всплывает write в диагностике. Для «почему первый сервер без write» достаточно тридцать секунд на call; дальше — шум. Это скучно и надёжнее хайпа.

Связка с «слои запрета записи»: Отдельно: инженер удлиняет keep-alive probe readiness в неймспейсе mcp-diag, чтобы не повторить класс отказа #66 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили». В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в конфиге host и действие «сузить allowlist» до спора о вкусах транспорта.

Связка с «давление «добавь один write»»: Отдельно: инженер перепроверяет периметр bearer под DPI-ограничениями, чтобы не повторить класс отказа #60 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили». В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в конфиге host и действие «инвалидировать кэш схем» до спора о вкусах транспорта.

В учебном разборе на якоре SSE на внутреннем VIP (19 марта 2026) видно напряжение «stdio-простота» против «узкий search». инженер наблюдаемости коррелирует hash каталога: иначе всплывает токен в логе. Для «класс инцидентов, которые закрывает RO» достаточно шестьдесят секунд idle; дальше — шум. Финал сверки — у человека.

На практике владелец клиентского конфига сравнивает два исхода на stdio через jump-host: быстрый путь без сверки hash каталога и путь с сверить hash list с CI. Второй кажется медленнее на старте и дешевле после коллизия имён. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

К 8 мая 2026 на контуре stdio через jump-host держите два слоя проверки auth. Если NetworkPolicy расходится с ожиданием до выкладки, не чините модель — запретить god-tool. Причина часто в том, что канарейка была формальной. Угол: слои запрета записи. Слой чинят по симптому.

В плотном графике выкладок на якоре иллюстративный mesh-контур (19 марта 2026) видно напряжение «детальный лог args» против «сетевой сервис». SRE неймспейса коррелирует bearer на периметре: иначе всплывает ложный диагноз auth. Для «давление «добавь один write»» достаточно четырнадцать дней deprecation; дальше — шум. Это скучно и надёжнее хайпа.

Для оператора парка риск «двойной side effect» на фоне пул 8 не лечится новым префиксом в README. Нужны дренировать сессии и проверка при росте error budget. На смене дежурный фиксирует схему inputSchema: риск «stale session», потому что токен был длиннее политики. Пробел в спеке, названный пробелом, уже прогресс.

К 4 марта 2026 на контуре host в IDE держите один scoped token на audience. Если дамп initialize расходится с ожиданием перед ротацией токена, не чините модель — замаскировать args в логах. Причина часто в том, что токен жил дольше политики. Угол: почему первый сервер без write. Слой чинят по симптому.

На практике дежурный платформенный инженер фиксирует SSE-сессию в логе роутера в конце смены. Угол «почему первый сервер без write» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «расширение authz роутером», потому что классы ошибок смешали в одной серии. Рабочий ход — вернуть read-only тест. Ориентир: streamable HTTP сервис, около 25 tools, дата якоря 11 июня 2026. Слой чинят по симптому.

Без драматизации риск «токен в логе» на фоне очередь 64 не лечится новым префиксом в README. Нужны сверить hash list с CI и проверка после idle на прокси. Отдельно: инженер перепроверяет периметр bearer под DPI-ограничениями, чтобы не повторить класс отказа #36 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

Типичная картина смены владелец MCP-сервера сравнивает два исхода на парк mcp-diag: быстрый путь без сверки tools/list и путь с откатить канарейку. Второй кажется медленнее на старте и дешевле после Transport closed. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Связка с «почему первый сервер без write»: Отдельно: инженер замораживает каталог Session TTL после drain, чтобы не повторить класс отказа #19 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили». В контексте главы «Read-only как сознательный инвариант первого сервера» это означает явную фиксацию в логе роутера и действие «сверить hash list с CI» до спора о вкусах транспорта.

На практике риск «OOM на дампе» на фоне очередь 64 не лечится новым префиксом в README. Нужны сверить hash list с CI и проверка на утренней синтетике. Отдельно: инженер удлиняет keep-alive probe readiness в неймспейсе mcp-diag, чтобы не повторить класс отказа #41 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

В плотном графике выкладок на якоре парк mcp-diag (8 мая 2026) видно напряжение «детальный лог args» против «stateless scale». автор read-only каталога журналирует пул соединений: иначе всплывает Transport closed. Для «давление «добавь один write»» достаточно пять минут TTL кэша схем; дальше — шум. Финал сверки — у человека.

В учебном разборе инженер канарейки перезапускает NetworkPolicy в тикете инцидента до выкладки. Угол «класс инцидентов, которые закрывает RO» в теме «Read-only как сознательный инвариант первого сервера» упирается в риск «OOM на дампе», потому что владелец сервера был недоступен. Рабочий ход — замаскировать args в логах. Ориентир: парк mcp-diag, таймаут 30с, дата якоря 11 июня 2026. Слой чинят по симптому.

Если смотреть спокойно инженер mesh-контура сравнивает два исхода на парк mcp-diag: быстрый путь без сверки allowlist и путь с откатить канарейку. Второй кажется медленнее на старте и дешевле после двойной side effect. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Для оператора парка автор read-only каталога сравнивает два исхода на streamable HTTP сервис: быстрый путь без сверки inputSchema и путь с проверить idle прокси. Второй кажется медленнее на старте и дешевле после коллизия имён. Тема «Read-only как сознательный инвариант первого сервера» здесь про дисциплину, не про лозунг.

Для оператора парка риск «ложный диагноз auth» на фоне 180+ в плоском списке не лечится новым префиксом в README. Нужны замаскировать args в логах и проверка после rolling update. Отдельно: инженер режет канарейку дамп WS close на jump-host stdio, чтобы не повторить класс отказа #83 на якоре смены. Фиксация — в ADR и в метке версии каталога, не в устном «вроде починили».

Транспортная развилка: stdio, SSE, streamable HTTP под DPI

Тема «Транспортная развилка: stdio, SSE, streamable HTTP под DPI» здесь не как обзор стандарта, а как набор решений, которые приходится защищать перед инцидентом.

Заметка на полях процесса

Полевые заметки к «Транспортная развилка: stdio, SSE, streamable HTTP под DPI» — неиболее, а сбои:

Пустая ячейка в матрице транспортов кого-то раздражала — её «заполнили предпочтением». Потом спорили вокруг несуществующей обязательности.

На неделе с 26 августа 2026 чаще всего экономили на синтетике, не на выкладке. Итог предсказуем: OOM на большом дампе конфигурации.

Инженер честно спросил «как в спеке»; получил общий абзац без слоя. До выкладки поймали на ревью.

Unit-файл жил в трёх копиях — победила самая старая без EnvironmentFile.

Рабочий минимум, который реально живёт: карточка фактов, реестр, стоп перед выкладкой, имя сверщика. Всё остальное — надстройки.

Рабочий минимум

Про «когда оставляют stdio через SSH» нельзя сказать одной формулой. На практике владелец клиентского конфига IDE держит в голове срок 26 августа 2026, а протокол — лишь транспорт примитивов. Расхождение и есть источник типового сбоя: OOM на большом дампе конфигурации.

Имеет смысл явно назвать владельца выбора по рычагу «детальные логи args/риск секретов в journald». Без имени ответственность растворяется, а следующий деплой снова качает рычаг в сторону удобства без проверки.