Confluence MCP server: scoped wiki access for every agent

Wiki work is usually a retrieval problem before it becomes an editing problem. Ask the agent to find the approved document inside a named space, read the page and cite its URL. Search matches alone can include old decisions, archived plans or drafts. A summary should say which page version it used.

For an update, let the agent read the current page immediately before preparing the replacement. The currentVersion value is part of the write request. If someone edits the page between those steps, the agent should fetch the newer content and show a revised proposal; repeating the old request is not a valid resolution.

The body format matters too. This adapter creates storage-format pages. Ask for a small, concrete change with the target page ID and a reviewable body, rather than expecting every Confluence editor feature to be reproduced from a chat message.

Confluence MCP server options: official Rovo, open-source mcp-atlassian, AIPx

The Confluence authentication reference documents the API token route. mcp-atlassian is a community alternative with its own supported products and operations. You can also choose the Atlassian Rovo connection within AIPx when you prefer the official combined surface.

A direct vendor server is easier to reason about for one wiki and one client. AIPx adds credential storage and request handling outside Atlassian, in exchange for reusing connections with different agent rules. There is no automatic expansion of space or page access.

Connect Confluence to Claude, Claude Code or Cursor

Connect a Confluence Cloud site with an Atlassian email and API token. Rovo OAuth is a separate catalog integration.

1. Open the AIPx dashboard, choose Confluence under Integrations and complete its connection form or authorization.
2. Create an MCP agent, enable that connection and choose the tools this particular agent needs. Save the rules before opening your AI client.
3. Copy the agent’s complete URL. The examples below use AGENT_ID; replace it with the actual value from your dashboard.

An endpoint identifies the AIPx agent, not a provider API key. Client authentication to AIPx is separate from connecting Confluence; adding the URL does not grant extra provider permissions. Our MCP gateway guide explains how several approved connections can share that endpoint.

Connect Claude to Confluence

In Claude, open Customize → Connectors and add a custom connector with your AIPx URL. Continue through AIPx sign-in, then check the tools available in a conversation. Custom connector access depends on account and workspace policy; administrators can restrict it. The Claude MCP setup guide covers the current controls. A direct vendor connection can be simpler when Confluence is the only service you need.

Confluence MCP in Claude Code

claude mcp add --transport http aipx https://dash.aipx.run/mcp/AGENT_ID

Authorize with /mcp, then read one known Confluence page and check its version. Keep updates hidden while verifying the correct space. Claude Code MCP setup describes server configuration and login.

Confluence MCP in Cursor

Add this server to .cursor/mcp.json for the project or ~/.cursor/mcp.json for your user:

{
  "mcpServers": {
    "aipx": { "url": "https://dash.aipx.run/mcp/AGENT_ID" }
  }
}

In Cursor, complete sign-in and search the named Confluence space before fetching a page. A later update needs its current version and client approval. See Cursor MCP configuration for setup troubleshooting.

Confluence MCP in Codex

codex mcp add aipx --url https://dash.aipx.run/mcp/AGENT_ID
codex mcp login aipx
codex mcp list

Codex uses the HTTP endpoint and browser OAuth; it does not need a copy of the Confluence credential in its config. See Codex MCP setup for TOML configuration and project trust requirements.

Where ChatGPT custom MCP is enabled, use this endpoint to read a named wiki page. That does not make every space accessible or authorize page edits. ChatGPT MCP setup explains tier and administration requirements.

Scope Confluence per agent: search and read on Allow, page edits on Confirm

A documentation researcher needs search_content, list_spaces, list_pages and get_page. It does not need create_page or update_page. Hide both writes for that agent. A separate documentation assistant can have those writes on Confirm, with the target space and page shown in the client before approval.

Hide removes callable tools; it does not alter the underlying Confluence user’s permissions. Confirm is a client-facing approval hint, so a client that does not honor it needs stricter tool hiding. The MCP permissions guide explains this distinction.

Use Confluence with Jira

A Jira MCP connection can supply issue status while Confluence supplies the decision record. Ask the agent to compare a named ticket with its linked specification and produce a discrepancy list. Approve a Jira comment only after the sources are visible; no wiki write is necessary for that task.

If specifications also live in Notion, include that connection only for the pages the agent needs. GitHub adds implementation evidence, and Linear can be used for a tracker outside Atlassian. Different providers remain separate accounts behind the agent URL.

Confluence API limits and version conflicts

Confluence Cloud access controls still decide which spaces and pages a user may read or edit. Tool rules cannot narrow one search tool to an arbitrary subset of spaces, so use a provider account with the required space restrictions. Specify a space in the prompt to make results relevant, but treat that prompt as task guidance rather than an authorization boundary.

A stale version error protects a teammate’s newer edit. Return to get_page, compare revisions and review the proposed update again. The connector does not promise full parity with macros, attachments or every editor feature. Its advertised boundary is search, spaces, pages, creation and version-checked updates.

Browse all MCP integrations to choose another connection for this agent.

The Confluence connection can use AIPx Free with 3 active accounts and 1 agent; check AIPx pricing for gateway plans and keep provider or client charges separate.