שרת MCP מאומת: Confluence

שרת ה-MCP ל-Confluence, הכלים שלו נספרו בריצה חיה על Mac אמיתי.

הכלים נספרו2026-08-03macOS 15.7.7
חבילהmcp-atlassian 0.23.0
מדווח על עצמוAtlassian MCP 3.4.5
פרוטוקול MCP2025-06-18
סביבת ריצהPython 3.13 (uvx 0.10.2)

רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.

התשובה הקצרה

אומת לאחרונה 2026-08-03

שרת ה-MCP ל-Confluence מאפשר לעוזר AI לחפש ב-wiki שלכם ולקרוא דפים, עצי דפים, תגובות, קבצים מצורפים והרשאות, מתוך חלון צ׳אט או משגרה מתוזמנת. הוא חצי אחד של mcp-atlassian, חבילה קהילתית שמכסה את Confluence ואת Jira מאותה פקודה ורצה על ה-Mac שלכם מול טוקן API של Atlassian, והוא אינו אותו מוצר כמו Rovo MCP Server המתארח של Atlassian עצמה, שאליו הלקוח שלכם מגיע דרך הרשת אחרי התחברות ל-Atlassian. הרצנו את הקהילתי כשמתג הקריאה בלבד שלו דלוק, דיברנו איתו בפרוטוקול וספרנו כל כלי שההגדרה שבעמוד הזה חושפת: הטבלה למטה היא הלכידה הזו, מילה במילה. מה שלא יכולנו לעשות הוא להשלים קריאה מאומתת. לשם כך דרוש טוקן לאתר Confluence אמיתי, ולכן הקריאה היחידה שביצענו חזרה עם 404 מכתובת הדמה שאליה הפנינו אותה, המודפסת במלואה בהמשך, וכאן העמוד עוצר. פרט אחד שווה לתפוס לפני שמתחילים, כי הוא עולה לאנשים ערב שלם: הכתובת שאתם מדביקים מסתיימת ב-/wiki, וזו של Jira לא. [1][3][8][5]

כלים
20, נספרו בריצה חיה
אישורי גישה
נדרש טוקן API של Atlassian [9]
ערוץ תקשורת
stdio, רץ על ה-Mac שלכם [5]
מתחזק
sooperset, פרויקט קהילתי [1][3]
הורדות
358 אלף בשבוע האחרון [2]
רישיון
MIT [4]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם uvx על גבי stdio מול כתובת Confluence של דמה, עם ערכי דמה ב-CONFLUENCE_URL, ב-CONFLUENCE_USERNAME וב-CONFLUENCE_API_TOKEN וכאשר READ_ONLY_MODE מוגדר ל-true, השלמנו את לחיצת היד של MCP וקראנו ל-tools/list: 20 הכלים שלמטה הם התשובה הזו, מילה במילה. אחר כך ביצענו קריאת כלי אמיתית אחת, confluence_search, והיא נכשלה, כפי שהיה חייב לקרות. הקטע המודפס לצדה הוא מה שחזר, שגיאת 404 מכתובת הדמה, שהיא שגיאת הגדרה ואימות ולא תוצאה מ-Confluence. קריאה מאומתת כאן עדיין ממתינה לטוקן API של Atlassian לאתר wiki אמיתי, שאין לנו, ולכן שום דבר בעמוד הזה אינו טוען לקריאה מוצלחת מ-Confluence. ארבע ריצות נוספות של אותה חבילה על אותו Mac באותו יום הפיקו את שאר השגיאות המצוטטות למטה: אחת בלי אף משתנה של Atlassian, אחת עם כתובת פגומה, אחת שקראה לשם כלי שאינו קיים ואחת ששלחה ארגומנטים שהכלים דוחים. דבר אחד שכדאי לצפות לו בבאנר שלמטה: חותמות הזמן שבו מציגות ‎08/04/26 כי הריצה חצתה את חצות המקומית, בעוד שהלכידה מתוארכת ל-2026-08-03 יחד עם שאר האצווה.

