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

← Настройка агентов / agent-setup

Visual Studio Code + Cloudflare

Все агенты
Microsoft

Бесплатный редактор кода с открытым исходным кодом, со встроенной поддержкой клиента Model Context Protocol (MCP) и интеграцией с Copilot Chat. Разработан Microsoft.

IDEТерминалАвтономное приложениеРасширениеОткрытый исходный код
Cloudflare SkillsCloudflare Code Mode API MCPСпециализированные MCP-серверы CloudflareVisual Studio Code Docs

быстрый старт

  1. Установите Visual Studio Code и GitHub Copilot

    Установка Visual Studio Code ↗ и убедитесь, что он полностью обновлён. Затем установите расширение GitHub Copilot ↗ и войдите с учётной записью GitHub. Для этого достаточно бесплатного тарифа Copilot.

  2. Настройте MCP-сервер Cloudflare

    Создайте .vscode/mcp.json внутри папки вашего рабочего пространства:

    {
  "servers": {
    "cloudflare-api": {
      "type": "http",
      "url": "https://mcp.cloudflare.com/mcp"
    }
  }
}

    Visual Studio Code использует servers в качестве корневого ключа. В конфигурациях, скопированных из Cursor или Claude Desktop, используется mcpServers и здесь просто ничего не сделает. Про MCP серверы для конкретных продуктов см. mcp-server-cloudflare ↗. Сведения о полнофункциональном MCP-сервере Cloudflare API (Code Mode) см. в разделе cloudflare/mcp ↗.

  3. Запустите сервер и авторизуйтесь

    После сохранения mcp.json, Visual Studio Code покажет Запустить CodeLens на cloudflare-api определении сервера. Выберите её и пройдите процесс OAuth, чтобы авторизовать Cloudflare MCP сервер в своём аккаунте. Начните с демо-аккаунта, пока не будете уверены в объёме предоставляемых разрешений.

  4. Попробовать промпт

    Откройте Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I), переключитесь в режим агента и попробуйте промпт, например:

    Build an AI chat agent using the Cloudflare Agents SDK with persistent conversation history stored in D1.

Пошаговое руководство со скриншотами, включая страницу авторизации OAuth, проверку работы сервера и создание и удаление DNS-записей на естественном языке, см. в подробное руководство.

Доступ к платформе Cloudflare

Разверните любой раздел, чтобы узнать больше.

Cloudflare Skills

Постоянный контекст платформы, который объясняет агенту, как работает Cloudflare.

