# MCP Docs

> Неофициальный перевод, разборы и авторские руководства официальной документации и спецификации Model Context Protocol (MCP) на русском языке. Основа: ревизия спецификации 2026-07-28, сверено 05.10.2026. Оригинал: https://modelcontextprotocol.io/specification/2026-07-28/index

Если перевод и оригинал расходятся, верен оригинал. Каждая страница доступна как Markdown по адресу страницы + index.md.

## Страницы

- [Model Context Protocol (MCP)](https://mcpdocs.ru/index.md): Неофициальный перевод официальной документации и спецификации Model Context Protocol (MCP) на русском языке: понятия, транспорты, шаблоны обмена, миграция на ревизию 2026-07-28.
- [Введение](https://mcpdocs.ru/intro/index.md): Что такое Model Context Protocol (MCP): участники, два слоя, три примитива сервера, отличие от A2A и состав проекта.
- [Понятия](https://mcpdocs.ru/concepts/index.md): Ключевые понятия MCP: хост, клиент, сервер, инструменты, ресурсы, шаблоны запросов, запрос данных у пользователя, расширения и обнаружение.
- [Обнаружение (server/discover)](https://mcpdocs.ru/concepts/discovery/index.md): Метод server/discover в MCP 2026-07-28: поля результата, когда его вызывать, обязательность для серверов, кэширование и проба совместимости на stdio.
- [Инструменты (tools)](https://mcpdocs.ru/concepts/tools/index.md): Примитив tools в MCP 2026-07-28: объявление возможности, tools/list и tools/call, поля Tool, имена, типы результатов, структурированный вывод, ошибки и безопасность.
- [Ресурсы (resources)](https://mcpdocs.ru/concepts/resources/index.md): Примитив resources в MCP: прямые и шаблонные ресурсы, методы resources/list, resources/templates/list и resources/read, подписки на изменения, автодополнение.
- [Шаблоны запросов (prompts)](https://mcpdocs.ru/concepts/prompts/index.md): Примитив prompts в MCP: параметризованные шаблоны, методы prompts/list и prompts/get, аргументы, автодополнение и типичные способы показа в интерфейсе.
- [Протокол](https://mcpdocs.ru/protocol/index.md): Базовый протокол MCP 2026-07-28: сообщения JSON-RPC 2.0, resultType, обязательные поля _meta в каждом запросе, отсутствие сессий, схема и JSON Schema.
- [Транспорты](https://mcpdocs.ru/protocol/transports/index.md): Транспорты MCP 2026-07-28: stdio и Streamable HTTP, обязательные заголовки MCP-Protocol-Version, Mcp-Method, Mcp-Name, Mcp-Param-*, потоки SSE, отмена, проверка заголовков и обратная совместимость.
- [Шаблоны обмена](https://mcpdocs.ru/protocol/patterns/index.md): Три шаблона обмена в MCP 2026-07-28: запрос и ответ, Multi Round-Trip Requests (InputRequiredResult, inputResponses, requestState), подписки через subscriptions/listen, а также отмена и прогресс.
- [Ошибки](https://mcpdocs.ru/protocol/errors/index.md): Ошибки MCP 2026-07-28: коды JSON-RPC, диапазон -32020…-32099 для спецификации, HeaderMismatch, MissingRequiredClientCapability, UnsupportedProtocolVersion, ошибки инструментов и устаревшие коды.
- [Версии и совместимость](https://mcpdocs.ru/protocol/versions/index.md): Версионирование MCP 2026-07-28: версия в каждом запросе, UnsupportedProtocolVersionError, обязательный server/discover, согласование расширений и матрица совместимости современных и прежних реализаций.
- [Миграция на 2026-07-28](https://mcpdocs.ru/migration/index.md): Изменения MCP 2026-07-28 относительно 2025-11-25: отказ от сессий и рукопожатия, server/discover, MRTR, subscriptions/listen, Tasks как расширение, заголовки и кэширование, новые коды ошибок, устаревшие возможности.
- [Справочник](https://mcpdocs.ru/reference/index.md): Справочные сведения о MCP: версии спецификации, официальные SDK на десяти языках, официальные расширения (Tasks, MCP Apps, авторизация, Skills), нормативные источники и реестр серверов.
- [Инструменты](https://mcpdocs.ru/tools/index.md): Как проверить сервер MCP на соответствие ревизии 2026-07-28: бесплатная проверка в справочнике mcpprotocol.ru (сервис AgentReadyScan), что она проверяет и где описаны эти требования, официальные MCP Inspector и руководство по отладке.
- [О проекте](https://mcpdocs.ru/about/index.md): Что такое MCP Docs: неофициальный перевод документации Model Context Protocol, как отмечены страницы, принципы перевода, лицензии источника, как сообщить об ошибке.

## Руководства (код проверен на Python SDK 2.3.0 и TypeScript SDK 2.3.1, 13.10.2026)

- [Руководства](https://mcpdocs.ru/guides/index.md): Практические руководства по MCP на русском: подключение серверов в Claude, Cursor, VS Code, OpenCode и Yandex Cloud, свой MCP-сервер на Python и TypeScript, MCP и 1С.
- [Как подключить MCP-сервер](https://mcpdocs.ru/podklyuchenie/index.md): Как подключить MCP-сервер к Claude, Cursor, VS Code и другим клиентам: локальный и удалённый сервер, форматы настроек, секреты, проверка через MCP Inspector и частые ошибки.
- [Подключение MCP-сервера в Claude Desktop](https://mcpdocs.ru/podklyuchenie/claude-desktop/index.md): Как подключить MCP-сервер в Claude Desktop: файл claude_desktop_config.json на macOS и Windows, локальные серверы, удалённые через «Коннекторы», мост mcp-remote, команда mcp install для Python.
- [Подключение MCP-сервера в Claude Code](https://mcpdocs.ru/podklyuchenie/claude-code/index.md): Как подключить MCP-сервер в Claude Code: команды claude mcp add и add-json, локальные и удалённые серверы, области local, project и user, файл .mcp.json, проверка через /mcp.
- [Подключение MCP-сервера в Cursor](https://mcpdocs.ru/podklyuchenie/cursor/index.md): Как подключить MCP-сервер в Cursor: глобальный ~/.cursor/mcp.json и файл проекта .cursor/mcp.json, локальные и удалённые серверы, токены в заголовках, проверка в настройках.
- [Подключение MCP-сервера в VS Code](https://mcpdocs.ru/podklyuchenie/vs-code/index.md): Как подключить MCP-сервер в VS Code для GitHub Copilot: файл .vscode/mcp.json, ключ servers, типы stdio и http, запрос секретов через inputs, команда code --add-mcp.
- [Подключение MCP-сервера в OpenCode](https://mcpdocs.ru/podklyuchenie/opencode/index.md): Как подключить MCP-сервер в OpenCode: раздел mcp в opencode.json, тип local с командой-массивом, тип remote с адресом и заголовками, подстановка {env:…}, пример ВкусВилл MCP.
- [MCP-серверы Яндекса: подключение Yandex Cloud MCP](https://mcpdocs.ru/podklyuchenie/yandex/index.md): Как подключить MCP-серверы Yandex Cloud: поиск Яндекса, документация, Toolkit, функции и контейнеры. Локальный режим через npx @yandex-cloud/mcp с входом в браузере и удалённый с IAM-токеном.
- [Как написать свой MCP-сервер на Python](https://mcpdocs.ru/svoy-server/index.md): Пошаговое руководство: свой MCP-сервер на Python SDK 2.x по ревизии 2026-07-28. Инструменты, ресурсы, шаблоны запросов, проверка через Client и MCP Inspector, запуск по stdio и Streamable HTTP, подключение к Claude и Cursor.
- [Свой MCP-сервер на TypeScript](https://mcpdocs.ru/svoy-server/typescript/index.md): Свой MCP-сервер на TypeScript SDK v2 (@modelcontextprotocol/server): registerTool, registerResource, registerPrompt, схемы Zod, запуск по stdio и HTTP с проверкой Host и Origin, клиент для проверки.
- [Авторизация MCP-сервера: OAuth 2.1](https://mcpdocs.ru/svoy-server/avtorizatsiya/index.md): Авторизация удалённого MCP-сервера по OAuth 2.1 на Python SDK: проверка токена через интроспекцию RFC 7662, метаданные защищённого ресурса RFC 9728, ответ 401, права инструментов, привязка токена к серверу.
- [Память и состояние в MCP-сервере](https://mcpdocs.ru/svoy-server/pamyat/index.md): Как хранить состояние в MCP-сервере по ревизии 2026-07-28 без сессий: явные идентификаторы, проверка владельца, lifespan, свой сервер памяти (mcp memory) на SQLite с разделением по пользователям, масштабирование.
- [MCP и 1С](https://mcpdocs.ru/1c/index.md): MCP для 1С: что можно сделать и с чего начать. MCP-сервер для 1С:EDT, справка платформы, метаданные конфигурации и свой MCP-сервер для базы 1С через OData. Для программистов 1С.
- [Что даёт MCP программисту 1С](https://mcpdocs.ru/1c/chto-dayot/index.md): Что даёт MCP программисту 1С: метаданные конфигурации в контексте модели, точный код BSL, проверка запросов, разбор ошибок EDT. Ограничения: логика, типовые конфигурации, данные и персональные данные.
- [MCP в 1С:EDT: EDT MCP Server](https://mcpdocs.ru/1c/edt/index.md): EDT MCP Server для 1C:EDT: установка с сайта обновлений, порт 8765, подключение Cursor, Claude Code, Claude Desktop и VS Code, 97 инструментов, подтверждение опасных операций, лицензия AGPL-3.0.
- [Как написать MCP-сервер для базы 1С](https://mcpdocs.ru/1c/napisat-server/index.md): Как написать MCP-сервер для базы 1С: публикация стандартного интерфейса OData, пользователь с правом чтения, сервер на Python SDK с поиском по справочникам, безопасность данных. Альтернатива — расширение с HTTP-сервисом.
- [MCP для 1С: примеры и разборы](https://mcpdocs.ru/1c/primery/index.md): Открытые MCP-серверы для 1С с разбором: EDT MCP Server, mcp-1c, расширение 1c_mcp для MCP-сервера внутри базы, справка платформы mcp-bsl-platform-context, каталог Awesome 1C MCP Servers.

## Оригинальные источники

- [Спецификация MCP 2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28/index): нормативный текст на английском
- [Key Changes 2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28/changelog): изменения относительно 2025-11-25
- [Указатель документации для агентов](https://modelcontextprotocol.io/llms.txt)
- [Схема на TypeScript](https://github.com/modelcontextprotocol/specification/blob/main/schema/2026-07-28/schema.ts): источник истины о сообщениях

## Связанные ресурсы

- [mcpprotocol.ru](https://mcpprotocol.ru/): справочник по MCP и каталог MCP-серверов (https://mcpprotocol.ru/katalog/)
- [a2aprotocol.ru](https://a2aprotocol.ru/): справочник по протоколу A2A
- [a2adocs.ru](https://a2adocs.ru/): документация A2A на русском
- [a2acommerce.ru](https://a2acommerce.ru/): словарь агентной коммерции
- [agentreadyscan.ru](https://agentreadyscan.ru/): сканер готовности сайтов к ИИ-агентам

Поддерживает: AI-D2C (https://aid2c.ru/). На страницах сайта ничего не продаётся и нет рекламы.

## Всё на этом сайте одним файлом

- [llms-full.txt](https://mcpdocs.ru/llms-full.txt)