הודעת הפתיחה של השרת

╭──────────────────────────────────────────────────────────────────────────────╮
│                                                                              │
│                                                                              │
│                         ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█                        │
│                         █▀  █▀█ ▄▄█  █  █ ▀ █ █▄▄ █▀▀                        │
│                                                                              │
│                                                                              │
│                                                                              │
│                                FastMCP 3.4.5                                 │
│                            https://gofastmcp.com                             │
│                                                                              │
│                  🖥  Server:      Atlassian MCP, 3.4.5                        │
│                  🚀 Deploy free: https://horizon.prefect.io                  │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯


WARNING - mcp_atlassian.utils.toolsets - TOOLSETS is not set — currently defaults to all toolsets. In v0.22.0, the default will change to 6 core toolsets only. Set TOOLSETS=all explicitly to preserve current behavior.
[08/04/26 00:08:49] INFO     Starting MCP server 'Atlassian     transport.py:241
                             MCP' with transport 'stdio'

קריאת כלי אמיתית אחת

tools/call confluence_search {"query": "siteSearch ~ \"onboarding\"", "limit": 3}

Error calling tool 'search': 404 Client Error: Not Found for url: https://example.atlassian.net/wiki/rest/api/search?start=0&limit=3&cql=siteSearch+~+%22onboarding%22&expand=content.history,content.version

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 20 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

כלי	מה הוא עושה
confluence_searchquery*limitspaces_filter	Search Confluence content using simple terms or CQL.
confluence_get_pagepage_idtitlespace_keyinclude_metadataconvert_to_markdown	Get content of a specific Confluence page by its ID, or by its title and space key.
confluence_get_page_childrenparent_id*expandlimitinclude_contentconvert_to_markdownstartinclude_folders	Get child pages and folders of a specific Confluence page.
confluence_get_space_page_treespace_key*limit	Get page hierarchy for a Confluence space as a flat list. Returns pages with parent_id and depth attributes for token-efficient processing. Filter by depth to focus on relevant sections, or find pages by title. Much more efficient than rendering full ASCII trees. Use this to understand space organization before creating/moving pages.
confluence_get_commentspage_id*	Get comments for a specific Confluence page.
confluence_get_labelspage_id*	Get labels for Confluence content (pages, blog posts, or attachments).
confluence_get_inline_commentspage_id*	Get all inline comments for a Confluence page.
confluence_search_userquery*limitgroup_name	Search Confluence users using CQL (Cloud) or group member API (Server/DC).
confluence_get_page_historypage_idversionconvert_to_markdown	Get a historical version of a specific Confluence page.
confluence_get_page_diffpage_idfrom_versionto_version*	Get a unified diff between two versions of a Confluence page.
confluence_get_page_viewspage_id*include_title	Get view statistics for a Confluence page. Note: This tool is only available for Confluence Cloud. Server/Data Center instances do not support the Analytics API.
confluence_get_attachmentscontent_id*startlimitfilenamemedia_type	List all attachments for a Confluence content item (page or blog post). Returns metadata about attachments including: - Attachment ID, title, and file type - File size and download URL - Creation/modification dates - Version information Important: Confluence API returns 'application/octet-stream' as the media type for most binary files (PNG, JPG, PDF) instead of specific types like 'image/png'. For filtering by file type, using the 'filename' parameter is more reliable (e.g., filename='*.png' pattern matching if supported, or exact filename). Useful for: - Discovering what files are attached to a page - Getting attachment IDs for download operations - Checking if a specific file exists - Listing images/documents for processing
confluence_download_attachmentattachment_id*	Download an attachment from Confluence as an embedded resource. Returns the attachment content as a base64-encoded embedded resource so that it is available over the MCP protocol without requiring filesystem access on the server. Files larger than 50 MB are not downloaded inline; a descriptive error message is returned instead.
confluence_download_content_attachmentscontent_id*	Download all attachments for a Confluence content item as embedded resources. Returns attachment contents as base64-encoded embedded resources so that they are available over the MCP protocol without requiring filesystem access on the server. Files larger than 50 MB are skipped with an error entry in the summary.
confluence_get_page_imagescontent_id*	Get all images attached to a Confluence page as inline image content. Filters attachments to images only (PNG, JPEG, GIF, WebP, SVG, BMP) and returns them as base64-encoded ImageContent that clients can render directly. Non-image attachments are excluded. Files with ambiguous MIME types (application/octet-stream) are detected by filename extension as a fallback. Images larger than 50 MB are skipped with an error entry in the summary.
confluence_list_page_templatesspace_keylimit	List Confluence page content templates. This operation is only available for Confluence Cloud. Returns template metadata (ID, name, description, type) without the full body. Use confluence_get_page_template to fetch a template's body.
confluence_get_page_templatetemplate_id*	Get a Cloud page template by ID, including its storage-format body.
confluence_get_page_restrictionspage_id*	Get view and edit restrictions for a Confluence page. Returns the current restriction lists for the read (view) and update (edit) operations. An empty list means the page is unrestricted for that operation.
confluence_check_content_permissionscontent_iduser_identifieroperation*subject_type	Check whether a user or group can perform an operation on specific content. Wraps POST /wiki/rest/api/content/{id}/permission/check. Note: This tool is only available for Confluence Cloud. Server/Data Center instances use different permission APIs. Returns a JSON object with a 'hasPermission' boolean indicating whether the subject has the requested permission on the content.
confluence_get_space_permissionsspace_id*limitcursor	List all permission assignments for a Confluence space. Wraps GET /wiki/api/v2/spaces/{id}/permissions. Note: This tool is only available for Confluence Cloud. Server/Data Center instances use different permission APIs. Returns a JSON object with a 'results' list of permission assignment objects. Each entry contains the principal (user or group), the operation permitted, and the target. Use this to audit who has access to a space.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