Skills: инструкции, которые агент загружает по требованию. См. cloudflare/skills пакет охватывает все уровни платформы, поэтому агент знает ваши соглашения и вам не нужно объяснять их заново.

  • agents-sdkСоздавайте ИИ-агентов на Cloudflare Workers с помощью Agents SDK. Загружайте этот навык при создании агентов с состоянием, устойчивых Workflows, приложений на WebSocket в реальном времени, отложенных задач, MCP-серверов, чат-приложений, голосовых агентов или автоматизации браузера. Охватывает класс Agent, управление состоянием, вызываемый RPC, Workflows, устойчивое выполнение, очереди, повторные попытки, observability и React hooks. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
  • cloudflareКомплексный навык по платформе Cloudflare, охватывающий Workers, Pages, хранилища (KV, D1, R2), ИИ (Workers AI, Vectorize, Agents SDK), функциональные флаги (Flagship), сети (Tunnel, Spectrum), безопасность (WAF, DDoS) и инфраструктуру как код (Terraform, Pulumi). Используйте для любых задач разработки на Cloudflare. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
  • cloudflare-email-serviceОтправка и получение транзакционных писем через Cloudflare Email Service (Email Sending + Email Routing). Используйте при реализации отправки почты (binding Workers или REST API), маршрутизации почты, обработки почты в Agents SDK либо интеграции почты в любое приложение: Workers, Node.js, Python, Go и т. д. Также используйте для вопросов доставляемости почты, SPF/DKIM/DMARC, настройки wrangler для почты, MCP инструментов для почты или когда агенту для написания кода нужно отправить письмо. Даже для простых запросов вроде «добавь почту в мой Worker» этот skill содержит важные детали настройки.
  • cloudflare-one"Помогает в работе с Cloudflare One Zero Trust и SASE в Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture и identity. Используйте при проектировании, настройке, устранении неполадок или проверке развёртываний Cloudflare One. Приоритет на актуальные данные: используйте текущую документацию Cloudflare и схемы API вместо встроенной документации по продуктам."
  • cloudflare-one-migrationsПланирует миграцию с Zscaler ZIA/ZPA, Palo Alto, устаревших VPN, SWG или SASE стеков на Cloudflare One. Используется для оценки миграции, сопоставления политик, планов развёртывания и анализа соответствия функциональности.
  • durable-objectsСоздание и проверка Cloudflare Durable Objects. Используйте при разработке систем с сохранением состояния (чаты, многопользовательские игры, системы бронирования), реализации RPC-методов, хранилища SQLite, будильников (alarms), WebSockets, а также при проверке кода DO на соответствие лучшим практикам. Охватывает интеграцию с Workers, конфигурацию wrangler и тестирование с помощью Vitest. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
  • sandbox-migrate-to-nextИспользуется при переносе приложения Cloudflare Sandbox со стабильной версии @cloudflare/sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0), а также когда пользователь просит выполнить миграцию или обновление до Sandbox 1.0 или @next. Не подходит для повседневной работы со стабильной версией (sandbox-stable) или новых приложений на @next (sandbox-next).
  • sandbox-nextИспользуется при создании или изменении приложений Cloudflare Sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0): выполнение кода, ИИ-раннеры, интерпретаторы, задачи в духе CI, терминалы, файлы, точки монтирования, туннели, preview URL, жизненный цикл или ошибки. Не подходит для стабильного пакета по умолчанию (используйте sandbox-stable) и для переноса со стабильной версии на @next (используйте sandbox-migrate-to-next).
  • sandbox-stableИспользуется при создании или изменении приложений Cloudflare Sandbox на текущем стабильном пакете @cloudflare/sandbox (тег npm по умолчанию): команды, сессии, файлы, порты, туннели, терминалы, bridge, продакшен или очистка устаревшего API при сохранении стабильной версии. Не подходит для @cloudflare/sandbox@next (используйте sandbox-next) и для переноса на версию 1.0 (используйте sandbox-migrate-to-next).
  • turnstile-spinНастраивает Cloudflare Turnstile в проекте от начала до конца. Сканирует кодовую базу, создаёт виджет через Cloudflare API, встраивает его там, где запросам пользователя нужна проверка на бота (отправка форм, действия в SPA, API endpoints, ссылки для скачивания, отправка комментариев или голосов и т. д.), подключает каноническую серверную проверку siteverify в существующем бэкенде клиента, выполняет валидацию и сохраняет skill. Загружайте, когда пользователь просит добавить Turnstile, настроить CAPTCHA, защитить форму или endpoint от ботов либо исправить интеграцию Turnstile. Отражает developers.cloudflare.com/turnstile/spin.
  • web-perfАнализирует производительность веб-страниц с помощью Chrome DevTools MCP. Измеряет Core Web Vitals (LCP, INP, CLS) и дополнительные метрики (FCP, TBT, Speed Index), выявляет ресурсы, блокирующие рендеринг, цепочки сетевых зависимостей, сдвиги макета, проблемы кеширования и пробелы в доступности. Используйте этот навык, когда нужно провести аудит, профилирование, отладку или оптимизацию скорости загрузки страницы, показателей Lighthouse или скорости сайта. Отдаёт приоритет данным из актуальной документации, а не знаниям, полученным при обучении модели.
  • workers-best-practicesПроверяет и пишет код Cloudflare Workers в соответствии с лучшими практиками для продакшена. Загружайте при написании новых Workers, проверке кода Worker, настройке wrangler.jsonc или поиске типичных антипаттернов Workers (streaming, floating promises, global state, secrets, bindings, observability). Отдаёт приоритет данным из документации Cloudflare, а не предобученным знаниям.
  • wranglerCLI для Cloudflare Workers: развёртывание, разработка и управление Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines и Secrets Store. Загружайте этот навык перед выполнением команд wrangler, чтобы обеспечить правильный синтаксис и соблюдение лучших практик. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
MCP-серверы

Прямой доступ к Cloudflare API, документации и инструментам наблюдаемости.

