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

Windsurf + Cloudflare

Все агенты

Cognition

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

IDEАвтономное приложение

Cloudflare SkillsCloudflare Code Mode API MCPСпециализированные MCP-серверы CloudflareWindsurf Docs

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

Скачать Windsurf

Скачайте Windsurf для macOS, Windows или Linux со страница загрузок Windsurf ↗.

Установите Cloudflare Skills

npx skills add https://github.com/cloudflare/skills

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

Добавление серверов Cloudflare API и docs в ~/.codeium/windsurf/mcp_config.json. Сведения о специализированных MCP-серверах см. в разделе mcp-server-cloudflare ↗. Сведения о полнофункциональном MCP-сервере Cloudflare API (Code Mode) см. в разделе cloudflare/mcp ↗.

{
  "mcpServers": {
    "cloudflare": { "serverUrl": "https://mcp.cloudflare.com/mcp" },
    "cloudflare-docs": { "serverUrl": "https://docs.mcp.cloudflare.com/mcp" },
    "cloudflare-bindings": { "serverUrl": "https://bindings.mcp.cloudflare.com/mcp" },
    "cloudflare-builds": { "serverUrl": "https://builds.mcp.cloudflare.com/mcp" },
    "cloudflare-observability": { "serverUrl": "https://observability.mcp.cloudflare.com/mcp" }
  }
}

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

Откройте Cascade и попробуйте запрос, например:
```
Add a D1 database to my Worker and create a users table with full CRUD endpoints.
```

Доступ к платформе 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 то есть индекс страниц, рассчитанный на одно контекстное окно. Несколько полезных примеров:

developers.cloudflare.com/llms.txt то есть каталог всех продуктов Cloudflare.
developers.cloudflare.com/workers/llms.txt
developers.cloudflare.com/agents/llms.txt
developers.cloudflare.com/r2/llms.txt
developers.cloudflare.com/d1/llms.txt

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

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

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

Create a RAG pipeline using Vectorize and Workers AI to answer questions over my documentation.

Deploy a globally distributed REST API on Workers with automatic scaling and zero cold starts.

Set up rate limiting and WAF rules to block abuse on my public API.

Set up AI Gateway to route requests across OpenAI and Workers AI with automatic fallback and cost tracking.

Советы

MCP сервер Cloudflare API использует Code Mode: Cascade пишет JavaScript, чтобы обратиться к любому из более чем 2,500+ конечных точек, потратив ~1,000 токенов.
Используйте @-mention, чтобы включить свой wrangler.jsonc в промптах Cascade. Благодаря этому Cascade понимает ваши текущие привязки при генерации кода.
Добавьте MCP-сервер observability, чтобы Cascade мог автоматически проверять логи Workers и отлаживать развёртывания, не выходя из IDE.

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

Поддерживает ли Windsurf Cloudflare Skills?

Да. Windsurf поддерживает Agent Skills в Cascade. Установите набор Cloudflare Skills из cloudflare/skills ↗ см. документация по Windsurf Cascade Skills ↗ для места, откуда Cascade обнаруживает и загружает Skills.

Что использовать: Skills, MCP сервер, Wrangler CLI или всё сразу?

Все три инструмента дополняют друг друга. Cloudflare Skills обучают Cascade паттернам и соглашениям разработки на Workers. MCP-сервер Cloudflare API отвечает за операции платформы (DNS, WAF, Zero Trust, бакеты R2). Wrangler во встроенном терминале Windsurf закрывает локальную разработку и деплой. Cascade естественным образом координирует работу между ними.

Может ли Cascade развернуть проект в Cloudflare?

Да. Cascade может выполнять npx wrangler deploy во встроенном терминале, а при настроенном MCP сервере он может также напрямую вызывать Cloudflare API для управляемых развёртываний и создания ресурсов.

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

MCP сервер не подключается

Проверьте свой mcp_config.json конфигурацию. После внесения изменений перезапустите Windsurf. Убедитесь, что URL-адрес MCP сервера заканчивается на /mcp.

Получение устаревшей информации о продуктах Cloudflare

Включить MCP-сервер документации Cloudflare чтобы агент мог загружать актуальную документацию во время выполнения. Если вы не хотите использовать MCP сервер, укажите агенту напрямую на developers.cloudflare.com/llms.txt для каталога всех продуктов, либо developers.cloudflare.com/<product>/llms.txt для индекса конкретного продукта.

Создание агентов на 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

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

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

GitHub

GitHub Copilot

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

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

Аномалия

OpenCode

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

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

Microsoft

Visual Studio Code

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

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

LM Studio

Bionic

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

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