All integrations

Confluence

Spaces, pages, search, and comments on Confluence Cloud.

OAuth 10 tools

Overview

Connect Confluence Cloud to give AI clients access to your spaces, pages, search, and comments for documentation and knowledge workflows.

Prerequisites

  • A Confluence Cloud site you can access
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open Confluence.
  3. Click Activate, then Connect Confluence.
  4. Approve the Atlassian OAuth prompt and grant access to your Confluence Cloud site.
  5. If you have multiple Confluence sites, choose your default site on the site picker page.

No manual API tokens are required. Confluence uses Confluence-only OAuth scopes — separate from Jira and Bitbucket.

Using with AI clients

  • Dedicated endpoint: POST /mcp/confluence with a Sanctum bearer token
  • Private gateway: one config for all integrations — use confluence__* namespaced tools

Typical workflow: list accessible sites → list spaces → search or list pages → get page body → create or update pages → add comments.

If you connect multiple Confluence sites, pass cloud_id on tool calls or set a default site in My Integrations.

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the OAuth connect flow in My Integrations.
  • No default site selected — open Confluence in My Integrations and choose a default site.
  • Token expired or revoked — disconnect and reconnect Confluence from the integration page.
  • 403 permission denied — your Atlassian user lacks Confluence permission for that content, even when OAuth succeeded.
  • 401 scope mismatch — reconnect after Confluence scopes were updated in the hub configuration.
  • 429 rate limit — Atlassian may throttle heavy API usage; wait and retry, or reduce parallel tool calls.

Available tools

  • list_accessible_sites

    List Confluence Cloud sites accessible with the connected Atlassian account.

  • list_spaces

    List Confluence spaces on the connected site.

  • get_space

    Get details for a Confluence space by id.

  • list_pages

    List Confluence pages, optionally filtered by space.

  • search_pages

    Search Confluence pages by title within an optional space.

  • get_page

    Get a Confluence page by id, including body content.

  • create_page

    Create a new Confluence page in a space.

  • update_page

    Update an existing Confluence page. Requires the current page version number.

  • add_page_comment

    Add a footer comment to a Confluence page.

  • list_page_comments

    List footer comments on a Confluence page.

MCP endpoint: https://stackgate.ai/mcp/confluence (HTTP) or via the private gateway.