[Agents] Clarify that only one MCP server is needed

[ask-bonk]

Summary

Made two changes to src/content/docs/agents/model-context-protocol/cloudflare/servers-for-cloudflare/index.mdx to make it unmistakably clear that users only need one MCP server:

1. Added a prominent tip callout right under the "Cloudflare API MCP server" heading stating that the Cloudflare API MCP server covers the entire API and product-specific servers are optional.

2. Renamed the subsequent section from "Product-specific MCP servers" to "Optional product-specific MCP servers" and added an explicit note that these are optional because the Cloudflare API MCP server already covers the full Cloudflare API.

All checks pass (pnpm run check, pnpm run format:core:check).

Closes #31749

github run

[cloudflare-docs-bot]

Review

✅ No issues found in commit 4a04c4f.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

_{No code review issues found.}

Conventions

Checks PR title, description, and redirect checklist.

_{No convention issues found.}

Style Guide Review

_{No style-guide issues found.}

Redirects

_{No missing redirect entries found.}

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review	Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/docs/agents/	@irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @whoiskatrin, @cloudflare/product-owners, @cloudflare/ai-agents, @cloudflare/dev-plat-leads

[irvinebroque]

/bonk address all PR review feedback and update this PR

[irvinebroque]

Suggested change

	The following product-specific MCP servers are available for targeted use cases. These are **optional** — the [Cloudflare API MCP server](#cloudflare-api-mcp-server) already covers the full Cloudflare API.
	The following product-specific MCP servers are available for targeted use cases. These are **optional** — the [Cloudflare API MCP server](#cloudflare-api-mcp-server) already covers the full Cloudflare API. Most people should just use the main Cloudflare API MCP server.

[irvinebroque]

This MCP server now exposes a tool for reading docs

cloudflare/mcp#148

update docs accordingly

this shouldn't be a tip element

it should just be clear that this is the only MCP server you need, and doesn't need to mention the product-specific MCP servers at all

[ask-bonk]

All PR review feedback has been addressed. Here's what I changed:

1. Style guide warning — Replaced "listed below" on line 20 with a direct reference:
   in [Optional product-specific MCP servers](#optional-product-specific-mcp-servers)

2. PR title format — Updated the title to use a product tag:
   [Agents] Clarify that only one MCP server is needed

3. Summary section — Added a ### Summary section to the PR description with a concise overview of the changes.

Validation passes cleanly:

• pnpm run check — 0 errors
• pnpm run format:core:check — all files formatted correctly

github run

[irvinebroque]

/bonk address all remaining PR feedback

[github-actions]

Preview URL: https://f3bf3ae3.preview.developers.cloudflare.com
Preview Branch URL: https://opencode-issue31749-20260627212539.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/agents/model-context-protocol/cloudflare/servers-for-cloudflare/	https://opencode-issue31749-20260627212539.preview.developers.cloudflare.com/agents/model-context-protocol/cloudflare/servers-for-cloudflare/