📇 ☁️ - Atlassian Confluence Cloud: work with spaces, pages and content, with automatic ADF-to-Markdown…
Connect AI to Your Confluence Knowledge Base
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Transform how you access and interact with your team's knowledge by connecting Claude, Cursor AI, and other AI assistants directly to your Confluence spaces, pages, and documentation. Get instant answers from your knowledge base, search across all your spaces, and streamline your documentation workflow.
What You Can Do
- **Ask AI about your documentation**: "What's our API authentication process?"
- **Search across all spaces**: "Find all pages about security best practices"
- **Get instant answers**: "Show me the latest release notes from the Product space"
- **Access team knowledge**: "What are our HR policies for remote work?"
- **Review page comments**: "Show me the discussion on the architecture document"
- **Create and update content**: "Create a new page in the DEV space"
Perfect For
- **Developers** who need quick access to technical documentation and API guides
- **Product Managers** searching for requirements, specs, and project updates
- **HR Teams** accessing policy documents and employee resources quickly
- **Support Teams** finding troubleshooting guides and knowledge base articles
- **Anyone** who wants to interact with Confluence using natural language
Quick Start
Get up and running in 2 minutes:
1. Get Your Confluence Credentials
Generate a Confluence API Token:
1. Go to Atlassian API Tokens
2. Click **Create API token**
3. Give it a name like **"AI Assistant"**
4. **Copy the generated token** immediately (you won't see it again!)
2. Try It Instantly
Connect to AI Assistants
For Claude Desktop Users
Add this to your Claude configuration file (~/.claude/claude_desktop_config.json):
Restart Claude Desktop, and you'll see the confluence server in the status bar.
For Other AI Assistants
Most AI assistants support MCP (Cursor AI, Continue.dev, and others). Install the server globally:
Then configure your AI assistant to use the MCP server with STDIO transport. The binary is available as mcp-atlassian-confluence after global installation.
Alternative: Configuration File
Create ~/.mcp/configs.json for system-wide configuration:
**Alternative config keys:** The system also accepts "atlassian-confluence", "@aashari/mcp-server-atlassian-confluence", or "mcp-server-atlassian-confluence" instead of "confluence".
Using Environment Variables
You can also configure credentials using environment variables or a .env file:
bash
GET request
npx -y @aashari/mcp-server-atlassian-confluence get --path "/wiki/api/v2/spaces"
GET with query parameters and JMESPath filter
npx -y @aashari/mcp-server-atlassian-confluence get \
--path "/wiki/api/v2/pages" \
--query-params '{"space-id": "123456", "limit": "10"}' \
--jq "results[*].{id: id, title: title}"
GET with JSON output format
npx -y @aashari/mcp-server-atlassian-confluence get \
--path "/wiki/api/v2/spaces" \
--output-format json
POST request (create a page)
npx -y @aashari/mcp-server-atlassian-confluence post \
--path "/wiki/api/v2/pages" \
--body '{"spaceId": "123456", "status": "current", "title": "New Page", "body": {"representation": "storage", "value": " Content here "}}'
POST request (add a comment)
npx -y @aashari/mcp-server-atlassian-confluence post \
--path "/wiki/api/v2/pages/789/footer-comments" \
--body '{"body": {"representation": "storage", "value": " My comment "}}'
PUT request (update page - requires version increment)
npx -y @aashari/mcp-server-atlassian-confluence put \
--path "/wiki/api/v2/pages/789" \
--body '{"id": "789", "status": "current", "title": "Updated Title", "spaceId": "123456", "body": {"representation": "storage", "value": " Updated content "}, "version": {"number": 2}}'
PATCH request (partial update)