Настройка MCP-сервера: разрешения, проверка инструментов и безопасное удаление
Table of Contents
Вернуться к курсу «Практический рабочий процесс с ИИ»
Используйте MCP-сервер, когда задаче нужен повторно используемый инструмент или актуальная информация за пределами проекта. Model Context Protocol, или MCP, описывает обмен сведениями об инструментах, ресурсах и промптах между клиентом и сервером. Запись сервера сама по себе не доказывает, что инструмент работает. В этом уроке проверяется подключение к документации только для чтения.
Результат обучения: вы отличите настройку от реального чтения через MCP и зафиксируете безопасное удаление.
Главное
- Хост MCP: приложение ИИ, координирующее пользователей, модели, разрешения и клиенты.
- Клиент MCP: компонент протокола, который связывается с сервером.
- Сервер MCP: программа или удаленная служба, предоставляющая инструменты, ресурсы или промпты.
- Обнаружение инструмента: подтверждение, что в клиенте появился именованный инструмент.
- Выполнение инструмента: подтверждение реального вызова и полученного содержимого.
- Область разрешений: доступ, который предоставляют хост, сервер, учетная запись и пользователь.
Перед началом
Требования: практика работы с контекстом и передачей задач и актуальная установка Codex CLI для пошагового примера. Выделите 35 минут. Уровень сложности: средний. Для других кодовых агентов есть отдельные инструкции. Официальный сервер OpenAI Docs MCP предоставляет документацию разработчика только для чтения и не требует загружать данные курса.
Используйте синтетическую лабораторную среду курса. Не подключайте календарь, почту или рабочую систему. Для изучения состояний соединения достаточно прочитать документацию.
Поймите границы
| Состояние | Что оно подтверждает | Чего оно не подтверждает |
|---|---|---|
| Настроен | Запись сервера существует | Доступность сервера |
| Подключен | Клиент связался с сервером | Наличие полезных инструментов |
| Обнаружен | Показан именованный инструмент | Успех его вызова |
| Выполнен | Вызов вернул содержимое | Правильность итоговой задачи |
| Проверен | Источник и результат отвечают на вопрос | Надежность будущих вызовов |
Сам MCP не предоставляет разрешения учетной записи. Важны хост клиента, сервер, аутентификация, область доступа учетной записи и локальные настройки подтверждения. Спецификация MCP определяет протокол, а пользовательский интерфейс зависит от продукта.
Считайте ответ сервера исходным материалом. Полученная страница не отменяет задачу и не разрешает записывать файлы. Описания инструментов также расходуют контекст, поэтому подключайте сервер только для нужного чтения и удаляйте его после упражнения.
Подключите сервер только для чтения
В Codex CLI выполните команды в терминале. Первая добавляет общедоступный сервер документации, вторая показывает настроенные серверы.
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list
Ожидаемое подтверждение настройки: в списке есть openaiDeveloperDocs. Это доказывает только регистрацию. Запустите новый сеанс Codex в распакованной папке лаборатории и просмотрите инструменты MCP командой /mcp. Используйте имена, показанные установленной версией.
Запросите реальное чтение:
Используй сервер MCP документации разработчика OpenAI, чтобы найти актуальные указания AGENTS.md.
Верни заголовок и URL страницы-источника, два пункта для лаборатории и название использованного инструмента MCP.
Не изменяй файлы.
Проверьте ответ. Страница должна описывать AGENTS.md как инструкции репозитория и содержать точный URL источника. Откройте указанную страницу и проверьте ее тему. Ответ без вызова MCP в журнале диалога является обычным ответом, а не доказательством выполнения инструмента.
Диагностируйте сбой
Если codex mcp list показывает сервер, а /mcp не показывает инструментов, регистрация прошла, но обнаружение не удалось. Перезапустите сеанс, проверьте активные серверы через /mcp, сохраненную конфигурацию через codex mcp get openaiDeveloperDocs, URL сервера и сетевой доступ. Не считайте одну запись подтверждением успешной настройки MCP.
Если инструмент появился, но чтение завершилось ошибкой, запишите ошибку и повторите попытку один раз после проверки соединения. При повторном сбое откройте указанную официальную страницу в браузере и отметьте упражнение MCP как незавершенное. Не выдумывайте результат вызова.
Удалите подключение
После чтения удалите тестовый сервер из Codex CLI и убедитесь, что запись исчезла.
codex mcp remove openaiDeveloperDocs
codex mcp list
Ожидаемое подтверждение удаления: в новом списке нет openaiDeveloperDocs. Перед проверкой доступных инструментов перезапустите активный сеанс Codex. Удаление локальной записи не отзывает отдельное разрешение учетной записи, используемое другой службой.
Используйте другой клиент
Claude Code и OpenCode также поддерживают MCP. Следуйте руководству MCP для Claude Code или руководству OpenCode для установленного выпуска. Фиксируйте те же пять состояний: настроен, подключен, обнаружен, выполнен, проверен. Схема конфигурации и разрешения агентов OpenCode различаются по версиям. Берите примеры из руководства для своей установки.
Для варианта только с браузером прочитайте официальную страницу AGENTS.md и заполните ту же форму проверки. Для обнаружения и выполнения инструмента укажите «не выполнялось». Этот вариант учит проверять источники, но не подтверждает работу MCP.
Практика и проверка
Ваш результат: запись из пяти пунктов с именем сервера и инструмента, URL источника, наблюдаемым ответом и подтверждением удаления. Не включайте токены и идентификаторы учетных записей в снимки экрана и журналы.
Критерий выполнения: подключенный вариант пройден после реального чтения инструментом и последующего удаления настройки. Запасной вариант проходит проверку источника, если MCP помечен как невыполненный.
Проверьте понимание
- Вопрос: доказывает ли сохраненная запись MCP, что инструмент работал? Ответ: нет. Проверьте обнаружение, разрешения и один реальный запрос чтения.
- Вопрос: какие дополнительные затраты контекста дает широкое подключение MCP? Ответ: описания и схемы инструментов занимают часть активного контекста.
Устранение неполадок
- Команда
codexне найдена: установите или обновите Codex CLI по связанной официальной инструкции. - Сервер есть в списке, инструмента нет: проверьте состояние сеанса и диагностику сервера.
- Вызов вернул нерелевантные данные: уточните запрос и проверьте страницу-источник.
- Удаление не помогло: запустите новый сеанс и проверьте список активных серверов.
Дальнейшие шаги
Продолжите уроком Проверка результатов ИИ . Дополнительные расширения описаны в руководстве по плагинам Claude Code и инструментам MCP .
Навигация по курсу: Предыдущий урок: Управление контекстом , План курса .