Confluence
The Confluence connector enables AI agents to search documentation, read pages, create new content, and manage comments — all via the Confluence REST API using OAuth 2.0. Your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Confluence account.
| Scope | Purpose |
|---|---|
| read:confluence-space.summary | List and read spaces |
| read:confluence-content.all | Read pages and their content |
| search:confluence | Search content using CQL |
| write:confluence-content | Create and update pages |
| write:confluence-space | Write to spaces |
| delete:confluence-content | Delete pages |
Tool reference#
The Confluence connector exposes 10 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| confluence_list_spaces | read | List all Confluence spaces accessible to the user |
| confluence_get_space | read | Get details of a specific Confluence space |
| confluence_list_pages | read | List pages in a Confluence space |
| confluence_get_page | read | Get the content of a specific Confluence page |
| confluence_search | read | Search Confluence content using CQL (Confluence Query Language) |
| confluence_list_comments | read | List comments on a Confluence page |
| confluence_create_page | write | Create a new page in a Confluence space |
| confluence_update_page | write | Update the content of an existing Confluence page |
| confluence_add_comment | write | Add a comment to a Confluence page |
| confluence_delete_page | delete | Delete a Confluence page |
Page deletion is permanent
confluence_delete_page permanently deletes the page. Confluence moves deleted pages to the trash, where they remain recoverable by an admin for a limited time before being purged. Deny this tool in any app that does not explicitly require it.Common guardrail recipes#
Read-only access#
Enable only the six read tools and deny all write and delete tools. This is the recommended starting configuration for AI agents that summarise documentation or answer questions from wiki content.
Contribute preset#
Enable read tools plus confluence_create_page, confluence_update_page, and confluence_add_comment. Deny confluence_delete_page. This allows the AI to draft and update documentation without destructive access.
Restrict to specific spaces#
Apply the allow_values template to confluence_create_page and confluence_update_page. Target the space_key field and provide the list of space keys the agent may write to.
Troubleshooting#
- CQL search returns no results —
confluence_searchuses Confluence Query Language syntax (e.g.space = "ENG" AND text ~ "API"). Ensure your query is valid CQL and the space key is correct. - Page version conflict —
confluence_update_pagerequires the current page version number. Fetch the page withconfluence_get_pagefirst to obtain the latest version before updating. - 403 on a space — Confluence enforces space-level permissions. Ensure the connected user account has at least read access to the target space.