Claude Media
Claude Confluence連携でナレッジ検索を自動化する方法
ClaudeClaude連携チュートリアル

Claude Confluence連携でナレッジ検索を自動化する方法

Confluenceの検索窓を開かずに、社内ドキュメントの答えをClaudeに聞けるようにする設定と使い方。接続経路ごとの違いと権限の絞り方まで扱います。

読了目安 約8分

Claude Confluence連携は3つの経路で届く

ClaudeからConfluenceを検索する経路は、使う面によって3つに分かれます。どれもJiraと同じAtlassianの接続で動き、Confluenceだけを別に接続する作業はありません。Jira側の接続手順はClaude Jira連携の記事にあります。ここでは接続が済んでいる前提で、Confluenceの検索と書き込みに絞ります。

経路

Confluenceに届く3つの接続経路

  • claude.aiとClaude Desktop

    Atlassian MCPコネクタ(接続先はhttps://mcp.atlassian.com/v2/mcp)を追加し、自分のAtlassianアカウントでサインインします。コネクタの提供元はAtlassianです。

  • Claude Code

    claude mcp addでMCPサーバーとして足すか、Atlassianのプラグインを入れます。後者ならスラッシュコマンドも付いてきます。

  • Claude Tag(Slack)

    MCPではなくHTTP API接続です。専用のAtlassianアカウントで発行したAPIトークンを管理者がバンドルに登録します。

3つとも、Claudeが読めるのは接続に使ったアカウントの閲覧権限の範囲だけです。個人のコネクタなら自分のアカウント、Claude Tagなら専用アカウントがその範囲を決めます。

Claude Codeでの接続と、手元のclaudeで見える形

Claude CodeからAtlassianに接続する方法は2つあり、入れるものが違います。MCPサーバーだけなら、Atlassianのドキュメントにあるコマンドで足せます。

claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp

追加したら、Claude Codeのセッションを開いて/mcpを実行し、画面の案内に従ってサインインします。--scopeの既定値はlocalです。--scopeにはlocal・user・projectを指定でき、プロジェクト単位の設定にしたいときは--scope projectを付けます。

もう1つはプラグインです。claude plugin install atlassian@claude-plugins-officialで入れると、MCP接続に加えて次のスキルが使えます。

スキル用途
/search-company-knowledge用途社内ドキュメントの横断検索
/spec-to-backlog用途Confluenceの仕様書をJiraのバックログに変換
/capture-tasks-from-meeting-notes用途議事録から担当者付きのチケットを作る
/generate-status-report用途プロジェクトの進捗レポートを作って公開
/triage-issue用途issueの分類と優先度付け

プラグインの仕組みはClaude Codeプラグイン完全ガイドで扱っています。Claude Codeで毎回同じ手順を呼びたいときは、スキルが入口になります。

質問の仕方でAtlassian側のツールが変わる

Claudeに「Confluenceで調べて」と頼むと、内部ではAtlassian MCPサーバーのツールが呼ばれます。コネクタの一覧にはConfluence関連としてsearchConfluence、getConfluenceContent、createConfluenceContent、updateConfluenceContentが載っています。ほかに、Jiraやつながったアプリを横断するsearchもあります。

やりたいこと呼ばれるツール向く質問
条件で絞って探す呼ばれるツールsearchConfluence向く質問「Engineeringスペースで、先月更新したページ」
言葉で探す呼ばれるツールsearch向く質問「認証のトークン期限について書いた箇所」
ページを読む呼ばれるツールgetConfluenceContent向く質問「このURLのページを要約して」
ページを書く呼ばれるツールcreateConfluenceContent / updateConfluenceContent向く質問「この内容でページを作って」

searchConfluenceはCQL(Confluenceの検索クエリ言語)でConfluenceを検索するツールです。スペースやラベル、更新日のような条件が決まっている質問と相性が良いツールです。searchはRovo経由で自然言語のままJiraやConfluenceを横断して探すツールです。

費用の面でも違いがあります。Atlassianのドキュメントでは、searchやgetTeamworkGraphContextのような統合検索・文脈取得のツールがRovoクレジットを消費すると書かれています。クレジットは、Rovo Chatやエージェントと同じ組織共通の枠から引かれます。消費量は取り出すデータ量と推論の深さで変わり、1回の呼び出しごとに上限があります。書き込み系にも消費の大きいツールがあります。createConfluenceInfographicForPageとeditConfluenceInfographicForPageは、1回の依頼で15〜30クレジットが目安です。大量の検索や生成を自動で回す前に、Atlassian側のクレジット枠を管理者に確かめておくと安心です。

仕様書をJiraバックログに変換する

プラグインを入れた場合、/spec-to-backlogでConfluenceの仕様書をEpicと子チケットの階層に変換できます。Atlassianのプラグインページには、「この仕様書ドキュメントを、Epicと子チケットを含むバックログに変換して」という趣旨の依頼例が載っています。

ドキュメントとチケットが別の場所にあると、「仕様は書いたがチケット化を忘れる」という隙間ができます。このスキルはその隙間を埋める使い方です。プラグインを入れずclaude.aiのチャットから同じ内容を頼むこともできますが、毎回手順を文章で説明することになります。

変換結果は元ページの構成に依存しうるため、Epicと子チケットの切り分けは、作られた階層を見てから確定します。

検索の範囲と書き込みの範囲は別々に絞れる

Confluence検索の届く範囲は、接続したAtlassianアカウントが閲覧できるスペースで決まります。Claude側のTool permissionsはツール単位の設定で、スペース単位の指定ではありません。見せたくないスペースがあるなら、Atlassian管理者に権限の変更を頼みます。

一方、Claudeに何をさせてよいかは2か所で絞れます。

くらべる

書き込みを絞る2か所

Team・Enterprise

Claude側

Customize > Connectorsでコネクタを選び、Tool permissionsをカテゴリごとに「Always allow」「Needs approval」「Blocked」へ振り分けます。読み取り系は許可し、書き込み・削除系だけ止める、といった使い方ができます。組織全員に効き、個人が上書きすることはできません。

組織管理者

Atlassian側

Atlassian MCPのツールはread_confluence、write_confluence、search_confluenceのような権限グループに分かれ、管理者はグループ単位で許可や取り消しをします。グループ内の各ツールは、親グループの許可を引き継ぎます。

見落としやすいのは、write_confluenceの中身です。ページの作成・更新だけでなく、ページのコンテンツ権限の追加・削除や、公開リンクの有効化・無効化のツールも同じグループに入っています。ページを書いてほしいだけなのにグループごと許可すると、権限まわりの操作も許可対象に入ります。

どちらの制限も、Claudeに追加の権限を与えるものではありません。Claude側で書き込みを許可しても、そのユーザー自身がConfluenceで書き込める場合に限って変更が通ります。Jiraの削除とプロジェクト管理のツール(delete_jiraとmanage_jira)は、Atlassian側で既定で無効です。

組織で使うとき — Team・Enterpriseと専用アカウント

Team・Enterpriseプランでは、まずオーナーまたはプライマリオーナーが組織向けにコネクタを有効にします。ただし有効化しただけでは誰にもアクセスは付与されず、各メンバーが自分のAtlassianアカウントでサインインして初めて使えます。Enterprise-managed authを使う組織では、IDプロバイダー経由でまとめて認可する方法もあります。

個人のAtlassianアカウントで接続すると、読める範囲もその人の権限そのものになります。部署で継続的に使うなら、個人に紐づかない専用アカウントで接続する構成が候補になり、これがClaude Tag(Claude Tagの紹介記事)の前提です。

手順

Claude Tagで専用アカウントを接続する流れ

  1. 1

    専用のAtlassianアカウントを用意する

    たとえばclaude@yourcompany.example.comのようなアカウントを作り、Claudeに読ませたいJiraプロジェクトとConfluenceスペースだけに追加します。接続が読める範囲は、このアカウントが読める範囲そのものです。

  2. 2

    スコープなしのAPIトークンを発行する

    id.atlassian.com/manage-profile/security/api-tokensでトークンを作ります。表示されるのは1回きりで、有効期間は最長1年です。期限が切れる前に作り直して接続を更新します。

  3. 3

    バンドルに接続を追加する

    管理画面のclaude.ai/admin-settings/claude-tagでアクセスバンドルを開き、Credentialsタブの「Jira & Confluence」でConnectします。ホスト欄は、既定の*.atlassian.netを自分のサイトのホスト名に書き換えます。ワイルドカードのままだと他のAtlassianサイトにも届いてしまうため、フォームが受け付けません。

  4. 4

    スレッドで確認する

    対象チャンネルの新しいスレッドで、Jiraのissueかページを1件だけ読ませます。Atlassianの監査ログには専用アカウントの操作として残ります。

トークンをスコープ付きで発行する組織は、プリセットではなくカスタム接続を使います。Atlassianがスコープ付きトークンを受け付けるのはapi.atlassian.comのゲートウェイだけで、サイトのホスト名では受け付けないためです。この場合、許可パスを/ex/jira/ と /ex/confluence/ に続けたクラウドIDの形に制限します。セルフホストのData Centerもプリセットの対象外で、Bearer認証のカスタム接続になります。

Claude Tagの使用例集では、Confluenceの接続で動く用途として「Find answers in your docs」と「Review documents against a checklist」が挙がっています。前者は方針・ランブック・過去の決定を調べて出典付きで返す使い方で、後者は接続先のドキュメントをチェックリストと照らして項目ごとに指摘を返す使い方です。どちらもGoogle DriveかNotionを接続している場合は、そちらでも動きます。

よくあるつまずき

  • 一部のページしか検索できない: Confluence連携が探せるのはAtlassianのサイトの中だけです。Google DriveやNotionにも社内文書があるなら、それぞれ別にコネクタを接続します。会話ごとの切り替えは、チャット左下の「+」から「Connectors」で行えます

なお、旧版(v1)のAtlassian MCPサーバーを使っている環境は、2027年3月1日から既存の利用が自動的にv2のツールを公開・利用する動きになります。互換性のないクライアントは、キャッシュされたクライアントIDや.well-knownの認証情報を消さないと認証が続かなくなります。

まとめ

個人で試すなら自分のサインインで、Claude CodeかClaude.aiから始められます。部署で継続運用するなら専用アカウントを用意し、ページを書かせる場合はwrite_confluenceをグループごと許可する前に、権限まわりのツールも含まれることを思い出してください。生成したレポートをConfluenceに定期公開する使い方はJiraスプリントレポートの記事に続きます。

この記事を共有:XはてブLinkedIn

関連する記事

Claude をもっと見る →