MCP серверы предоставляют типизированные инструменты для обращения к Cloudflare во время выполнения. Есть два варианта: Code Mode то есть единый сервер, который охватывает весь Cloudflare API (более 2 500 эндпоинтов примерно в 1000 токенов), либо набор узкоспециализированных серверов для конкретных продуктов, размещённых в cloudflare/mcp-server-cloudflare репозитории. Полный каталог также доступен в MCP серверы для Cloudflare документации.

  • Code mode APIcode modeШирокий доступ ко всему API Cloudflare через выполнение кода с минимальным расходом токеновhttps://mcp.cloudflare.com/mcp
  • Сервер AI GatewayВыполняйте поиск по своим логам, получайте подробности о промптах и ответахhttps://ai-gateway.mcp.cloudflare.com/mcp
  • Сервер Audit LogsВыполняйте запросы к журналам аудита и формируйте отчёты для проверкиhttps://auditlogs.mcp.cloudflare.com/mcp
  • Сервер AutoRAGПоиск и запросы к экземплярам AutoRAG аккаунтаhttps://autorag.mcp.cloudflare.com/mcp
  • Сервер Browser RunЗагружайте веб-страницы, преобразуйте их в markdown и делайте снимки экранаhttps://browser.mcp.cloudflare.com/mcp
  • Сервер Cloudflare BlogПоиск и чтение публикаций в Cloudflare Bloghttps://blog.mcp.cloudflare.com/mcp
  • Cloudflare One CASB serverБыстро выявляйте неправильные конфигурации безопасности SaaS-приложений для защиты пользователей и данныхhttps://casb.mcp.cloudflare.com/mcp
  • Сервер контейнеровРазверните среду разработки sandboxhttps://containers.mcp.cloudflare.com/mcp
  • сервер Demo DayДемонстрация минимального MCP-сервера Cloudflarehttps://demo-day.mcp.cloudflare.com/mcp
  • Сервер Digital Experience MonitoringПолучить быстрый обзор критически важных приложений в вашей организацииhttps://dex.mcp.cloudflare.com/mcp
  • Сервер DNS AnalyticsОптимизируйте производительность DNS и отлаживайте проблемы с учётом текущей настройкиhttps://dns-analytics.mcp.cloudflare.com/mcp
  • Сервер документацииПолучайте актуальную справочную информацию о Cloudflarehttps://docs.mcp.cloudflare.com/mcp
  • Logpush-серверПолучить краткие сводки о состоянии задач Logpushhttps://logs.mcp.cloudflare.com/mcp
  • Сервер наблюдаемостиОтлаживайте приложение и анализируйте его журналы и аналитикуhttps://observability.mcp.cloudflare.com/mcp
  • Сервер RadarИзучите данные Cloudflare Radar о состоянии интернетаhttps://radar.mcp.cloudflare.com/mcp
  • Сервер Workers BindingsСоздавайте приложения Workers с примитивами хранения, ИИ и вычисленийhttps://bindings.mcp.cloudflare.com/mcp
  • Сервер Workers BuildsПолучить аналитику и управлять Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp
Wrangler CLI

Локальная разработка, деплой и команды, специфичные для Workers.

Используйте Wrangler для локальной разработки, развёртывания и команд для конкретных продуктов, например wrangler d1 migrations apply или wrangler tail. Встроенный wrangler Skill учит агента, когда к нему обращаться.

Документация, удобная для агентов

Экономичные по токенам справочные материалы, оптимизированные для агентов.

Добавьте в конец /index.md к любому URL-адресу документации Cloudflare, чтобы получить чистую версию в markdown. У каждого раздела продукта верхнего уровня также есть собственный llms.txt то есть индекс страниц, рассчитанный на одно контекстное окно. Несколько полезных примеров:

Чтобы получить полное представление о том, как эта документация структурирована для агентов, см. руководство «Docs for Agents».

Примеры запросов

Build a serverless AI inference endpoint on Workers AI with streaming responses.
Use Workers for Platforms to let my customers deploy their own code in isolated environments.
Configure caching rules and cache TTLs to reduce origin load for my e-commerce store.
Optimize my Worker to serve WebP images with responsive resizing using Cloudflare Images.
Set up a Waiting Room to handle flash sale traffic spikes without dropping requests.

Советы

Часто задаваемые вопросы

Почему сервер MCP показывает только три инструмента?

Спецификация Cloudflare API насчитывает около двух миллионов токенов, поэтому передать её агенту напрямую невозможно. Сервер Cloudflare MCP использует паттерн выполнения кода: агент получает инструмент для поиска по спецификации API и инструмент для выполнения вызовов, а сама спецификация остаётся на стороне сервера. Наличие всего трёх инструментов является правильным и здоровым состоянием.

Это работает только с Visual Studio Code?

