> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clarion.cantina.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence

> Connect Confluence Cloud to Clarion with an Atlassian service account so agents can read and search documentation for context during triage.

This guide shows how to connect Confluence Cloud to Clarion using an Atlassian service account and OAuth 2.0 client credentials.

<Note>
  **Estimated time:** 10-15 minutes. You need access to:

  * A **Clarion workspace**
  * **Atlassian Administration** for your Confluence site
  * A service account that can view and search content in the Confluence spaces you want Clarion to use
</Note>

## Prerequisites

Before connecting Confluence in Clarion, make sure you have:

* Your Confluence site URL, for example `https://example.atlassian.net`
* A Confluence service account with access to the relevant spaces
* An OAuth 2.0 credential created for that service account
* These credential scopes (granular — Clarion uses the Confluence REST API v2):
  * `read:page:confluence`
  * `read:space:confluence`
  * `search:confluence`

<Info>
  Clarion uses the service account’s client credentials to request short-lived Confluence access tokens automatically. You do not need to reconnect the integration just because an access token expires.
</Info>

***

## Step 1 - Create a Confluence service account

1. In **Atlassian Administration**, open **Directory** and create a **service account**.
2. Grant the service account access to **Confluence**.
3. Make sure the service account has access to the spaces Clarion will read.

The service account should be able to:

* Search content
* View page content
* List spaces

***

## Step 2 - Create OAuth 2.0 credentials for the service account

1. Open the service account in **Atlassian Administration**.
2. Go to **Credentials**.
3. Create an **OAuth 2.0** credential.
4. Grant only these scopes:
   * `read:page:confluence`
   * `read:space:confluence`
   * `search:confluence`
5. Copy the **Client ID** and **Client secret**.

<Tip>
  Keep the client secret somewhere safe. You will paste it into Clarion during setup.
</Tip>

***

## Step 3 - Connect Confluence in Clarion

1. In Clarion, go to **Integrations**.
2. Open **Confluence**.
3. Enter:
   * **Site URL**
   * **Client ID**
   * **Client Secret**
   * **Default Space Key** (optional)
4. Click **Connect Confluence**.

***

## Step 4 - Verify and maintain the connection

After connecting:

1. Review the saved Confluence site and client ID.
2. Set or update **Default Space Key** if you want Clarion to scope searches to a space automatically.
3. Click **Save** after any changes.
4. Click **Verify Connection** to confirm Clarion can access Confluence successfully.
5. Use **Disconnect** if you want to remove Confluence access from the workspace.

<Tip>
  Agents can still pass a space in CQL per tool call. If omitted, Clarion uses the configured default space key when scoping a search.
</Tip>

***

## How Confluence tools use this integration

When Confluence tools are enabled, Clarion can:

* Search pages with CQL
* Read a page by id
* List spaces

Clarion manages Confluence access tokens automatically from the stored client credentials.

***

## Troubleshooting

### "Failed to resolve Confluence cloud ID"

Check that **Site URL** is exactly your Confluence Cloud URL, for example:

* `https://example.atlassian.net`

Do not include a path such as `/wiki`, `/spaces`, or `/display`.

### "Confluence credential is missing required scopes"

Recreate or update the OAuth 2.0 credential so it includes:

* `read:confluence-content.all`
* `read:confluence-space.summary`
* `search:confluence`

### Verify Connection fails even though the credential is valid

Make sure the service account itself has Confluence product access and space-level permissions in the spaces Clarion needs to read.