← Настройка агентов / agent-setup / visual-studio-code
Подробное руководство по Visual Studio Code
В этом руководстве Visual Studio Code напрямую подключается к Cloudflare API с помощью MCP-сервер Cloudflare ↗. В итоге вы сможете создать запись DNS, просто напечатав предложение, не выходя из редактора.
Сервер Cloudflare MCP по адресу mcp.cloudflare.com открывает доступ к Cloudflare API любому агенту с поддержкой MCP. Агент Copilot в Visual Studio Code подключается к нему, и вы выполняете вызовы API на естественном языке.
Сокращённую версию см. в Быстрый старт с Visual Studio Code.
Прежде чем начать
- Visual Studio Code, полностью обновлённый. Несовпадение версий редактора и расширения Copilot является самой частой причиной ошибок в режиме агента.
- GitHub Copilot. Подойдёт любой аккаунт GitHub, бесплатного тарифа достаточно.
- Аккаунт Cloudflare, который вам не жаль доверить агенту. Используйте демонстрационный аккаунт, причина станет понятна на этапе авторизации.
Подключите Visual Studio Code к API Cloudflare
-
Проверьте версию Visual Studio Code
Откройте Visual Studio Code и выберите Справка > Обзор. Убедитесь, что у вас актуальная сборка. Если Обновление кнопка появится в строке заголовка, нажмите её и дайте Visual Studio Code перезапуститься, прежде чем продолжить.
-
Войдите в Copilot
Выберите значок Copilot в строке состояния, затем Включите функции ИИ, затем войдите с учётной записью GitHub. Visual Studio Code откроет браузер для авторизации.
-
Аутентификация в Copilot
Следуйте инструкциям в браузере, чтобы авторизоваться в GitHub.
-
Создайте папку и откройте её
Создайте пустую папку для этого проекта, затем откройте её в Visual Studio Code с помощью Файл > Open Folder. Например,
~/cloudflare-api-mcp/.
-
Создайте файл конфигурации
Внутри папки создайте один файл:
.vscode/mcp.json. Типизация.vscode/mcp.jsonв Explorer создаёт папку и файл одновременно.
Вставьте следующее в файл и сохраните его:
{ "servers": { "cloudflare-api": { "type": "http", "url": "https://mcp.cloudflare.com/mcp" } } } -
Запустите сервер
После того как вы сохраните файл, Запустить ссылка появляется на
cloudflare-apiопределении сервера. Выглядит как комментарий, но на самом деле это кнопка (это CodeLens ↗). Выберите её, а затем разрешите запрос на аутентификацию. В браузере откроется страница авторизации Cloudflare.
-
Выбор шаблона доступа
На странице авторизации вы решаете, к чему получит доступ агент. В этом примере выбрано Полный доступ для изменения записей DNS. Вы также можете начать с Только чтение либо создайте Custom набор разрешений. Ограничьте выдачу одним аккаунтом, а затем проверьте, что именно вы предоставляете.
Прежде чем авторизоваться, учтите два момента. Полный доступ позволяет агенту создавать и удалять реальные ресурсы, поэтому его стоит выдавать только на демо-аккаунте. Отозвать разрешение можно в любой момент в панели управления, в разделе My Profile > Access Management > Connected Applications, это же страница, куда нужно зайти, если повторная авторизация ведёт себя не так, как ожидалось.
-
Проверьте права доступа и авторизуйтесь
Просмотрите список разрешений, затем выберите Авторизовать чтобы Cloudflare API мог взаимодействовать с вашим аккаунтом.
-
Откройте Copilot Chat
Если Copilot свёрнут, откройте его с помощью Просмотр > Чат.
-
Убедитесь, что сервер запущен
Теперь сервер отображается как запущенный. CodeLens показывает Running | 3 tools. Три инструмента здесь норма, а не признак неполадки: сервер использует схему поиска и выполнения вместо регистрации тысяч отдельных конечных точек.
-
Список ваших зон
В Copilot Chat установите режим Agent, а затем попросите его вывести список ваших зон. Перед выполнением вызова агент запросит ваше подтверждение и вернёт актуальный список всех доменов в аккаунте.
List zones in my accountRan Cloudflare API Code Executor - Zones returned: 1 - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active -
Создайте DNS-запись
Попросите агента создать DNS-запись AAAA и включить прокси Cloudflare. В этом примере запись указывает на
test.cloudflaredemo.netпо адресу100::, зарезервированный служебный адрес из диапазона IPv6 discard prefix0100::/64(RFC 6666 ↗). Поскольку запись проксируется, Cloudflare перехватывает запросы прежде чем они достигнут этого адреса. Подтвердите вызов инструмента (Always Allow), и агент сообщит о создании записи.
Create a AAAA record for test.cloudflaredemo.net pointing to 100:: and enable the proxy.Ran Cloudflare API Code Executor - Record created: test.cloudflaredemo.net - Type: AAAA - Value: 100:: - Proxied: true - Record ID: <RECORD_ID>Не полагайтесь только на отчёт агента. Откройте панель управления и проверьте зону.
-
Проверьте распространение DNS
Попросите MCP-сервер Cloudflare проверить, что запись распространилась.
Verify DNS propagation for test.cloudflaredemo.netRan: dig @1.1.1.1 test.cloudflaredemo.net AAAA +short - Result: DNS resolves to Cloudflare IPv6 addresses (proxy active). - Resolvers returning AAAA: 1.1.1.1, 8.8.8.8, 9.9.9.9 - 2606:4700::6812:2f3 - 2606:4700::6812:3f3 -
Удалите DNS-запись
Вы можете удалить запись так же просто, как и создали её.
Delete test.cloudflaredemo.netRan Cloudflare API Code Executor Deleted the DNS record for test.cloudflaredemo.net.
Теперь у вас есть ИИ-агент с доступом на чтение и запись к сервисам Cloudflare в аккаунте, полностью управляемый из Visual Studio Code.
Дополнительные материалы
- Быстрый старт с Visual Studio Code то есть краткая инструкция по настройке, советы, частые вопросы и решение проблем.
- MCP-сервер Cloudflare ↗ то есть MCP серверы для конкретных продуктов.
- Cloudflare API то есть полный справочник REST API.