Claude Desktop

פתחו את הקובץ ‎~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:

{
  "mcpServers": {
    "confluence": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@your-company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

השאירו את ‎/wiki בסוף הכתובת, מלאו את כתובת המייל שאיתה אתם מתחברים וטוקן מ-id.atlassian.com, ואז סגרו ופתחו מחדש את Claude Desktop. READ_ONLY_MODE הוא המתג שהפיק את 20 הכלים שבעמוד הזה: הסירו אותו ואותו שרת יחשוף גם את הכלים שיוצרים, עורכים ומוחקים דפים. אם Claude Desktop לא מוצא את uvx, כתבו במקום זאת את הנתיב המלא: הריצו ‎which uvx בטרמינל כדי לראות את שלכם, והוא ‎/Users/yourname/.local/bin/uvx אם התקנתם את uv עם המתקין של astral.sh, ומקום אחר אם התקנתם אותו עם Homebrew. [10][5][6][13]

Claude Code

פקודה אחת בטרמינל:

claude mcp add confluence -e CONFLUENCE_URL=https://your-company.atlassian.net/wiki -e CONFLUENCE_USERNAME=you@your-company.com -e CONFLUENCE_API_TOKEN=your_api_token -e READ_ONLY_MODE=true -- uvx mcp-atlassian

כל ‎-e מגדיר משתנה סביבה אחד, וכל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ. הטוקן שלכם נשמר בהיסטוריית הפקודות, ולכן אם זה מפריע לכם הדביקו אותו בחלון טרמינל חדש. [11]

Cursor

הוסיפו ל-‎~/.cursor/mcp.json עבור כל הפרויקטים, או ל-‎.cursor/mcp.json בתוך פרויקט אחד:

{
  "mcpServers": {
    "confluence": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@your-company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "READ_ONLY_MODE": "true"
      }
    }
  }
}

Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. קובץ ‎.cursor/mcp.json ברמת הפרויקט שווה להעלות ל-git רק אחרי שהוצאתם ממנו את הטוקן. [12]

