English Français العربية

Confluence Cloud

السجل الرسمي أخرى

MCP server for Confluence Cloud — page editing, navigation, and content management

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @aaronsb/confluence-cloud-mcp
Claude Code 
claude mcp add confluence-cloud -e 'CONFLUENCE_API_TOKEN=<your confluence_api_token>' -e 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' -e 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' -- npx -y @aaronsb/confluence-cloud-mcp@0.6.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "confluence-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/confluence-cloud-mcp@0.6.0"
            ],
            "env": {
                "CONFLUENCE_API_TOKEN": "<your confluence_api_token>",
                "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
                "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
            }
        }
    }
}

متغيرات البيئة

  • CONFLUENCE_API_TOKEN إلزامي سري Confluence API token (generate at https://id.atlassian.com/manage/api-tokens)
  • CONFLUENCE_EMAIL إلزامي Atlassian account email address
  • CONFLUENCE_HOST إلزامي Confluence instance URL (e.g., https://your-team.atlassian.net)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Confluence Cloud MCP Server
  2. Install
  3. Tools
  4. Key Features
  5. MCP Resources
  6. Architecture
  7. License

Confluence Cloud MCP Server

A Model Context Protocol server for interacting with Confluence Cloud. Structured page editing with session-based change tracking, native macro support, and graph-based navigation.

Install

Claude Desktop (one-click)

Download confluence-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Confluence credentials.

Claude Code
claude mcp add confluence-cloud -e CONFLUENCE_API_TOKEN=your-token -e CONFLUENCE_EMAIL=your-email -e CONFLUENCE_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/confluence-cloud-mcp
Manual (any MCP client)
{
  "mcpServers": {
    "confluence-cloud": {
      "command": "npx",
      "args": ["-y", "@aaronsb/confluence-cloud-mcp"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_EMAIL": "your-email",
        "CONFLUENCE_HOST": "https://your-team.atlassian.net"
      }
    }
  }
}
Credentials

Generate an API token at Atlassian Account Settings.

Tools

ToolDescription
manage_confluence_pageGet, create, update, delete, move, copy, or pull pages for editing
edit_confluence_contentStructural block editing within a tracked session — patch sections, append, replace, find/replace, sync
manage_confluence_spaceList spaces, get space details, or manage space configuration
search_confluenceSearch using CQL, full-text, labels, or contributors
manage_confluence_mediaUpload, download, list, or delete page attachments
navigate_confluenceTraverse page hierarchy, discover backlinks (via GraphQL), forward links, and related pages
queue_confluence_operationsBatch multiple operations with result references ($0.pageId) and error strategies

Each tool accepts an operation parameter (except queue_confluence_operations which takes an operations array). Per-tool documentation is available as MCP resources at confluence://tools/{tool_name}/documentation.

Key Features

Session-based editing — Pull a page into a tracked session, make surgical edits to individual blocks (sections, paragraphs, macros, tables), then sync only what changed. No full-page rewrites.

Native macro support — Status badges, info/warning/error panels, expand blocks, and table of contents render as readable :::directive syntax. The server handles ADF serialization with correct native node types.

GraphQL navigation — Backlinks and forward links use the Atlassian GraphQL gateway's link graph for accurate, fast relationship discovery. Falls back to REST when GraphQL is unavailable.

Rendering facades — Every response is token-efficient markdown with context-aware next-step hints. No raw JSON.

MCP Resources

ResourceDescription
confluence://macrosAvailable macro registry with parameter schemas and usage examples

Architecture

See docs/architecture/INDEX.md for the 8 ADRs covering the five-layer architecture, hybrid client, content model, session editing, macro handling, navigation, and rendering facades.

License

MIT License

الأسئلة الشائعة

ما هو Confluence Cloud؟

MCP server for Confluence Cloud — page editing, navigation, and content management

كيف أثبّت Confluence Cloud؟

يعمل على جهازك. في Claude Code: claude mcp add confluence-cloud -e 'CONFLUENCE_API_TOKEN=<your confluence_api_token>' -e 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' -e 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' -- npx -y @aaronsb/confluence-cloud-mcp@0.6.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Confluence Cloud إلى مفتاح API؟

نعم. يتطلب CONFLUENCE_API_TOKEN, CONFLUENCE_EMAIL, CONFLUENCE_HOST، وتضبطها في إعداداته.

هل Confluence Cloud مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Confluence Cloud؟

ينشره aaronsb. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.