INTEGRITY Документация

Подробное руководство по 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 к API Cloudflare

  1. Проверьте версию Visual Studio Code

    Откройте Visual Studio Code и выберите Справка > Обзор. Убедитесь, что у вас актуальная сборка. Если Обновление кнопка появится в строке заголовка, нажмите её и дайте Visual Studio Code перезапуститься, прежде чем продолжить.

    Меню Help в Visual Studio Code с диалоговым окном About, используемым для проверки установленной версии
  2. Войдите в Copilot

    Выберите значок Copilot в строке состояния, затем Включите функции ИИ, затем войдите с учётной записью GitHub. Visual Studio Code откроет браузер для авторизации.

    Запрос Visual Studio Code на включение функций ИИ и вход через GitHub
  3. Аутентификация в Copilot

    Следуйте инструкциям в браузере, чтобы авторизоваться в GitHub.

    страница входа в GitHub для авторизации GitHub Copilot
  4. Создайте папку и откройте её

    Создайте пустую папку для этого проекта, затем откройте её в Visual Studio Code с помощью Файл > Open Folder. Например, ~/cloudflare-api-mcp/.

    Диалог Open Folder в Visual Studio Code с выбором пустой папки проекта
  5. Создайте файл конфигурации

    Внутри папки создайте один файл: .vscode/mcp.json. Типизация .vscode/mcp.json в Explorer создаёт папку и файл одновременно.

    Visual Studio Code Explorer создаёт файл конфигурации .vscode/mcp.json

    Вставьте следующее в файл и сохраните его:

    {
      "servers": {
        "cloudflare-api": {
          "type": "http",
          "url": "https://mcp.cloudflare.com/mcp"
        }
      }
    }
  6. Запустите сервер

    После того как вы сохраните файл, Запустить ссылка появляется на cloudflare-api определении сервера. Выглядит как комментарий, но на самом деле это кнопка (это CodeLens ↗). Выберите её, а затем разрешите запрос на аутентификацию. В браузере откроется страница авторизации Cloudflare.

    Visual Studio Code отображает CodeLens Start над определением сервера Cloudflare MCP в mcp.json
  7. Выбор шаблона доступа

    На странице авторизации вы решаете, к чему получит доступ агент. В этом примере выбрано Полный доступ для изменения записей DNS. Вы также можете начать с Только чтение либо создайте Custom набор разрешений. Ограничьте выдачу одним аккаунтом, а затем проверьте, что именно вы предоставляете.

    Страница авторизации MCP Cloudflare с шаблонами доступа и вариантами области действия аккаунта

    Прежде чем авторизоваться, учтите два момента. Полный доступ позволяет агенту создавать и удалять реальные ресурсы, поэтому его стоит выдавать только на демо-аккаунте. Отозвать разрешение можно в любой момент в панели управления, в разделе My Profile > Access Management > Connected Applications, это же страница, куда нужно зайти, если повторная авторизация ведёт себя не так, как ожидалось.

  8. Проверьте права доступа и авторизуйтесь

    Просмотрите список разрешений, затем выберите Авторизовать чтобы Cloudflare API мог взаимодействовать с вашим аккаунтом.

    Страница авторизации MCP Cloudflare со списком запрашиваемых групп разрешений перед авторизацией Запрос Visual Studio Code Copilot на разрешение сервера Cloudflare MCP в текущей сессии
  9. Откройте Copilot Chat

    Если Copilot свёрнут, откройте его с помощью Просмотр > Чат.

    Меню View в Visual Studio Code открывает панель Copilot Chat
  10. Убедитесь, что сервер запущен

    Теперь сервер отображается как запущенный. CodeLens показывает Running | 3 tools. Три инструмента здесь норма, а не признак неполадки: сервер использует схему поиска и выполнения вместо регистрации тысяч отдельных конечных точек.

    Visual Studio Code CodeLens показывает работающий сервер Cloudflare MCP с тремя инструментами
  11. Список ваших зон

    В Copilot Chat установите режим Agent, а затем попросите его вывести список ваших зон. Перед выполнением вызова агент запросит ваше подтверждение и вернёт актуальный список всех доменов в аккаунте.

    Copilot Chat возвращает список зон Cloudflare для аккаунта
    List zones in my account
    Ran Cloudflare API Code Executor
    
    - Zones returned: 1
    - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active
  12. Создайте DNS-запись

    Попросите агента создать DNS-запись AAAA и включить прокси Cloudflare. В этом примере запись указывает на test.cloudflaredemo.net по адресу 100::, зарезервированный служебный адрес из диапазона IPv6 discard prefix 0100::/64 (RFC 6666 ↗). Поскольку запись проксируется, Cloudflare перехватывает запросы прежде чем они достигнут этого адреса. Подтвердите вызов инструмента (Always Allow), и агент сообщит о создании записи.

    Copilot Chat создаёт прокси-запись AAAA DNS через MCP-сервер Cloudflare
    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 в панели управления Cloudflare, подтверждающая наличие новой записи AAAA
  13. Проверьте распространение DNS

    Попросите MCP-сервер Cloudflare проверить, что запись распространилась.

    Copilot Chat проверяет распространение DNS-записи через публичные DNS-резолверы
    Verify DNS propagation for test.cloudflaredemo.net
    Ran: 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
  14. Удалите DNS-запись

    Вы можете удалить запись так же просто, как и создали её.

    Copilot Chat удаляет тестовую DNS-запись через MCP-сервер Cloudflare
    Delete test.cloudflaredemo.net
    Ran Cloudflare API Code Executor
    
    Deleted the DNS record for test.cloudflaredemo.net.

Теперь у вас есть ИИ-агент с доступом на чтение и запись к сервисам Cloudflare в аккаунте, полностью управляемый из Visual Studio Code.