Routines

בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:

Name        Confluence
Command     uvx
Arguments   mcp-atlassian

Environment Variables
CONFLUENCE_URL=https://your-company.atlassian.net/wiki
CONFLUENCE_USERNAME=you@your-company.com
CONFLUENCE_API_TOKEN=your_api_token
READ_ONLY_MODE=true

כל ארבעת הערכים שייכים לשדה Environment Variables, אחד בכל שורה, ולא לשדה Arguments. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו, עשרים בהגדרה הזו. אם הוא עונה אפס, המשתנים לא הגיעו אליו. [14]

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Confluence בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם, עם עקיפה אחת בלתי נמנעת: השרת הזה צריך טוקן API של Atlassian, ולכן השלב השני הוא להשיג אחד. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים את השדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

01
התקינו את Routines
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
צרו טוקן API של Atlassian
היכנסו ל-id.atlassian.com, פתחו את Security, אחר כך API tokens, וצרו טוקן. שמרו אותו במקום בטוח: Atlassian מציגה אותו פעם אחת בלבד. זהו אותו עמוד טוקנים ש-Jira משתמשת בו, כך שטוקן שכבר יצרתם מתאים גם כאן. תצטרכו גם את כתובת המייל שאיתה אתם מתחברים.
03
מצאו את כתובת ה-wiki שלכם
פתחו את Confluence בדפדפן והסתכלו בשורת הכתובת: החלק שאתם צריכים הוא הקידומת ‎https://something.atlassian.net/wiki, עם ‎/wiki בסוף. ה-‎/wiki הזה בסוף הוא הדבר הכי נפוץ שאנשים מפספסים כאן, כי בכתובת של Jira הוא לא קיים.
04
פתחו את הגדרות ה-MCP ובחרו Command (stdio)‎
לחצו על החשבון שלכם בתחתית סרגל הצד, בחרו Settings, פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server. העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שרצה על ה-Mac שלכם, לא כתובת אינטרנט. קראו לו Confluence. Command: uvx. Arguments: mcp-atlassian.
05
הדביקו את משתני הסביבה
בשדה Environment Variables הזינו אחד בכל שורה: ‎CONFLUENCE_URL=https://your-company.atlassian.net/wiki, אחר כך ‎CONFLUENCE_USERNAME=you@your-company.com, אחר כך ‎CONFLUENCE_API_TOKEN=‎ ואחריו הטוקן שהעתקתם, ואחר כך ‎READ_ONLY_MODE=true. בלי שלושת הראשונים השרת עולה בלי אף כלי. הרביעי הוא זה שמשאיר את החיבור הזה בקריאה בלבד, וזו ההגדרה שאימתנו.
06
בדקו, ואז הוסיפו והשתמשו
לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, עשרים בהגדרה הזו. אחר כך לחצו Add Server. הכלים עובדים בצ׳אט מיד; כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

תקציר wiki של יום שני

פרומפט

Every Monday at 8:30, search Confluence for pages in our team space that changed in the last seven days, and write a short summary of what changed and who changed it to wiki-digest.md.

סריקת מסמכים מיושנים

פרומפט

Every Friday at 15:00, walk the page tree of our Handbook space in Confluence, list the pages nobody has edited in 90 days with a one-line note on what each one covers, and save the list as stale-docs.md.

שומר שינויים לדף ה-Runbook

פרומפט

Every weekday at 8:00, check our Runbook page in Confluence for a new version since yesterday, and if there is one, summarize what changed in three bullets and save it as runbook-changes.md.

איך שגרות עובדות להורדת Routines ל-Mac

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

Test Connection מצליח אבל מדווח על אפס כלים

מה רואים

{"jsonrpc":"2.0","id":2,"result":{"tools":[]}}

הפתרון

