Cloudflare GraphQL Analytics
GraphQL analytics API.
Что умеет
- Accounts List: List all accounts in your Cloudflare account
- Set Active Account: Set active account to be used for tool calls that require accountId
- Zones List: List all zones under a Cloudflare account
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
GraphQL analytics API. Query zone, account, and network analytics data from Cloudflare.
Как подключить
Как подключить Cloudflare GraphQL Analytics к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://cloudflare-graphql.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Cloudflare GraphQL Analytics к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://cloudflare-graphql.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Cloudflare GraphQL Analytics к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://cloudflare-graphql.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (10)
Технические названия из tools/list. Нужны только разработчикам.
| accounts_list | List all accounts in your Cloudflare account |
| set_active_account | Set active account to be used for tool calls that require accountId |
| zones_list | List all zones under a Cloudflare account |
| zone_details | Get details for a specific Cloudflare zone |
| graphql_schema_search | Search the Cloudflare GraphQL API schema for types, fields, and enum values matching a keyword Use this tool when: - You are unsure which dataset to use for your query. - A user is looking for specific types, fields, or enum values in the Cloudflare GraphQL API schema. IMPORTANT GUIDELINES: - DO NOT query for dimensions unless the user explicitly asked to group by or show dimensions. - Only include fields that the user specifically requested in their query. - Keep queries as simple as possible while fulfilling the user's request. Workflow: 1. Use this tool to search for dataset types by keyword. 2. When a relevant dataset type is found, immediately use graphql_schema_details to get the complete structure of that dataset. 3. After understanding the schema structure, proceed directly to constructing and executing queries using the graphql_query tool. 4. Do not use graphql_schema_overview or graphql_complete_schema after finding the relevant dataset - these are redundant steps. This tool searches the Cloudflare GraphQL API schema for any schema elements (such as object types, field names, or enum options) that match a given keyword. It returns schema fragments and definitions to assist in constructing valid and precise GraphQL queries. |
| graphql_schema_overview | Fetch the high-level overview of the Cloudflare GraphQL API schema Use this tool when: - A user requests insights into the structure or capabilities of Cloudflare’s GraphQL API. - You need to explore available types, queries, mutations, or schema relationships exposed by Cloudflare’s GraphQL interface. - You're generating or validating GraphQL queries against Cloudflare’s schema. - You are troubleshooting or developing integrations with Cloudflare’s API and require up-to-date schema information. This tool returns a high-level summary of the Cloudflare GraphQL API schema. It provides a structured outline of API entry points, data models, and relationships to help guide query construction or system integration. |
| graphql_type_details | Fetch detailed information about a specific GraphQL type (dataset) IMPORTANT: After exploring the schema, DO NOT generate overly complicated GraphQL queries that the user didn't explicitly ask for. Only include fields that were specifically requested. Use this tool when: - You need to explore the fields by the type name (dataset) for detailed information - You're building or debugging GraphQL queries and want to ensure the correct usage of schema components - You need contextual information about how a certain concept or object is represented in Cloudflare's GraphQL API. Guidelines for query construction: - Keep queries as simple as possible while fulfilling the user's request - Only include fields that the user specifically asked for - Do not add dimensions or additional fields unless explicitly requested - When in doubt, ask the user for clarification rather than creating a complex query |
| graphql_complete_schema | Fetch the complete Cloudflare GraphQL API schema (combines overview and important type details) |
| graphql_query | Execute a GraphQL query against the Cloudflare API IMPORTANT: ONLY execute the EXACT GraphQL query provided by the user. DO NOT generate complicated queries that the user didn't explicitly ask for. CRITICAL: When querying, make sure to set a LIMIT (e.g., first: 10, limit: 20) otherwise the response may be too large for the MCP server to process. Use this tool when: - A user provides a GraphQL query and expects real-time data from Cloudflare's API. - You need to retrieve live information from Cloudflare, such as analytics, logs, account data, or configuration details. - You want to validate the behavior of a GraphQL query or inspect its runtime results. This tool sends a user-defined GraphQL query to the Cloudflare API and returns the raw response exactly as received. When filtering or querying by time, use ISO 8601 datetime format (e.g., "2020-08-03T02:07:05Z"). For each query execution, a clickable GraphQL API Explorer link will be provided in the response. Users can click this link to open the query in Cloudflare's GraphQL Explorer interface where they can further modify and experiment with the query. Guidelines: - Only use the exact query provided by the user. Do not modify or expand it unless explicitly requested. - Always suggest including limits in queries (e.g., first: 10, limit: 20) to prevent response size issues. - If a query fails due to size limits, advise the user to add or reduce limits in their query. |
| graphql_api_explorer | Generate a Cloudflare GraphQL API Explorer link Use this tool when: - A user asks for any GraphQL queries and wants to explore them in the Cloudflare GraphQL API Explorer. - You want to provide a shareable link to a specific GraphQL query for the user to explore and modify. - You need to help the user visualize or interact with GraphQL queries in a user-friendly interface. This tool generates a direct link to the Cloudflare GraphQL API Explorer with a pre-populated query and variables. The response includes a clickable Markdown link that users can click to open the query in Cloudflare's interactive GraphQL playground. The original query and variables are also displayed for reference. |