Added Code Mode docs & cross-refs. (#28343)

* [Agents] Add Codemode cross-references and expand MCP server docs

- Expand mcp-servers-for-cloudflare.mdx with detailed Cloudflare API
  MCP server section: Codemode explanation, token comparison table,
  connection instructions, and agent/IDE plugin install guides
- Move Cloudflare API server from table row into its own H2 section
- Reorganize remaining servers under 'Product-specific MCP servers'
- Add Codemode cross-reference section to worker-loader.mdx
- Fix style issues: lowercase 'MCP servers'/'MCP client', standard
  link phrasing, list marker consistency, code indentation

* Fixing nit to trigger compiles action

---------

Co-authored-by: ask-bonk[bot] <ask-bonk[bot]@users.noreply.github.com>
Co-authored-by: Jun Lee <junlee@cloudflare.com>

Author: ask-bonk[bot]

src/content/docs/agents/model-context-protocol/mcp-servers-for-cloudflare.mdx

@@ -7,13 +7,86 @@ sidebar:
   order: 8
 ---
 
-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](/agents/api-reference/mcp-client-api/).
+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 `streamable-http` transport via `/mcp` and the `sse` transport (deprecated) via `/sse`.
+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 `streamable-http` transport via `/mcp` and the `sse` transport (deprecated) via `/sse`.
+
+## Cloudflare API MCP server
+
+The [Cloudflare API MCP server](https://github.com/cloudflare/mcp) provides access to the entire [Cloudflare API](/api/) — over 2,500 endpoints across DNS, Workers, R2, Zero Trust, and every other product — through just two tools: `search()` and `execute()`.
+
+It uses [Codemode](/agents/api-reference/codemode/), a technique where the model writes JavaScript against a typed representation of the OpenAPI spec and the Cloudflare API client, rather than loading individual tool definitions for each endpoint. The generated code runs inside an isolated [Dynamic Worker](/workers/runtime-apis/bindings/worker-loader/) sandbox.
+
+This approach uses approximately 1,000 tokens regardless of how many API endpoints exist. An equivalent MCP server that exposed every endpoint as a native tool would consume over 1 million tokens — more than the entire context window of most foundation models.
+
+| Approach                          | Tools | Token cost |
+| --------------------------------- | ----- | ---------- |
+| Native MCP (full schemas)         | 2,594 | ~1,170,000 |
+| Native MCP (required params only) | 2,594 | ~244,000   |
+| Codemode                          | 2     | ~1,000     |
+
+### Connect to the Cloudflare API MCP server
+
+Add the following configuration to your MCP client:
+
+```json
+{
+	"mcpServers": {
+		"cloudflare-api": {
+			"url": "https://mcp.cloudflare.com/mcp"
+		}
+	}
+}
+```
+
+When you connect, you will be redirected to Cloudflare to authorize via OAuth and select the permissions to grant to your agent.
+
+For CI/CD or automation, you can create a [Cloudflare API token](https://dash.cloudflare.com/profile/api-tokens) with the permissions you need and pass it as a bearer token in the `Authorization` header. Both user tokens and account tokens are supported.
+
+For more information, refer to the [Cloudflare MCP repository](https://github.com/cloudflare/mcp).
+
+### Install via agent and IDE plugins
+
+You can install the [Cloudflare Skills plugin](https://github.com/cloudflare/skills), which bundles the Cloudflare MCP servers alongside contextual skills and slash commands for building on Cloudflare. The plugin works with any agent that supports the Agent Skills standard, including Claude Code, OpenCode, OpenAI Codex, and Pi.
+
+#### Claude Code
+
+Install using the [plugin marketplace](https://code.claude.com/docs/en/discover-plugins#add-from-github):
+
+```txt
+/plugin marketplace add cloudflare/skills
+```
+
+#### Cursor
+
+Install from the **Cursor Marketplace**, or add manually via **Settings** > **Rules** > **Add Rule** > **Remote Rule (Github)** with `cloudflare/skills`.
+
+#### npx skills
+
+Install using the [`npx skills`](https://skills.sh) CLI:
+
+```sh
+npx skills add https://github.com/cloudflare/skills
+```
+
+#### Clone or copy
+
+Clone the [cloudflare/skills](https://github.com/cloudflare/skills) repository and copy the skill folders into the appropriate directory for your agent:
+
+| Agent        | Skill directory              | Docs                                                                                                 |
+| ------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------- |
+| Claude Code  | `~/.claude/skills/`          | [Claude Code skills](https://code.claude.com/docs/en/skills)                                         |
+| Cursor       | `~/.cursor/skills/`          | [Cursor skills](https://cursor.com/docs/context/skills)                                              |
+| OpenCode     | `~/.config/opencode/skills/` | [OpenCode skills](https://opencode.ai/docs/skills/)                                                  |
+| OpenAI Codex | `~/.codex/skills/`           | [OpenAI Codex skills](https://developers.openai.com/codex/skills/)                                   |
+| Pi           | `~/.pi/agent/skills/`        | [Pi coding agent skills](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent#skills) |
+
+## Product-specific MCP servers
+
+In addition to the Cloudflare API MCP server, Cloudflare provides product-specific MCP servers for targeted use cases:
 
 | Server Name                                                                                                             | Description                                                                                     | Server URL                                     |
 | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| [Cloudflare API server](https://github.com/cloudflare/mcp)                                                              | Access the full Cloudflare API (2500+ endpoints) via Code Mode                                  | `https://mcp.cloudflare.com/mcp`               |
 | [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`        |
@@ -31,4 +104,4 @@ These MCP servers allow your MCP Client to read configurations from your account
 | [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.
+Check the [GitHub page](https://github.com/cloudflare/mcp-server-cloudflare) to learn how to use Cloudflare's remote MCP servers with different MCP clients.