השרת עולה בשמחה גם בלי שום אישור גישה של Atlassian, ואז אינו חושף דבר, ולכן זה נראה כמו חיבור תקין עם שרת שבור. שחזרנו את זה כשהפעלנו אותו אחרי שהסרנו כל משתנה של Confluence ושל Jira: לחיצת היד הושלמה, הבאנר הודפס כרגיל, ו-tools/list חזר עם הרשימה הריקה שלמעלה. בדקו ש-CONFLUENCE_URL, CONFLUENCE_USERNAME ו-CONFLUENCE_API_TOKEN באמת הגיעו לתהליך. בלקוח מבוסס טופס זה אומר שדה Environment Variables, לא הארגומנטים.

כל חיפוש חוזר עם 404

מה רואים

Error calling tool 'search': 404 Client Error: Not Found for url: https://example.atlassian.net/wiki/rest/api/search?start=0&limit=3&cql=siteSearch+~+%22onboarding%22&expand=content.history,content.version

הפתרון

הכלים קיימים, הקריאה יוצאת, והכתובת עונה 404. גרמנו לזה בכוונה כשהפנינו את CONFLUENCE_URL אל ‎https://example.atlassian.net/wiki, שאינה wiki אמיתי. שימו לב מה ההודעה נותנת לכם בחינם: הכתובת המלאה שהשרת בנה, כך שאפשר לראות בדיוק באיזו כתובת הוא השתמש. בדקו אותה קודם. הטעות הרווחת היא להדביק את הכתובת של Jira, שאין לה ‎/wiki בסוף, ואותו 404 מכסה גם מייל שגוי או טוקן עם שגיאת הקלדה. גם אל תקראו הפעלה נקייה כהוכחה שהכתובת נכונה: הפעלנו את השרת פעם אחת כש-CONFLUENCE_URL מוגדר ל-not-a-valid-url ולחיצת היד עדיין הושלמה, כי הכתובת נבדקת רק כשיוצאת הבקשה הראשונה.

קריאת כלי נדחית עוד לפני שהיא עוזבת את ה-Mac

מה רואים

1 validation error for call[search]
query
  Missing required argument [type=missing_argument, input_value={}, input_type=dict]
    For further information visit https://errors.pydantic.dev/2.13/v/missing_argument

הפתרון

הקריאה הזו מעולם לא הגיעה ל-Atlassian. השרת בודק קודם את הארגומנטים, ו-confluence_search בלי query נדחה במקום. שליחת limit כמילה three במקום כמספר מקבלת אותו יחס, עם שורה על כך שאי אפשר לפרש את המחרוזת כמספר שלם במקום שורת הארגומנט החסר. כדאי לזהות את הכשל הזה, כי הוא אומר שהחיבור עצמו תקין: העוזר פשוט קרא לכלי לא נכון, ובקשה לנסות שוב עם הערך החסר בדרך כלל פותרת את זה.

בקשה לדף לפי שם בלבד נדחית

מה רואים

Error calling tool 'get_page': Either 'page_id' OR both 'title' and 'space_key' must be provided.

הפתרון

הכלי confluence_get_page מקבל או מזהה דף, או כותרת יחד עם מפתח המרחב שלה, ומסרב לפחות מזה. אנשים נתקלים בזה כשהם מבקשים דף לפי שם, כי כותרת אינה ייחודית בין מרחבים. בקשו מהעוזר להריץ קודם confluence_search ולקחת את המזהה מהתוצאה, או ספקו את מפתח המרחב לצד הכותרת המדויקת.

שם כלי כמעט נכון לא עושה כלום

מה רואים

Unknown tool: confluence_serach_pages

הפתרון

ביקשנו את confluence_serach_pages, כולל שגיאת ההקלדה, והשורה האחת הזו היא כל התשובה. שני דברים כדאי לקחת מכאן. עוזרי AI ממציאים שמות כלים שנשמעים סבירים, ולכן שגרה שנכשלת ככה בדרך כלל קוראת למשהו שמעולם לא היה קיים ולא למשהו שהתקלקל. והתשובה מגיעה כתוצאה רגילה ולא כשגיאת פרוטוקול, כך שעוזר עלול לקרוא מעליה ולהמשיך: עשרים השמות שבטבלה למעלה הם כל אוצר המילים של החיבור הזה.