Нет. Тот же URL сервера (https://mcp.cloudflare.com/mcp) работает в Claude Code, Cursor, Claude Desktop и в любом клиенте с поддержкой MCP. Visual Studio Code лишь один из множества вариантов.

Можно ли использовать API-токен Cloudflare вместо OAuth?

Да. Вы можете передавать Cloudflare API токен в качестве bearer-токена, что имеет смысл для CI/CD или общей автоматизации. Для интерактивной работы в редакторе рекомендуется использовать OAuth. API токены с фильтрацией по IP-адресам клиента не поддерживаются.

Нужен ли мне GitHub Copilot, чтобы использовать MCP в Visual Studio Code?

Copilot Chat это MCP-клиент, используемый в этом руководстве, поэтому да: вам нужен Copilot (или другое расширение с поддержкой MCP), чтобы фактически управлять сервером. Сам Visual Studio Code предоставляет конфигурацию MCP и управляет её жизненным циклом, но интерфейс чата предоставляется Copilot.

Устранение неполадок

Chat выдаёт ошибку 'Cannot read properties of undefined'

Сборка Visual Studio Code и расширение Copilot рассинхронизированы. Обновите Visual Studio Code с помощью синей кнопки в строке заголовка, дайте ему перезапуститься и попробуйте снова.

Операции записи завершаются с ошибкой API 10000, а чтение работает

Право доступа OAuth оказывается доступным только для чтения, даже если вы намеревались предоставить полный доступ. Так бывает, если авторизация выполняется более одного раза: последующие сеансы могут незаметно пройти с урезанной областью действия. Отзовите приложение в разделе My Profile → Access Management → Connected Applications в панели управления Cloudflare, выйдите из сессии MCP в Visual Studio Code (значок учётной записи внизу панели Activity Bar), а затем запустите сервер заново.

В mcp.json не появляется кнопка Start

Проверьте корневой ключ в JSON. Visual Studio Code требует servers, а не mcpServers. Также убедитесь, что файл находится в .vscode/mcp.json внутри открытой папки, а не в её корне.

Агент предлагает создать API токен, чтобы обойти ошибку

Откажитесь. Если аутентификация не работает, решение: заново выдать разрешение OAuth, а не вставлять токен доступа в окно чата. Чтобы корректно переоформить разрешение, следуйте шагам устранения неполадок для ошибки API 10000.

Ошибки 401 в логах Visual Studio Code

Ожидаемое поведение, пока вы не выберете Allow in this Session в окне авторизации Copilot Chat.

Создание агентов на Cloudflare

Cloudflare не просто площадка для развёртывания агентов, а полноценный стек для создания собственных агентов.

Agents SDK

Stateful AI агенты с состоянием, планированием, RPC, почтой, потоковым чатом, а также Code Mode SDK для экономичного по токенам использования инструментов.

Подробнее
Создание MCP-сервера

Разверните удалённый MCP сервер на Workers с OAuth, устойчивым состоянием и потоковым HTTP транспортом.

Подробнее
Workers AI

Запускайте LLM, embedding модели и модели для работы с изображениями с открытым исходным кодом на edge. Используйте как провайдера моделей для своего агента.

Подробнее
Worker Loader

Загружает пользовательский код в изолированные Workers по требованию. Безопасная песочница, лежащая в основе Code Mode.

Подробнее

Другие агенты

Anthropic

Claude Code

Терминальный агент для написания кода, который понимает вашу кодовую базу, выполняет команды, редактирует файлы и управляет git. Разработан компанией Anthropic.

Просмотреть руководство
OpenAI

Codex

Агент для написания кода от OpenAI, доступен как терминальный CLI и десктопное приложение. Читает и записывает файлы, выполняет команды и работает с вебом в песочнице.

Просмотреть руководство
Cursor

Cursor

IDE с приоритетом на ИИ на основе VS Code: правки в нескольких файлах через Composer и фоновые агенты. Разработчик: Cursor.

Просмотреть руководство
GitHub

GitHub Copilot

Расширение для редактора и инструмент командной строки с режимом агента, контекстом рабочей области и встроенной интеграцией с PR. Разработано GitHub.

Просмотреть руководство
Аномалия

OpenCode

Терминальный агент с открытым исходным кодом и продвинутым TUI, работает с более чем 75 LLM. Разработан компанией Anomaly.

Просмотреть руководство
Cognition

Windsurf

Агентная IDE с контекстом Cascade и Flows для многошаговых задач. Разработчик: Cognition.

Просмотреть руководство
LM Studio

Bionic

Мощный агент для написания кода и работы. Изначально локальный, с открытыми моделями в облаке. От LM Studio.

Просмотреть руководство