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

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

OpenCode + Cloudflare

Все агенты
Аномалия

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

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

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

  1. Установите OpenCode

    Установите OpenCode. Варианты для npm, Homebrew, Bun, Scoop или Windows см. в разделе Руководство по установке OpenCode ↗.

    curl -fsSL https://opencode.ai/install | bash

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

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

  3. Добавление MCP-серверов Cloudflare

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

    {
  "mcp": {
    "cloudflare": { "type": "remote", "url": "https://mcp.cloudflare.com/mcp", "enabled": true },
    "cloudflare-docs": { "type": "remote", "url": "https://docs.mcp.cloudflare.com/mcp", "enabled": true },
    "cloudflare-bindings": { "type": "remote", "url": "https://bindings.mcp.cloudflare.com/mcp", "enabled": true },
    "cloudflare-builds": { "type": "remote", "url": "https://builds.mcp.cloudflare.com/mcp", "enabled": true },
    "cloudflare-observability": { "type": "remote", "url": "https://observability.mcp.cloudflare.com/mcp", "enabled": true }
  }
}

  4. Запустите OpenCode

    Запустите OpenCode из корня своего проекта, где wrangler.jsonc находится (если он уже существует).

    opencode

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

    Например:

    Optimize my Worker to serve WebP images with responsive resizing using Cloudflare Images.

Доступ к платформе 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 multi-tenant SaaS backend where each customer gets an isolated D1 database.
Configure caching rules and cache TTLs to reduce origin load for my e-commerce store.
Create a RAG pipeline using Vectorize and Workers AI to answer questions over my documentation.
Set up GitHub Actions to deploy this Worker to staging and production on Cloudflare.
Add a cron trigger to my Worker that processes a job queue every hour.

Советы

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

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

Все три инструмента. Skills дают OpenCode постоянную экспертизу по Cloudflare, поэтому он знает, когда использовать Durable Objects, а когда KV, как структурировать проект на Workers и когда вызывать CLI, а когда API. MCP-сервер Cloudflare API отвечает за операции платформы (DNS, WAF, Zero Trust, бакеты R2). Wrangler обрабатывает локальную разработку, деплой и команды, специфичные для Workers. Встроенный wrangler Skill учит OpenCode, какой из них использовать.

Как подключить OpenCode к Cloudflare?

При первом обращении OpenCode к инструменту Cloudflare вас перенаправят для авторизации через OAuth и выбора прав доступа.

Можно ли использовать Workers AI в качестве провайдера моделей в OpenCode?

Да. OpenCode поддерживает более 75 провайдеров моделей, включая Cloudflare Workers AI. Настройте модель в .opencode.jsonc.

Является ли OpenCode проектом с открытым исходным кодом?

Да. OpenCode полностью с открытым исходным кодом и доступен по адресу github.com/anomalyco/opencode.

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

Не удаётся подключиться к MCP серверу

Проверьте конфигурацию MCP в .opencode.jsonc использует "type": "remote" с правильным URL-адресом. Выполните opencode mcp list и проверьте подключённые серверы.

Получение устаревшей информации о продуктах 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

Cursor

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

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

GitHub Copilot

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

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

Windsurf

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

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

Visual Studio Code

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

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

Bionic

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

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