לקוח ה-MCP לא מצליח להפעיל את השרת בכלל

הפתרון

הפקודה uvx שייכת ל-uv, מריץ החבילות של Python, והשרת הזה כתוב ב-Python. אם uv לא מותקן, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו: התקינו אותו מ-astral.sh/uv והפעילו מחדש את הלקוח. יש גרסה שנייה לאותו כשל: התיקייה שאליה uv הותקן לרוב אינה נמצאת ב-PATH של אפליקציה שנפתחת מה-Dock, ולכן לקוח שעובד בטרמינל עדיין יכול להיכשל בחלון. הריצו ‎which uvx בטרמינל כדי לראות היכן הוא אצלכם, ‎/Users/yourname/.local/bin/uvx אם השתמשתם במתקין של astral.sh ומקום אחר אם התקנתם את uv עם Homebrew, והדביקו את הנתיב המלא הזה כפקודה.

שאלות נפוצות

שאלות שאנשים שואלים.

מה זה שרת ה-MCP ל-Confluence?

זו תוכנה קטנה שמעבירה לעוזר AI אוסף פעולות של Confluence: לחפש ב-wiki עם CQL, לקרוא דף, לעבור על עץ הדפים של מרחב, ולשלוף תגובות, תוויות, קבצים מצורפים, היסטוריית גרסאות והרשאות. שני שרתים יודעים לעשות את זה, והם אינם אותו מוצר. Atlassian מפעילה שרת משלה, Rovo MCP Server, שאליו הלקוח שלכם מגיע דרך הרשת אחרי התחברות. הקהילתי, mcp-atlassian, רץ כתהליך מקומי על ה-Mac שלכם ומזדהה עם טוקן API של Atlassian. העמוד הזה אימת את הקהילתי, כי הוא זה שעולה בלי חשבון Atlassian להתחבר אליו. אותה חבילה מכסה גם את Jira, שיש לה עמוד משלה במדריך הזה. [8][5]

מה בדיוק אימתנו ומה לא?

הפעלנו את השרת, השלמנו את לחיצת היד של MCP וקראנו את רשימת הכלים ישירות מהחיבור. החלק הזה נמדד, והטבלה למעלה היא התשובה הגולמית. קריאת הכלי האמיתית האחת שביצענו לא הצליחה: confluence_search הגיעה לכתובת הדמה שהגדרנו וחזרה עם 404, שזה מה שהגדרה לא מאומתת או שגויה נראית מבחוץ. כלומר רשימת הכלים היא ראיה, ושום דבר כאן אינו מתאר מה מחזיר חיפוש מוצלח ב-Confluence, כי לא ראינו אחד כזה. כל שגיאה שכן קיבלנו מודפסת במלואה, כולל אלה מארבע ריצות בדיקה נוספות.

אילו כלים כלולים בשרת ה-MCP ל-Confluence?

ההגדרה שבעמוד הזה סופרת 20 כלים, כולם קריאה: דפים וחיפוש (confluence_search, confluence_get_page, confluence_get_page_children, confluence_get_space_page_tree, confluence_get_page_history, confluence_get_page_diff), תגובות ותוויות (confluence_get_comments, confluence_get_inline_comments, confluence_get_labels), אנשים ונתוני צפייה (confluence_search_user, confluence_get_page_views), קבצים מצורפים ותמונות (confluence_get_attachments, confluence_download_attachment, confluence_download_content_attachments, confluence_get_page_images), תבניות (confluence_list_page_templates, confluence_get_page_template) והרשאות (confluence_get_page_restrictions, confluence_check_content_permissions, confluence_get_space_permissions). התיעוד של הפרויקט סופר 35 כלי Confluence בשמונה ערכות כלים, ו-15 מהם שכותבים הם בדיוק אלה שהריצה שלנו במצב קריאה בלבד השאירה בחוץ. 98 הכלים שה-README מפרסם הם Confluence ו-Jira יחד, לא Confluence לבד. [7][5]

