שרת MCP מאומת: Cloudflare
התשובה הקצרה
אומת לאחרונה 2026-08-03
Cloudflare לא מפרסמת שרת MCP אחד אלא שבעה עשר, והידיעה מי הוא מי חוסכת אחר צהריים שלם. שישה עשר מהם הם שרתי תחום בכתובות כמו observability.mcp.cloudflare.com ו-bindings.mcp.cloudflare.com, והשבעה עשר, שרת ה-Code Mode בכתובת mcp.cloudflare.com, מגיע ל-API של Cloudflare כולו. כל אלה מבקשים מכם להתחבר ל-Cloudflare דרך OAuth, או לשלוח טוקן API של Cloudflare, לפני שהם עושים משהו. בדיוק אחד מהם אינו דורש שום אישור גישה: שרת התיעוד בכתובת docs.mcp.cloudflare.com, שמחפש בכל עמודי התיעוד למפתחים של Cloudflare. אותו אימתנו, כי הוא היחיד שכל אחד יכול לנסות בתוך דקה. דיברנו איתו בפרוטוקול מה-Mac הזה, ספרנו את הכלים שהוא מחזיר, הרצנו חיפוש תיעוד אמיתי, ואז שברנו אותו בכוונה בארבע דרכים, כולל הפניית לקוח לאחד משרתי החשבון בלי שום אישור גישה כדי לראות בדיוק איך נראה הסירוב. כל הפלט הגולמי נמצא בעמוד הזה. [3][4][11][1]
אימות
השיטה
השרת שאימתנו הוא זה ש-Cloudflare מארחת בכתובת https://docs.mcp.cloudflare.com/mcp, ולכן אין תהליך מקומי ואין באנר הפעלה לקרוא. דיברנו איתו JSON-RPC גולמי על גבי Streamable HTTP מה-Mac הזה: initialize, אחר כך notifications/initialized, אחר כך tools/list, ואחר כך חיפוש תיעוד אמיתי אחד. לא השתמשנו בשום אישור גישה ולא היה צורך בכזה, וזו כל הנקודה בנקודת הקצה הזו. אחר כך הרצנו בכוונה ארבע בדיקות כשל: שם כלי מומצא, קריאה בלי הארגומנט הנדרש, אותה כתובת עם לוכסן בסוף, ולחיצת יד אנונימית מול bindings.mcp.cloudflare.com, אחד משרתי החשבון, כדי ללכוד מה בדיוק אומר הסירוב שלו. לבסוף חזרנו על לחיצת היד דרך גשר ה-npx mcp-remote, המסלול שבו משתמשים לקוחות שיודעים רק stdio, והוא החזיר את אותם שני כלים. טבלת הכלים למטה היא תשובת ה-tools/list, מילה במילה. שתיים מבדיקות הכשל האלה נכשלו בשכבת ה-HTTP ולא בתוך MCP, ולכן הרשומות שלהן בקטע פתרון התקלות מודפסות כפי ש-curl -i מדפיס תשובה: שורת הסטטוס, אחר כך כותרת ה-www-authenticate במקומות שבהם השרת שלח כזו, ואחר כך גוף התשובה. כל חלק הוא בדיוק כפי שנשמר בריצה, ורק ההרכבה לבלוק אחד היא שלנו.
הודעת הפתיחה של השרת
event: message
data: {"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true},"prompts":{"listChanged":true}},"serverInfo":{"name":"docs-ai-search","version":"0.4.10"}},"jsonrpc":"2.0","id":1}קריאת כלי אמיתית אחת
tools/call search_cloudflare_documentation {"query": "How do I set a cache TTL with Cache Rules?"}<result> <url>https://developers.cloudflare.com/changelog/39/</url> <title>39</title> <text> #### How it works Using the `cf` object in `fetch()`, you can override specific Cache Rules settings by:
שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.
כלים
השרת ענה ל-tools/list עם 2 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.
| כלי | מה הוא עושה |
|---|---|
| search_cloudflare_documentationquery* | Search 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 Run - 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_guide | ALWAYS read this guide before migrating Pages projects to Workers. |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:
{
"mcpServers": {
"cloudflare-docs": {
"command": "npx",
"args": [
"mcp-remote",
"https://docs.mcp.cloudflare.com/mcp"
]
}
}
}שורת ה-npx הזו היא גשר mcp-remote, שהופך שרת מתארח לפקודה מקומית שלקוחות ותיקים מצפים לה. הרצנו בדיוק את הגשר הזה באימות והוא החזיר את אותם שני כלים. אם ל-Claude Desktop שלכם יש עמוד Connectors, יש מסלול קצר יותר בלי JSON ובלי גשר: Settings, אחר כך Connectors, אחר כך Add custom connector, והדביקו את הכתובת לבדה. בשני המסלולים אין טוקן להוסיף. [12][15][10]
פקודה אחת בטרמינל, בלי טוקן ובלי גשר:
claude mcp add --transport http cloudflare-docs https://docs.mcp.cloudflare.com/mcp
המקבילה בקובץ הפרויקט היא רשומת .mcp.json עם "type": "http" לצד ה-"url". Claude Code מתייחס ל-url בלי type כשגיאת הגדרה, לכן אל תשמיטו אותו. Cloudflare מפרסמת גם תוסף שמחבר את כל משפחת השרתים שלה בבת אחת: /plugin marketplace add cloudflare/skills, ואחר כך /plugin install cloudflare@cloudflare. [14][13]
הוסיפו ל-~/.cursor/mcp.json עבור כל הפרויקטים, או ל-.cursor/mcp.json בתוך פרויקט אחד:
{
"mcpServers": {
"cloudflare-docs": {
"url": "https://docs.mcp.cloudflare.com/mcp"
}
}
}מפתח ה-url הוא מה שמסמן את הרשומה כמרוחקת, ולכן אין פקודה להריץ ואין מה להתקין. השרת הזה לא צריך בלוק headers, כי הוא מקבל קריאות אנונימיות. שרתי החשבון כן צריכים אחד, ושם היה נכנס טוקן ה-API של Cloudflare. Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. [16][11]
בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. הטופס כבר נפתח במצב URL (SSE/HTTP), וזה המצב שהשרת הזה צריך:
Name Cloudflare Docs Server URL https://docs.mcp.cloudflare.com/mcp Bearer token (leave empty)
אל תיגעו במתג Command (stdio): השרת הזה הוא כתובת אינטרנט, לא פקודה. שדה ה-Bearer token נשאר ריק עבור שרת התיעוד, וזה השדה שבו הייתם ממלאים טוקן API של Cloudflare אילו הייתם מחברים אחד משרתי החשבון. לחצו קודם על Test Connection, שפותח את החיבור ומדווח את מספר הכלים בלי לשמור כלום. [17][11]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם, והשרת הזה הוא העדין ביותר במדריך: אין חשבון לפתוח ואין טוקן להעתיק. Routines היא אפליקציית Mac שמחברת בשבילכם שרתי MCP: מדביקים כתובת אחת פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
03
הטופס כבר נפתח במצב URL, וזה מה ששרת מתארח צריך, לכן אל תיגעו במתג Command (stdio). Name: Cloudflare Docs. Server URL: https://docs.mcp.cloudflare.com/mcp. בלי לוכסן בסוף: בדקנו אחד כזה ונקודת הקצה החזירה 404.
04
שדה ה-Bearer token נשאר ריק. שרת התיעוד מקבל קריאות אנונימיות, ולכן הוא השרת היחיד של Cloudflare שאפשר לחבר בלי חשבון Cloudflare בכלל.
05
לחצו Test Connection: Routines פותחת את החיבור ומדווחת כמה כלים היא מצאה, שניים עבור השרת הזה. אחר כך לחצו Add Server.
06
הכלים עובדים בצ׳אט מיד, כך שאפשר לשאול שאלה על Cloudflare ולקבל תשובה עם קישורים לעמודי התיעוד המדויקים. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.
רעיונות לשגרות
אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.
Every Monday at 9:00, search the Cloudflare documentation for the current limits, quotas and pricing notes on Workers, KV, R2 and D1, and save what you find as cloudflare-limits.md with a link to each documentation page you used.
Every Friday at 15:00, read the questions I wrote into cloudflare-questions.md this week, look each one up in the Cloudflare documentation, and write the answers with a source link per answer into cloudflare-answers.md.
On the first Tuesday of each month at 10:00, search the Cloudflare documentation for the current recommended way to cache and purge assets, compare it against my cdn-setup.md notes, and list anything that no longer matches so I can fix the notes.
פתרון תקלות
שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.
מה רואים
{"jsonrpc":"2.0","id":4,"error":{"code":-32602,"message":"Tool search_docs not found"}}הפתרון
אין search_docs בשרת הזה. כלי התיעוד נקרא search_cloudflare_documentation, והכלי היחיד הנוסף הוא migrate_pages_to_workers_guide. כשאתם רואים את זה, ציינו את שם הכלי בבקשה שלכם במקום לתאר אותו, והמודל מפסיק לנחש.
מה רואים
Input validation error: Invalid arguments for tool search_cloudflare_documentation: query: Invalid input: expected string, received undefined
הפתרון
הכלי מקבל ארגומנט אחד בדיוק, query, והוא חובה. יצרנו את השגיאה הזו בקריאה עם אובייקט ארגומנטים ריק. בדרך כלל זה קורה כשהבקשה מבקשת מהעוזר לחפש ב-Cloudflare בלי לומר מה, לכן כתבו את השאלה עצמה בבקשה: בקשו את הגדרות ה-cache TTL, לא חיפוש ב-Cloudflare.
מה רואים
404 Not Found Not Found
הפתרון
זה מה שמקבלים מלוכסן בסוף: הכתובת https://docs.mcp.cloudflare.com/mcp עובדת ו-https://docs.mcp.cloudflare.com/mcp/ לא. הכתובת הנוספת שעובדת היא הנתיב הישן /sse על אותו שרת, ש-Cloudflare משאירה ככינוי פשוט לאותו מטפל ולא כתעבורה נפרדת, ואישרנו שהוא עונה לאותה לחיצת יד. העתיקו את הכתובת בלי הלוכסן בסוף ובדקו שוב.
מה רואים
401 Unauthorized
www-authenticate: Bearer realm="OAuth", resource_metadata="https://bindings.mcp.cloudflare.com/.well-known/oauth-protected-resource/mcp", error="invalid_token", error_description="Missing or invalid access token"
{"error":"invalid_token","error_description":"Missing or invalid access token"}הפתרון
כיוונו לחיצת יד אנונימית ל-bindings.mcp.cloudflare.com כדי ללכוד את זה. כל שרת של Cloudflare חוץ משרת התיעוד חסום: הלקוח שלכם צריך להשלים התחברות OAuth ל-Cloudflare, שמתבצעת בדפדפן, או לשלוח טוקן API של Cloudflare ככותרת bearer, וזה המסלול ש-Cloudflare מתעדת לאוטומציה. הכתובת ב-resource_metadata שבתשובה היא הרשומה שלקוחות שתומכים ב-OAuth קוראים כדי להתחיל את ההתחברות.
הפתרון
זה נוגע רק למסלול ה-mcp-remote, זה שלקוחות ותיקים משתמשים בו כדי להגיע לשרת מתארח. הפקודה npx שייכת ל-Node.js, ולכן אם Node לא מותקן על ה-Mac הלקוח נכשל בשלב ההפעלה עוד לפני שיוצר קשר עם משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב. לקוחות שמדברים HTTP מרוחק באופן טבעי, ביניהם Claude Code, Cursor ו-Routines, מדלגים על הגשר ומדלגים על הבעיה הזו.
שאלות נפוצות
זו משפחה ולא דבר אחד. Cloudflare מפעילה שבעה עשר שרתי Model Context Protocol משלה, כולם מתארחים אצל Cloudflare ונגישים על גבי HTTPS. שישה עשר הם שרתי תחום, אחד לכל אזור: Workers bindings, observability, Radar, browser rendering, AI Gateway, לוגים, ניתוח DNS, CASB והשאר. השבעה עשר, שרת ה-Code Mode בכתובת mcp.cloudflare.com, מגיע ל-API הרחב של Cloudflare. זה שאימתנו בעמוד הזה הוא שרת התיעוד בכתובת docs.mcp.cloudflare.com, שמחפש בתיעוד למפתחים של Cloudflare ואינו מבקש שום אישור גישה. [11][3][2]
שרת התיעוד ענה ל-tools/list עם 2 כלים ביום הריצה הזו: search_cloudflare_documentation, שמקבל מחרוזת query אחת ומחזיר קטעים מתאימים מהתיעוד למפתחים יחד עם כתובות העמודים, ו-migrate_pages_to_workers_guide, שאינו מקבל ארגומנטים ומחזיר את מדריך המעבר מ-Pages ל-Workers. הטבלה למעלה היא התשובה הזו, מילה במילה. לכל אחד משרתי החשבון יש סט משלו, שנחשף רק אחרי התחברות ל-Cloudflare. [11]
שרת התיעוד לא. Cloudflare כותבת במפורש שהשרת הזה אינו דורש אימות, והריצה שלנו היא ההוכחה: קראנו לו בלי שום כותרת והוא ענה. כל שאר השרתים במשפחה כן דורשים, או התחברות OAuth ל-Cloudflare בדפדפן בשימוש הראשון, או טוקן API של Cloudflare שנשלח ככותרת bearer עבור הגדרות אוטומטיות. לכדנו את הסירוב המדויק שאחד מהם נותן ללקוח אנונימי, והוא מודפס בקטע פתרון התקלות למעלה. [4][11]
לגבי שרת התיעוד התשובה פשוטה במיוחד: הוא קורא רק תיעוד ציבורי של Cloudflare, שני הכלים שלו מסומנים על ידי השרת עצמו כקריאה בלבד, והוא לא מחזיק שום דבר שלכם כי לא נתתם לו כלום. הזהירות שייכת לשאר המשפחה. ברגע שאתם מאשרים שרת חשבון, הכלים שלו פועלים על חשבון ה-Cloudflare האמיתי שלכם, ושרת ה-Workers bindings קיים בדיוק כדי לנהל אחסון ומשאבי הרצה. תנו להם את ההרשאות הצרות ביותר שאפשר, ובדקו מה כלי עושה לפני שאתם נותנים לשגרה מתוזמנת לקרוא לו. [4][11]
לא, והתנגשות השמות באמת מבלבלת. חבילת ה-npm הזו נעצרת בגרסה 0.2.0 שפורסמה במרץ 2025, והיא השרת המקומי הישן שהרצתם על המחשב שלכם אחרי npx wrangler login. npm אינו מסמן אותה כמיושנת והיא עדיין נמשכת עשרות אלפי פעמים בשבוע, ככל הנראה ממדריכים שנכתבו לפני ש-Cloudflare עברה למשפחה המתארחת. המאגר הנוכחי נושא את אותו שם חבילה בפנים, בגרסה 1.0.0 ומסומן כפרטי, ולכן הוא לעולם אינו מפורסם. כוונו את הלקוח שלכם לכתובת mcp.cloudflare.com במקום להתקין משהו. [8][9][7][11]
שני המספרים אמיתיים ולכדנו את שניהם. שרת התיעוד הוא Cloudflare Worker ולא חבילת npm, ולכן מספר הגרסה היחיד בקוד המקור הוא זה שב-package.json שלו, כרגע 0.4.11. על גבי MCP, נקודת הקצה שמופעלת בפועל הציגה את עצמה כ-docs-ai-search 0.4.10. הפער הוא פשוט הקומיט החדש ביותר שעדיין לא באוויר, וזה סוג הדבר שמבחינים בו רק כשמדברים עם השרת במקום לקרוא את המאגר שלו. [5][6]
כל לקוח MCP שמסוגל לדבר עם שרת HTTP מרוחק: Claude Code, Cursor ו-Routines מתחברים ישירות לכתובת, ו-Claude Desktop מתחבר או כמחבר מותאם או דרך גשר ה-npx mcp-remote, שאותו בדקנו. ההגדרה המדויקת לכל אחד נמצאת למעלה. Cloudflare מפרסמת גם תוסף ל-Claude Code שמוסיף את כל משפחת השרתים שלה בצעד אחד. [14][16][15][17][13]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
4,019 stars, Apache-2.0, last push 2026-07-30, not archived, owner cloudflare, at access time.
[2]
The separate Code Mode server behind mcp.cloudflare.com: 692 stars, Apache-2.0, last push 2026-07-31, not archived.
[3]
The table of sixteen domain servers with their addresses, and the note that /sse is kept as a URL alias for the same stateless handler rather than the old SSE transport.
[4]
States verbatim: "This public documentation server does not require authentication." Names the single search tool and the https://docs.mcp.cloudflare.com/mcp address.
[5]
Name docs-ai-search, version 0.4.11, private true: never published to npm.
[6]
The 0.4.10 entry records the move to a stateless SDK and keeping /sse as a URL alias only.
[7]
Name @cloudflare/mcp-server-cloudflare, version 1.0.0, private true, Apache-2.0: the same name as the old published npm artifact, which is where the confusion comes from.
[8]
Latest version 0.2.0, published 2025-03-14, not flagged deprecated: the old local server that required npx wrangler login.
[9]
55,812 downloads for the week ending 2026-08-01, on a package whose last release is dated 2025-03-14.
[10]
Latest version 0.1.38, published 2026-02-05. The bridge that lets a stdio-only client reach a hosted server.
[11]
The full list of endpoints, the OAuth-on-connect statement, and the Cloudflare API token as a bearer header for automated setups.
[12]
Shows the Claude Desktop JSON that runs npx mcp-remote against a hosted address.
[13]
The server table including the documentation address, and the /plugin marketplace add cloudflare/skills install path.
[14]
The claude mcp add --transport http syntax, and the rule that an .mcp.json entry with a url needs a type field.
[15]
Settings, then Connectors, then Add custom connector: the no-JSON path for a hosted server.
[16]
The mcp.json shape for a remote server, a url key with an optional headers object, and the file locations.
[17]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את Cloudflare כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מחברת שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שהיא כותבת נשארים קובצי markdown על ה-Mac שלכם, ואין חשבון ענן לשלם. להורדת Routines