Cloudflare Workers Observability

Workers observability and debugging.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Accounts List: List all accounts in your Cloudflare account
  • Set Active Account: Set active account to be used for tool calls that require accountId
  • Workers List: List all Workers in your Cloudflare account. If you only need details of a single Worker, use workers_get_worker.

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Workers observability and debugging. Inspect application logs, analytics, and runtime behavior.

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

Как подключить Cloudflare Workers Observability к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://workers-observability--cloudflare.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить Cloudflare Workers Observability к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://workers-observability--cloudflare.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить Cloudflare Workers Observability к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://workers-observability--cloudflare.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (10)

Технические названия из tools/list. Нужны только разработчикам.

accounts_listList all accounts in your Cloudflare account
set_active_accountSet active account to be used for tool calls that require accountId
workers_listList all Workers in your Cloudflare account. If you only need details of a single Worker, use workers_get_worker.
workers_get_workerGet the details of the Cloudflare Worker.
workers_get_worker_codeGet the source code of a Cloudflare Worker. Note: This may be a bundled version of the worker.
query_worker_observabilityQuery the Workers Observability API to analyze logs and metrics from your Cloudflare Workers. * A query typical query looks like this: {"view":"events","queryId":"workers-logs-events","limit":5,"dry":true,"parameters":{"datasets":["cloudflare-workers"],"filters":[{"id":"520","key":"message","operation":"eq","type":"string","value":"Clickhouse Statistics"},{"id":"2088","key":"statistics.elapsed","operation":"gt","type":"number","value":"0.269481519"}],"calculations":[],"groupBys":[],"havings":[]},"timeframe":{"to":"2025-04-30T20:53:15Z","from":" ""2025-04-30T19:53:15Z"}} ## Core Capabilities This tool provides three primary views of your Worker data: 1. **List Events** - Browse individual request logs and errors 2. **Calculate Metrics** - Compute statistics across requests (avg, p99, etc.) 3. **Find Specific Invocations** - Locate individual requests matching criteria ## Filtering Best Practices - Before applying filters, use the observability_keys and observability_values tools to confirm available filter fields and the correct filter value to add unless you have the data in a response from a previous query. - Common filter fields: $metadata.service, $metadata.trigger, $metadata.message, $metadata.level, $metadata.requestId, ## Calculation Best Practices - Before applying calculations, use the observability_keys tools to confirm key that should be used for the calculation ## Troubleshooting - If no results are returned, suggest broadening the time range or relaxing filters - For errors about invalid fields, recommend using observability_keys to see available options
observability_keysFind keys in the Workers Observability Data ## Best Practices - Set a high limit (1000+) to ensure you see all available keys - Add the $metadata.service filter to narrow results to a specific Worker ## Troubleshooting - If expected fields are missing, verify the Worker is actively logging - For empty results, try broadening your time range
observability_valuesFind values in the Workers Observability Data. ## Troubleshooting - For no results, verify the field exists using observability_keys first - If expected values are missing, try broadening your time range
search_cloudflare_documentationSearch the Cloudflare documentation. This tool should be used to answer any question about Cloudflare products or features, including: - Workers, Pages, R2, Images, Stream, D1, Durable Objects, KV, Workflows, Hyperdrive, Queues - AI Search, Workers AI, Vectorize, AI Gateway, Browser Rendering - Zero Trust, Access, Tunnel, Gateway, Browser Isolation, WARP, DDOS, Magic Transit, Magic WAN - CDN, Cache, DNS, Zaraz, Argo, Rulesets, Terraform, Account and Billing Results are returned as semantically similar chunks to the query.
migrate_pages_to_workers_guideALWAYS read this guide before migrating Pages projects to Workers.