diff --git a/public/__redirects b/public/__redirects index 954e467def5738..73f371d71d2332 100644 --- a/public/__redirects +++ b/public/__redirects @@ -143,6 +143,7 @@ /agents/guides/build-mcp-server/ /agents/guides/remote-mcp-server/ 301 /agents/capabilities/mcp-server/ /agents/model-context-protocol/ 301 /agents/api-reference/calling-agents/ /agents/api-reference/routing/ 301 +/agents/model-context-protocol/mcp-servers-for-cloudflare/ /cloudflare-for-agents/mcp-servers/ 301 # ai /ai/ /use-cases/ai/ 301 diff --git a/src/content/docs/agents/model-context-protocol/mcp-servers-for-cloudflare.mdx b/src/content/docs/agents/model-context-protocol/mcp-servers-for-cloudflare.mdx deleted file mode 100644 index c9363813823c8b..00000000000000 --- a/src/content/docs/agents/model-context-protocol/mcp-servers-for-cloudflare.mdx +++ /dev/null @@ -1,35 +0,0 @@ ---- -pcx_content_type: concept -title: Cloudflare's own MCP servers -tags: - - MCP -sidebar: - order: 8 ---- - -import { Render } from "~/components"; - -Cloudflare runs a catalog of managed remote MCP Servers which you can connect to using OAuth on clients like [Claude](https://modelcontextprotocol.io/quickstart/user), [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp), our own [AI Playground](https://playground.ai.cloudflare.com/) or any [SDK that supports MCP](https://github.com/cloudflare/agents/tree/main/packages/agents/src/mcp). - -These MCP servers allow your MCP Client to read configurations from your account, process information, make suggestions based on data, and even make those suggested changes for you. All of these actions can happen across Cloudflare's many services including application development, security and performance. They support both the `streamble-http` transport via `/mcp` and the `sse` transport (deprecated) via `/sse`. - -| Server Name | Description | Server URL | -| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------- | -| [Documentation server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/docs-vectorize) | Get up to date reference information on Cloudflare | `https://docs.mcp.cloudflare.com/mcp` | -| [Workers Bindings server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-bindings) | Build Workers applications with storage, AI, and compute primitives | `https://bindings.mcp.cloudflare.com/mcp` | -| [Workers Builds server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-builds) | Get insights and manage your Cloudflare Workers Builds | `https://builds.mcp.cloudflare.com/mcp` | -| [Observability server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-observability) | Debug and get insight into your application's logs and analytics | `https://observability.mcp.cloudflare.com/mcp` | -| [Radar server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/radar) | Get global Internet traffic insights, trends, URL scans, and other utilities | `https://radar.mcp.cloudflare.com/mcp` | -| [Container server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/sandbox-container) | Spin up a sandbox development environment | `https://containers.mcp.cloudflare.com/mcp` | -| [Browser rendering server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/browser-rendering) | Fetch web pages, convert them to markdown and take screenshots | `https://browser.mcp.cloudflare.com/mcp` | -| [Logpush server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/logpush) | Get quick summaries for Logpush job health | `https://logs.mcp.cloudflare.com/mcp` | -| [AI Gateway server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/ai-gateway) | Search your logs, get details about the prompts and responses | `https://ai-gateway.mcp.cloudflare.com/mcp` | -| [AI Search server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/autorag) | List and search documents on your AI Searches | `https://autorag.mcp.cloudflare.com/mcp` | -| [Audit Logs server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/auditlogs) | Query audit logs and generate reports for review | `https://auditlogs.mcp.cloudflare.com/mcp` | -| [DNS Analytics server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/dns-analytics) | Optimize DNS performance and debug issues based on current set up | `https://dns-analytics.mcp.cloudflare.com/mcp` | -| [Digital Experience Monitoring server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/dex-analysis) | Get quick insight on critical applications for your organization | `https://dex.mcp.cloudflare.com/mcp` | -| [Cloudflare One CASB server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/cloudflare-one-casb) | Quickly identify any security misconfigurations for SaaS applications to safeguard users & data | `https://casb.mcp.cloudflare.com/mcp` | -| [GraphQL server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/graphql/) | Get analytics data using Cloudflare's GraphQL API | `https://graphql.mcp.cloudflare.com/mcp` | -| [Agents SDK Documentation server](https://github.com/cloudflare/agents/tree/main/site/agents) | Token-efficient search of the Cloudflare Agents SDK documentation | `https://agents.cloudflare.com/mcp` | - -Check our [GitHub page](https://github.com/cloudflare/mcp-server-cloudflare) to know how to use Cloudflare's remote MCP servers with different MCP clients. diff --git a/src/content/docs/cloudflare-for-agents/index.mdx b/src/content/docs/cloudflare-for-agents/index.mdx new file mode 100644 index 00000000000000..87a92407269c46 --- /dev/null +++ b/src/content/docs/cloudflare-for-agents/index.mdx @@ -0,0 +1,65 @@ +--- +title: Cloudflare for Agents +pcx_content_type: overview +sidebar: + order: 1 +head: + - tag: title + content: Cloudflare for Agents +--- + +import { Description, Feature, LinkButton } from "~/components"; + + + +Services and tools that help AI agents interact with Cloudflare and the web. + + + +Cloudflare provides services that AI agents can use to browse the web, process content, access Cloudflare APIs, and more. These services work with any AI agent, whether built with the [Cloudflare Agents SDK](/agents/) or other frameworks. + + + Browse MCP servers + + +--- + +## Services + + + Modular capabilities for AI agents to connect to tools, services, and APIs. + Skills provide reusable building blocks for agent functionality. + + + + Connect to Cloudflare's managed MCP servers for documentation, observability, + browser rendering, and more. Works with Claude, Cursor, Windsurf, and other + MCP clients. + + + + Convert any page on your zone to Markdown using content negotiation. Agents + request pages with `Accept: text/markdown` and receive clean, token-efficient + Markdown. + + + + Give agents the ability to deploy Workers, manage KV, R2, D1, and other + Cloudflare resources using the Wrangler CLI with API tokens. + diff --git a/src/content/docs/cloudflare-for-agents/markdown-for-agents.mdx b/src/content/docs/cloudflare-for-agents/markdown-for-agents.mdx new file mode 100644 index 00000000000000..5ff86020cac9d0 --- /dev/null +++ b/src/content/docs/cloudflare-for-agents/markdown-for-agents.mdx @@ -0,0 +1,106 @@ +--- +title: Markdown for Agents +pcx_content_type: how-to +sidebar: + order: 3 +--- + +import { Tabs, TabItem, Plan } from "~/components"; + + + +Markdown for Agents converts HTML pages to Markdown in real-time using [content negotiation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Content_negotiation). When enabled on a zone, clients can request any page with the `Accept: text/markdown` header and receive clean, token-efficient Markdown. + +Markdown's explicit structure enables reliable chunking and retrieval, and reduces token usage compared to raw HTML. + +## Enable Markdown for Agents + + + + +1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. +2. Select your zone. +3. In the sidebar under **Quick Actions**, toggle **Markdown for Agents** to enable. + + + + +Send a `PATCH` request to enable markdown conversion: + +```bash +curl -X PATCH "https://api.cloudflare.com/client/v4/zones/{zone_id}/settings/content_converter" \ + --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ + --header "Content-Type: application/json" \ + --data '{"value": "on"}' +``` + +You need an API token with **Zone Settings:Edit** permission. + + + + +## Request Markdown content + +Add the `Accept: text/markdown` header to request Markdown instead of HTML. + +### curl example + +```bash +curl "https://example.com/docs/getting-started/" \ + --header "Accept: text/markdown" +``` + +### JavaScript example + +```js +const response = await fetch("https://example.com/docs/getting-started/", { + headers: { + Accept: "text/markdown", + }, +}); + +const tokenCount = response.headers.get("x-markdown-tokens"); +const markdown = await response.text(); +``` + +## Response headers + +Markdown responses include these headers: + +| Header | Description | +| ------------------- | ---------------------------------------------- | +| `content-type` | Set to `text/markdown` | +| `x-markdown-tokens` | Estimated token count of the converted content | + +The `x-markdown-tokens` header helps estimate context window usage and calculate costs when integrating with AI systems. + +### Example response + +```txt +HTTP/2 200 +content-type: text/markdown +x-markdown-tokens: 1234 + +# Getting Started + +Welcome to our documentation... +``` + +## Other Markdown conversion options + +Cloudflare provides additional ways to convert content to Markdown: + +| Service | Use case | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------- | +| [Workers AI toMarkdown](/workers-ai/features/markdown-conversion/) | Convert documents (PDF, images) to Markdown with AI-powered summarization | +| [Browser Rendering /markdown](/browser-rendering/rest-api/markdown-endpoint/) | Render JavaScript-heavy pages then convert to Markdown | + +## Availability + +Markdown for Agents is available to Pro and Business plans, and SSL for SaaS customers at no additional cost. + +## Limitations + +- Converts HTML only. Other document types are not supported. +- Compressed responses from the origin are not supported. +- This is a zone-level setting. For different settings on subdomains, use separate zones. diff --git a/src/content/docs/cloudflare-for-agents/mcp-servers.mdx b/src/content/docs/cloudflare-for-agents/mcp-servers.mdx new file mode 100644 index 00000000000000..2a2141999a6c63 --- /dev/null +++ b/src/content/docs/cloudflare-for-agents/mcp-servers.mdx @@ -0,0 +1,26 @@ +--- +title: MCP servers +pcx_content_type: reference +sidebar: + order: 2 +--- + +import { Render } from "~/components"; + +Cloudflare runs a catalog of managed remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers that you can connect to using OAuth on clients like [Claude](https://modelcontextprotocol.io/quickstart/user), [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp), [Cloudflare AI Playground](https://playground.ai.cloudflare.com/), or any [SDK that supports MCP](https://github.com/cloudflare/agents/tree/main/packages/agents/src/mcp). + +These MCP servers allow your MCP client to read configurations from your account, process information, make suggestions based on data, and make changes for you. All servers support both `streamable-http` transport via `/mcp` and SSE transport (deprecated) via `/sse`. + +## Connect to MCP servers + + + +## Available servers + + + +For more information on each server, visit the [GitHub repository](https://github.com/cloudflare/mcp-server-cloudflare). + +## Build your own MCP server + +To build and deploy your own MCP server on Cloudflare, refer to the [MCP documentation](/agents/model-context-protocol/) in the Agents SDK. diff --git a/src/content/docs/cloudflare-for-agents/skills.mdx b/src/content/docs/cloudflare-for-agents/skills.mdx new file mode 100644 index 00000000000000..6e6774cb339d1a --- /dev/null +++ b/src/content/docs/cloudflare-for-agents/skills.mdx @@ -0,0 +1,9 @@ +--- +pcx_content_type: navigation +title: Skills +external_link: https://github.com/cloudflare/skills +sidebar: + order: 4 +head: [] +description: Modular capabilities for AI agents to connect to tools, services, and APIs. +--- diff --git a/src/content/docs/cloudflare-for-agents/wrangler-cli.mdx b/src/content/docs/cloudflare-for-agents/wrangler-cli.mdx new file mode 100644 index 00000000000000..c2b5d9c5e6858b --- /dev/null +++ b/src/content/docs/cloudflare-for-agents/wrangler-cli.mdx @@ -0,0 +1,249 @@ +--- +title: Wrangler CLI +pcx_content_type: how-to +sidebar: + order: 5 +description: Give AI agents the ability to deploy and manage Cloudflare resources using the Wrangler CLI. +--- + +import { LinkCard } from "~/components"; + +AI agents can use the [Wrangler CLI](/workers/wrangler/) to deploy Workers, manage KV namespaces, interact with R2 buckets, and perform other Cloudflare operations. This guide shows you how to create an API token with the right permissions and configure an agent to use it. + +## Why give an agent Wrangler access? + +Agents with Wrangler CLI access can: + +- Deploy and update Workers +- Create and manage KV namespaces and data +- Upload files to R2 buckets +- Create and query D1 databases +- Manage Queues and Durable Objects +- Tail logs and debug running Workers + +This is useful for building agents that can autonomously deploy code, manage infrastructure, or help developers with Cloudflare-related tasks. + +## Create an API token + +API tokens provide scoped, revocable access to Cloudflare resources. For agents, create a dedicated token with only the permissions needed. + +### Step 1: Navigate to API Tokens + +1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) +2. Go to **My Profile** > **API Tokens** (for a user token), or **Manage Account** > **API Tokens** (for an account token) +3. Select **Create Token** + +:::note +For agents running in CI/CD or production environments, prefer **Account API tokens** over user tokens. Account tokens can be managed by account administrators and are not tied to a single user. +::: + +### Step 2: Choose a template or create custom token + +For most Wrangler operations, use the **Edit Cloudflare Workers** template. This provides: + +| Permission | Access | +| ------------------ | ------ | +| Workers Scripts | Edit | +| Workers KV Storage | Edit | +| Workers R2 Storage | Edit | +| Workers Routes | Edit | +| Workers Tail | Read | +| Account Settings | Read | +| User Details | Read | + +If your agent needs additional capabilities (like D1 or Durable Objects), select **Create Custom Token** instead and add: + +| Permission | Access | +| --------------- | ------ | +| D1 | Edit | +| Durable Objects | Edit | +| Queues | Edit | +| Vectorize | Edit | + +### Step 3: Scope the token + +1. Under **Account Resources**, select the specific account(s) the agent should access +2. Under **Zone Resources**, select specific zones or **All zones** depending on your needs +3. Optionally set **Client IP Address Filtering** to restrict where the token can be used from +4. Optionally set a **TTL** (time to live) if the agent only needs temporary access + +### Step 4: Create and copy the token + +1. Select **Continue to summary** +2. Review the permissions and select **Create Token** +3. **Copy the token immediately** — it will not be shown again + +To verify your token works: + +```sh +curl "https://api.cloudflare.com/client/v4/user/tokens/verify" \ + --header "Authorization: Bearer " +``` + +## Configure your agent to use the token + +There are several ways to provide the API token to Wrangler when running commands from an agent. + +### Option 1: Environment variable (recommended) + +Set the `CLOUDFLARE_API_TOKEN` environment variable before running Wrangler commands: + +```sh +export CLOUDFLARE_API_TOKEN= +export CLOUDFLARE_ACCOUNT_ID= +``` + +Your agent can then run Wrangler commands normally: + +```sh +npx wrangler deploy +npx wrangler kv key put --namespace-id= "mykey" "myvalue" +npx wrangler r2 object put my-bucket/file.txt --file=./file.txt +``` + +### Option 2: Inline with command + +Pass the token inline for one-off commands: + +```sh +CLOUDFLARE_API_TOKEN= CLOUDFLARE_ACCOUNT_ID= npx wrangler deploy +``` + +### Option 3: Using a `.env` file + +Create a `.env` file in the project directory: + +```txt title=".env" +CLOUDFLARE_API_TOKEN= +CLOUDFLARE_ACCOUNT_ID= +``` + +Wrangler automatically loads environment variables from `.env` files. + +:::caution +Never commit `.env` files containing API tokens to version control. Add `.env` to your `.gitignore` file. +::: + +## Common Wrangler commands for agents + +Here are the most useful Wrangler commands an agent might run: + +### Deploying Workers + +```sh +# Deploy a Worker +npx wrangler deploy + +# Deploy to a specific environment +npx wrangler deploy --env production + +# Deploy with a custom name +npx wrangler deploy --name my-worker +``` + +### Managing KV + +```sh +# List KV namespaces +npx wrangler kv namespace list + +# Create a KV namespace +npx wrangler kv namespace create "MY_KV" + +# Write a key-value pair +npx wrangler kv key put --namespace-id= "key" "value" + +# Read a key +npx wrangler kv key get --namespace-id= "key" + +# List keys +npx wrangler kv key list --namespace-id= +``` + +### Managing R2 + +```sh +# List R2 buckets +npx wrangler r2 bucket list + +# Create a bucket +npx wrangler r2 bucket create my-bucket + +# Upload a file +npx wrangler r2 object put my-bucket/path/file.txt --file=./local-file.txt + +# Download a file +npx wrangler r2 object get my-bucket/path/file.txt --file=./downloaded.txt +``` + +### Managing D1 + +```sh +# List D1 databases +npx wrangler d1 list + +# Create a database +npx wrangler d1 create my-database + +# Execute SQL +npx wrangler d1 execute my-database --command="SELECT * FROM users" + +# Run migrations +npx wrangler d1 migrations apply my-database +``` + +### Debugging + +```sh +# View live logs from a deployed Worker +npx wrangler tail my-worker + +# Check authentication status +npx wrangler whoami +``` + +## Verifying authentication + +Your agent can verify that authentication is working by running: + +```sh +npx wrangler whoami +``` + +## Security best practices + +When giving agents access to Wrangler: + +1. **Use dedicated tokens** — Create a separate API token for each agent or use case. Never reuse tokens across multiple systems. + +2. **Apply least privilege** — Only grant the permissions the agent actually needs. If an agent only reads from KV, do not give it edit access. + +3. **Set token TTLs** — For temporary or testing purposes, set an expiration date on the token. + +4. **Rotate tokens regularly** — Periodically create new tokens and revoke old ones, especially for long-running agents. + +5. **Monitor token usage** — Use [Cloudflare Audit Logs](/fundamentals/account/account-security/review-audit-logs/) to track what actions are being performed with your tokens. + +6. **Store tokens securely** — Use your platform's secret management (environment variables, secret stores) rather than hardcoding tokens. + +7. **Restrict by IP** — If your agent runs from known IP addresses, use IP filtering when creating the token. + +## Related resources + + + + + + diff --git a/src/content/docs/style-guide/ai-tooling.mdx b/src/content/docs/style-guide/ai-tooling.mdx index 6be27afcb7c632..8ea796a9bffa04 100644 --- a/src/content/docs/style-guide/ai-tooling.mdx +++ b/src/content/docs/style-guide/ai-tooling.mdx @@ -49,6 +49,6 @@ Cloudflare runs a catalog of managed remote MCP Servers which you can connect to :::note -For other MCP servers offered by Cloudflare, refer to [Cloudflare's MCP servers](/agents/model-context-protocol/mcp-servers-for-cloudflare/). +For other MCP servers offered by Cloudflare, refer to [Cloudflare's MCP servers](/cloudflare-for-agents/mcp-servers/). ::: diff --git a/src/content/docs/workers/get-started/agent-setup.mdx b/src/content/docs/workers/get-started/agent-setup.mdx new file mode 100644 index 00000000000000..26f6e6fb5a830f --- /dev/null +++ b/src/content/docs/workers/get-started/agent-setup.mdx @@ -0,0 +1,89 @@ +--- +title: AI agent setup +pcx_content_type: how-to +sidebar: + order: 4 +head: + - tag: title + content: Set up your AI coding agent +--- + +import { Tabs, TabItem, Render } from "~/components"; + +Configure your AI coding agent to build effectively on Cloudflare. This guide covers installing skills, connecting MCP servers, and creating API tokens for deployment. + +## Install the Cloudflare skill + + + +## Connect MCP servers + +MCP servers provide your agent with tools and context. Connect to Cloudflare's managed servers for documentation, observability, and more. + + + +For the full list of available servers, refer to [Cloudflare MCP servers](/cloudflare-for-agents/mcp-servers/). + +## Create an API token for deployment + +When your agent needs to deploy Workers or manage Cloudflare resources, create a scoped API token. + +### Create a Workers development token + +1. Go to the [Cloudflare dashboard API Tokens page](https://dash.cloudflare.com/profile/api-tokens). +2. Select **Create Token**. +3. Select **Create Custom Token**. +4. Add a descriptive name like "AI Agent - Workers Development". +5. Configure permissions: + +| Permission | Access | +| ---------------------------- | ------ | +| Account / Workers Scripts | Edit | +| Account / Workers KV Storage | Edit | +| Account / D1 | Edit | +| Account / R2 Storage | Edit | +| Account / Durable Objects | Edit | +| Zone / Workers Routes | Edit | + +6. Under **Account Resources**, select your account. +7. Under **Zone Resources**, select **All zones** or specific zones. +8. Select **Continue to summary**, then **Create Token**. +9. Copy the token value. You will not see it again. + +### Use the token with Wrangler + +Set the token as an environment variable: + +```sh +export CLOUDFLARE_API_TOKEN= +``` + +Verify the token works: + +```sh +npx wrangler whoami +``` + +Deploy your Worker: + +```sh +npx wrangler deploy +``` + +### Security best practices + +- Use [Account API tokens](/fundamentals/api/get-started/account-owned-tokens/) for CI/CD and agents instead of user tokens +- Scope tokens to specific accounts and zones when possible +- Set a TTL for temporary access +- Rotate tokens regularly +- Never commit tokens to version control + +## Use the Workers prompt + +For additional context, use the [Workers mega prompt](/workers/get-started/prompting/) in your AI tool. The prompt includes API examples, configuration guidance, and best practices. + +## Next steps + +- [Build your first Worker](/workers/get-started/guide/) +- [Build an AI agent](/agents/getting-started/build-a-chat-agent/) +- [Browse MCP servers](/cloudflare-for-agents/mcp-servers/) diff --git a/src/content/partials/agents/cloudflare-skill-install.mdx b/src/content/partials/agents/cloudflare-skill-install.mdx new file mode 100644 index 00000000000000..92784ec46d4205 --- /dev/null +++ b/src/content/partials/agents/cloudflare-skill-install.mdx @@ -0,0 +1,49 @@ +import { Tabs, TabItem } from "~/components"; + +The [Cloudflare skill](https://github.com/cloudflare/skills) teaches AI coding agents how to build on Cloudflare. It includes guidance for Workers, Pages, storage (KV, D1, R2), AI services, and the Agents SDK. + + + + +Install from the plugin marketplace: + +```sh +/plugin marketplace add cloudflare/skills +``` + + + + +Install from the Cursor Marketplace or add manually: + +1. Open **Settings** > **Rules**. +2. Select **Add Rule** > **Remote Rule (GitHub)**. +3. Enter `cloudflare/skills`. + + + + +Clone the skills repository and copy to your OpenCode skills directory: + +```sh +git clone https://github.com/cloudflare/skills.git +cp -r skills/* ~/.config/opencode/skills/ +``` + + + + +Install using the `npx skills` CLI: + +```sh +npx skills add https://github.com/cloudflare/skills +``` + + + + +The skill provides: + +- **Commands**: `/cloudflare:build-agent` and `/cloudflare:build-mcp` for guided workflows +- **Contextual skills**: Auto-loaded guidance for Workers, Durable Objects, Agents SDK, Wrangler, and more +- **MCP servers**: Pre-configured connections to Cloudflare documentation, bindings, builds, and observability servers diff --git a/src/content/partials/agents/mcp-connection-tabs.mdx b/src/content/partials/agents/mcp-connection-tabs.mdx new file mode 100644 index 00000000000000..1c6811fcabc5de --- /dev/null +++ b/src/content/partials/agents/mcp-connection-tabs.mdx @@ -0,0 +1,59 @@ +import { Tabs, TabItem } from "~/components"; + + + + +Use this [direct install link](https://cursor.com/en-US/install-mcp?name=cloudflare-docs&config=eyJjb21tYW5kIjoibnB4IG1jcC1yZW1vdGUgaHR0cHM6Ly9kb2NzLm1jcC5jbG91ZGZsYXJlLmNvbS9zc2UifQ%3D%3D) for the Documentation server. + +Or add to your MCP configuration: + +```json +{ + "mcpServers": { + "cloudflare-docs": { + "command": "npx", + "args": ["mcp-remote", "https://docs.mcp.cloudflare.com/mcp"] + } + } +} +``` + + + + +Use this [direct install link](vscode:mcp/install?%7B%22name%22%3A%22cloudflare-docs%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.mcp.cloudflare.com%2Fmcp%22%7D) for the Documentation server. + + + + +Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows): + +```json +{ + "mcpServers": { + "cloudflare-docs": { + "command": "npx", + "args": ["mcp-remote", "https://docs.mcp.cloudflare.com/mcp"] + } + } +} +``` + + + + +Add to `~/.config/opencode/.mcp.json`: + +```json +{ + "mcpServers": { + "cloudflare-docs": { + "command": "npx", + "args": ["mcp-remote", "https://docs.mcp.cloudflare.com/mcp"] + } + } +} +``` + + + diff --git a/src/content/partials/agents/mcp-servers-table.mdx b/src/content/partials/agents/mcp-servers-table.mdx new file mode 100644 index 00000000000000..04cf3c0c54808d --- /dev/null +++ b/src/content/partials/agents/mcp-servers-table.mdx @@ -0,0 +1,18 @@ +| Server | Description | URL | +| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------- | +| [Documentation](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/docs-vectorize) | Up-to-date reference information on Cloudflare | `https://docs.mcp.cloudflare.com/mcp` | +| [Workers Bindings](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-bindings) | Build Workers applications with storage, AI, and compute primitives | `https://bindings.mcp.cloudflare.com/mcp` | +| [Workers Builds](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-builds) | Get insights and manage your Cloudflare Workers Builds | `https://builds.mcp.cloudflare.com/mcp` | +| [Observability](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-observability) | Debug and get insight into your application's logs and analytics | `https://observability.mcp.cloudflare.com/mcp` | +| [Radar](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/radar) | Global Internet traffic insights, trends, URL scans, and utilities | `https://radar.mcp.cloudflare.com/mcp` | +| [Container](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/sandbox-container) | Spin up a sandbox development environment | `https://containers.mcp.cloudflare.com/mcp` | +| [Browser Rendering](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/browser-rendering) | Fetch web pages, convert them to markdown, and take screenshots | `https://browser.mcp.cloudflare.com/mcp` | +| [Logpush](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/logpush) | Quick summaries for Logpush job health | `https://logs.mcp.cloudflare.com/mcp` | +| [AI Gateway](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/ai-gateway) | Search your logs, get details about prompts and responses | `https://ai-gateway.mcp.cloudflare.com/mcp` | +| [AI Search](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/autorag) | List and search documents on your AI Searches | `https://autorag.mcp.cloudflare.com/mcp` | +| [Audit Logs](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/auditlogs) | Query audit logs and generate reports for review | `https://auditlogs.mcp.cloudflare.com/mcp` | +| [DNS Analytics](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/dns-analytics) | Optimize DNS performance and debug issues | `https://dns-analytics.mcp.cloudflare.com/mcp` | +| [Digital Experience Monitoring](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/dex-analysis) | Get insight on critical applications for your organization | `https://dex.mcp.cloudflare.com/mcp` | +| [Cloudflare One CASB](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/cloudflare-one-casb) | Identify security misconfigurations for SaaS applications | `https://casb.mcp.cloudflare.com/mcp` | +| [GraphQL](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/graphql/) | Analytics data using Cloudflare's GraphQL API | `https://graphql.mcp.cloudflare.com/mcp` | +| [Agents SDK Documentation](https://github.com/cloudflare/agents/tree/main/site/agents) | Token-efficient search of the Cloudflare Agents SDK documentation | `https://agents.cloudflare.com/mcp` | diff --git a/src/content/products/cloudflare-for-agents.yaml b/src/content/products/cloudflare-for-agents.yaml new file mode 100644 index 00000000000000..c2208ba0beb305 --- /dev/null +++ b/src/content/products/cloudflare-for-agents.yaml @@ -0,0 +1,11 @@ +name: Cloudflare for Agents +product: + title: Cloudflare for Agents + url: /cloudflare-for-agents/ + group: AI + additional_groups: [Developer platform] + tags: [AI] +meta: + title: Cloudflare for Agents docs + description: Services and tools that help AI agents interact with Cloudflare and the web + author: "@cloudflare" diff --git a/src/icons/cloudflare-for-agents.svg b/src/icons/cloudflare-for-agents.svg new file mode 100644 index 00000000000000..1427cd594016af --- /dev/null +++ b/src/icons/cloudflare-for-agents.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/src/util/sidebar.ts b/src/util/sidebar.ts index 0100373f2517a8..0540008e7c75eb 100644 --- a/src/util/sidebar.ts +++ b/src/util/sidebar.ts @@ -94,7 +94,10 @@ export async function generateSidebar(group: Group) { } const product = products.find((p) => p.id === group.label); - if (product && product.data.product.group === "Developer platform") { + const isDeveloperPlatform = + product?.data.product.group === "Developer platform" || + product?.data.product.additional_groups?.includes("Developer platform"); + if (product && isDeveloperPlatform) { const links = [ ["llms.txt", "/llms.txt"], ["prompt.txt", "/workers/prompt.txt"],