הוא יכול ליצור או לערוך דפים ב-Confluence?

החבילה יכולה. ההגדרה שבעמוד הזה לא יכולה, וזה בכוונה. הרצנו אותה עם ‎READ_ONLY_MODE=true, שהתיעוד מתאר כמבטל פעולות כתיבה, ו-20 הכלים שהיא ענתה בהם הם כולם קריאה. הסירו את השורה הזו ואותה פקודה תחשוף גם את הכלים שיוצרים, מעדכנים, מעבירים, משכפלים ומוחקים דפים, מוסיפים תגובות ותוויות ומעלים קבצים מצורפים, ואת אלה לא ספרנו ואיננו יכולים להעיד עליהם כאן. ממילא קריאה בלבד היא הסדר הבטוח יותר: תנו לעוזר לקרוא את ה-wiki שלכם שבוע לפני שאתם נותנים לו לכתוב בו. [6][7]

הוא דורש מפתח API או חשבון?

כן. עבור הגדרת ה-Cloud שבעמוד הזה מדובר בכתובת ה-wiki שלכם שמסתיימת ב-/wiki, במייל שאיתו אתם מתחברים ובטוקן API של Atlassian שנוצר ב-id.atlassian.com תחת Security, אחר כך API tokens. טוקנים שייכים לחשבון ה-Atlassian שלכם ולא למוצר מסוים, ולכן זה שיצרתם ל-Jira עובד גם כאן, והוא מגיע לכל מה שהחשבון שלכם מגיע אליו: דף שהשרת הזה יכול לקרוא הוא דף שיכולתם לפתוח בדפדפן, לא יותר ולא פחות. התייחסו אליו כמו לסיסמה, שמרו אותו בשדה משתני הסביבה ולא בקובץ שנכנס ל-git, והשאירו את ‎READ_ONLY_MODE=true במקומו כדי ששגרה מנוסחת ברישול לא תוכל לשכתב דף. התקנות Server או Data Center משתמשות ב-Personal Access Token במקום, ואותו לא בדקנו. [9][5]

למה PyPI מציג 0.23.0 בזמן שהשרת מדווח 3.4.5?

שני המספרים אמיתיים ולכדנו את שניהם. PyPI מפרסם את mcp-atlassian בגרסה 0.23.0. על גבי MCP התהליך הרץ מדווח על עצמו כ-Atlassian MCP 3.4.5, שזו הגרסה של FastMCP, המסגרת שעליה הוא בנוי: באנר ההפעלה למעלה מדפיס 3.4.5 לצד השם FastMCP. לקרוא את 3.4.5 כמספר הגרסה של שרת ה-Confluence עצמו יהיה שגוי. [1]

צריך את השרת הזה כדי להשתמש ב-Confluence בתוך Routines?

לא. Routines כוללת מחבר Atlassian שמפעילים בהתחברות בלחיצה אחת, והוא מכסה את Confluence וגם את Jira דרך שרת ה-MCP המתארח של Atlassian, כך שאין מה להתקין ואין טוקן להדביק. התקינו את השרת הקהילתי אם אתם רוצים דווקא את מערך הכלים שבעמוד הזה, כולל עצי דפים, השוואות גרסאות, קבצים מצורפים ובדיקות הרשאות, או אם ה-Confluence שלכם הוא מופע Server או Data Center ולא Cloud. [14]

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

