Frequently Asked Questions (FAQ) about Confluence MCP Server

Q: What is the Confluence MCP Server?

A: The Confluence MCP Server is a FastMCP-based server that provides seamless integration with Confluence’s REST API. It enables programmatic access to Confluence spaces, pages, and content search functionality.

Q: What are the key features of the Confluence MCP Server?

A: Key features include Space Management, Page Operations, Search Functionality using CQL, Space Navigation, and secure API token-based authentication.

Q: What are the system requirements for running the Confluence MCP Server?

A: The server requires Python 3.8+, pip, an active Confluence instance with API access, and a valid Confluence API token.

Q: How do I install the Confluence MCP Server?

A: You can install it manually by cloning the repository, setting up a virtual environment, and installing dependencies. Alternatively, you can install it automatically using Smithery.

Q: How do I configure the Confluence MCP Server?

A: Configuration involves creating an environment file (.env), setting environment variables for the Confluence base URL, username, and API token, and obtaining a Confluence API token.

Q: How do I obtain a Confluence API token?

A: Visit Atlassian API Tokens, click “Create API Token”, enter a label, and copy the generated token.

Q: How do I start the Confluence MCP Server?

A: You can start the server by running the command python confluence.py in your terminal.

Q: What API methods are available in the Confluence MCP Server?

A: Available API methods include listing spaces, getting page content, searching content, and listing pages in a space.

Q: How do I integrate the Confluence MCP Server with MCP Clients like Claude Desktop or Cursor?

A: Configure the mcpServers section in the client’s configuration file (e.g., ~/.claude/claude_desktop_config.json or ~/.cursor/mcp.json) with the path to your confluence.py file.

Q: What are common error codes I might encounter?

A: Common error codes include 401 (Invalid API token), 403 (Insufficient permissions), 404 (Resource not found), and 429 (Rate limit exceeded).

Q: What should I do if I encounter connection issues?

A: Verify the CONFLUENCE_BASE_URL format, check network connectivity, and confirm the API token validity.

Q: What should I do if I encounter authentication errors?

A: Ensure the USERNAME matches your Atlassian account email, verify the API_TOKEN is correctly copied, and check for special characters in the .env file.

Q: What should I do if I encounter permission errors?

A: Confirm that your user has the required Confluence permissions and verify space and page access rights.

Q: Where can I get support for the Confluence MCP Server?

A: For issues and feature requests, please create an issue in the repository’s issue tracker.

Q: What license does the Confluence MCP Server use?

A: The Confluence MCP Server is licensed under the MIT License. See the LICENSE file for full terms.

Q: How does the Confluence MCP Server integrate with UBOS?

A: The Confluence MCP Server provides the crucial connection to Confluence data, and the UBOS AI Agent Development Platform provides the tools and infrastructure necessary to build, deploy, and manage sophisticated AI agents that leverage this data effectively. You can connect to the Confluence MCP Server as a data source and use it with other AI agents and workflows.