[1]
PyPI: mcp-atlassianנקרא בתאריך 2026-08-03
Latest version 0.23.0, uploaded 2026-07-18.
[2]
pypistats API: recent downloadsנקרא בתאריך 2026-08-03
357,922 downloads in the last week, 1,902,768 in the last month.
[3]
GitHub: sooperset/mcp-atlassianנקרא בתאריך 2026-08-03
5,691 stars, not archived, and a push dated 2026-08-02 at access time, per the GitHub API.
[4]
mcp-atlassian LICENSE fileנקרא בתאריך 2026-08-03
MIT, as reported by the GitHub API for the repository.
[5]
mcp-atlassian READMEנקרא בתאריך 2026-08-03
The uvx command shape, the CONFLUENCE_URL value ending in /wiki with CONFLUENCE_USERNAME and CONFLUENCE_API_TOKEN beside it, the API token and Personal Access Token routes, and the count of 98 tools across Jira and Confluence.
[6]
mcp-atlassian docs: Configurationנקרא בתאריך 2026-08-03
The Server Options table lists READ_ONLY_MODE as "Disable write operations (true/false)".
[7]
mcp-atlassian docs: Tools Referenceנקרא בתאריך 2026-08-03
98 tools in total, and 8 Confluence toolsets listing 35 Confluence tools, 15 of which are writes.
[8]
Atlassian: getting started with the Atlassian Rovo MCP Serverנקרא בתאריך 2026-08-03
Atlassian's own hosted server and its current URL, https://mcp.atlassian.com/v1/mcp/authv2.
[9]
Atlassian account: API tokensנקרא בתאריך 2026-08-03
Where an Atlassian API token is created for the community server.
[10]
modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03
The claude_desktop_config.json shape, including the env object.
[11]
Claude Code docs: MCPנקרא בתאריך 2026-08-03
The claude mcp add syntax, including -e for environment variables.
[12]
Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03
The mcp.json shape and file locations.
[13]
Astral docs: installing uvנקרא בתאריך 2026-08-04
The standalone installer puts uv and uvx in ~/.local/bin on macOS; Homebrew is listed as a separate install method, and it put uvx at /usr/local/bin/uvx on the Mac this page was captured on.
[14]
Routines: Connectorsנקרא בתאריך 2026-08-03
The built-in Atlassian connector, which covers Confluence and Jira, and how Routines runs any MCP server.

העמוד הזה מתאר את Confluence כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.

מאחורי המדריך הזה

Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines

שרת ה-MCP ל-Confluence, הכלים שלו נספרו בריצה חיה על Mac אמיתי.

איך שרת ה-MCP הזה אומת.

הכלים, כפי שנספרו מהשרת הרץ.

הגדרות שעובדות, אחת לכל אפליקציה.

Claude Desktop

Claude Code

Cursor

Routines

איך מגדירים את שרת ה-MCP‏ Confluence בלי טרמינל.

התקינו את Routines

צרו טוקן API של Atlassian

מצאו את כתובת ה-wiki שלכם

פתחו את הגדרות ה-MCP ובחרו Command (stdio)‎

הדביקו את משתני הסביבה

בדקו, ואז הוסיפו והשתמשו

שגרות ששווה לתזמן.

תקציר wiki של יום שני

סריקת מסמכים מיושנים

שומר שינויים לדף ה-Runbook

השגיאות שנתקלנו בהן, ומה פתר אותן.

Test Connection מצליח אבל מדווח על אפס כלים

כל חיפוש חוזר עם 404

קריאת כלי נדחית עוד לפני שהיא עוזבת את ה-Mac

בקשה לדף לפי שם בלבד נדחית

שם כלי כמעט נכון לא עושה כלום

לקוח ה-MCP לא מצליח להפעיל את השרת בכלל

שאלות שאנשים שואלים.

מה זה שרת ה-MCP ל-Confluence?

מה בדיוק אימתנו ומה לא?

אילו כלים כלולים בשרת ה-MCP ל-Confluence?

הוא יכול ליצור או לערוך דפים ב-Confluence?

הוא דורש מפתח API או חשבון?

למה PyPI מציג 0.23.0 בזמן שהשרת מדווח 3.4.5?

צריך את השרת הזה כדי להשתמש ב-Confluence בתוך Routines?

כל טענה חיצונית, עם קבלה.