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

Claude Confluence連携とは — ナレッジ検索の基本

ClaudeとConfluenceをつなぐと、スペースをまたいだページ検索と要約をチャットの中から依頼できるようになります。提供元はAtlassian自身で、JiraとConfluenceは1つの認証(Atlassian Rovoコネクタ)で同時にカバーされます。設定がまだの場合は、Claude Jira連携の記事で接続手順をまとめているので先にそちらを済ませてください。本記事は接続済みであることを前提に、Confluence側の検索・生成の使い方に絞ります。

ナレッジ検索は、公式のユースケース分類でも「Knowledge and docs」という独立したカテゴリに位置づけられています。Google DriveやNotionと並んで、Confluenceは「ポリシー・ランブック・過去の意思決定を調べて、出典付きで回答する」用途の主要な接続先として明記されており、単なるおまけ機能ではなく設計上の主要ユースケースです。

Confluenceでできること — 検索・要約・作成

公式の使用例として次のような依頼がそのまま挙げられています。

「認証システムに関するドキュメントをConfluenceから探して」

「Engineering/Incidentsスペースに『Post-Mortem: Sprint 24』というConfluenceページを作って」

「ドキュメントに何を書いたか覚えていない」状態から検索窓を開いて絞り込む作業を、質問文をそのまま投げるだけで済ませられる点が、通常のConfluence検索との違いです。

仕様書をJiraバックログに変換する — spec-to-backlogスキル

Confluence連携で特に独自性が高いのが、仕様書からのバックログ生成です。Claude Codeにプラグインを導入している場合、/atlassian:spec-to-backlogというスラッシュコマンドが使えます(導入コマンドはclaude plugin install atlassian@claude-plugins-official)。プラグインの仕組み自体はClaude Codeプラグイン完全ガイドで扱っています。

公式の使用例は次の通りです。

「この仕様書ドキュメントを、Epicと子チケットを含むバックログに変換して」

Confluence側の仕様書をClaudeが読み込み、Epic階層を整理した状態でJira側にissueとして起票します。ドキュメントとチケットが別の場所にあることで発生する「仕様は書いたがチケット化を忘れる」というギャップを埋める使い方です。claude.aiのチャットからでも、プラグインなしで同等の依頼をすれば同じ処理を試せます。プラグインの利点は、毎回文章で説明しなくてもスラッシュコマンド1つで同じ手順を呼び出せる点にあります。

検索の届く範囲はスペースの権限がそのまま効く

Confluence検索は、接続したAtlassianアカウントが閲覧できるスペースの範囲でしか動きません。全社公開のスペースだけを見せたい、あるいは特定のスペースだけに絞りたい場合、Claude側に設定はなく、接続に使うAtlassianアカウント自身の閲覧権限で調整します。

個人のclaude.aiアカウントで接続する場合、この調整はAtlassian管理者に権限変更を依頼するしかありません。組織としてスペース単位で厳密に絞り込みたいときは、Claude Tag経由で専用のサービスアカウントを作り、そのアカウントに必要なスペースだけを共有する構成のほうが向いています。Claude Tagの使用例一覧でも「Review documents against a checklist」(チェックリストに沿った文書レビュー)がConfluence接続の代表的な用途として挙げられており、個人の質問応答よりも組織的な運用を前提にした設計です。

claude.aiとClaude Codeで検索の使い勝手は変わるか

検索エンジンとしての中身は同じMCPサーバーなので、返ってくる情報の範囲は変わりません。違うのは呼び出し方です。claude.aiのチャットでは自然文の質問だけで完結しますが、Claude Codeでは実装作業の途中に「このAPIの仕様がConfluenceにあるはずだから調べて」と挟み込む使い方が中心になります。コードを書きながら仕様書を検索して答え合わせする、という一連の流れを1つのセッションで閉じられる点が、開発者にとってのClaude Code側の利点です。

Confluence標準の検索窓との違いは、質問の粒度にあります。標準検索はキーワード一致でページの候補一覧を返しますが、Claudeへの質問は「認証まわりの仕様で、トークンの有効期限について書かれている箇所はどこか」のように具体的に聞けます。複数ページにまたがる情報でも、該当箇所を拾い集めて1つの回答にまとめてくれるのが違いです。曖昧な言い回しでの再現性は、ページ側のタイトルや見出しの付け方に左右されます。見出しが整理されたページほど該当箇所を的確に拾いやすく、逆に構成が雑然としたページでは回答の精度が落ちる傾向があります。

Team/Enterpriseプランでの接続

Free / Pro / Maxの個人プランでは自分のOAuthサインインだけで完結しますが、Team/Enterpriseプランでは組織レベルでの有効化が前提です。オーナーが管理画面の「Connectors」セクションでAtlassianを有効にし、そのうえで各メンバーが自分のAtlassianアカウントでサインインする2段階の流れになります。オーナーが有効化していない状態では、メンバー側の設定画面にAtlassianの接続項目自体が表示されません。

組織で使う場合、誰がどのAtlassianアカウントで接続するかは重要な論点です。個人のJiraアカウントで接続すると、その人が異動・退職した際に接続も失われます。継続的な業務利用を想定するなら、前述のClaude Tagのような、個人に紐づかない専用サービスアカウント方式を検討する余地があります。

よくあるつまずき

• 「そのページは見えません」と言われる: 接続したAtlassianアカウントがそのスペースを閲覧できるか確認します。Claude側の設定では解決しません
• 検索結果が古い: Confluence側でページが更新された直後は、反映に多少の遅延が生じることがあります
• 仕様書からのバックログ変換で階層が崩れる: 元のConfluenceページの見出し構造が曖昧だと、Epicと子issueの切り方も曖昧になります。見出しを整理してから変換を頼むと安定します
• 社内Wikiが複数ツールに分散していて一部しか検索できない: Confluence連携が検索できるのはAtlassianサイト内のページだけです。Google DriveやNotionを併用している場合はそれぞれ別に接続する必要があります
• 接続はできたのにエラーで止まる: 組織の管理者が「User Installed Apps」を制限している環境では、接続に使うアカウント自身がConfluenceのライセンスを持っている必要があります。Jiraのライセンスしか持たないアカウントで接続しようとすると、この設定がボトルネックになることがあります

まとめ

Confluence連携は、Jira連携と同じ1つの認証の上に成り立つ機能です。検索・要約はスペースの閲覧権限がそのまま上限になり、仕様書からのバックログ変換(spec-to-backlog)は文書とチケットの間の手作業を埋める用途として特に独自性があります。接続そのものがまだの場合はJira連携の記事を、生成したレポートをConfluenceに定期的に公開する使い方はJiraスプリントレポートの記事を合わせて参照してください。

よくある質問

Confluenceだけ接続してJiraは使わないことはできますか

技術的には検索や質問をConfluenceの内容に限定して使えますが、接続自体はJiraとConfluenceの両方に対して同時に有効になります。公式ドキュメントにはJira側だけを個別に無効化する設定の記載がありません。

検索できるページ数に上限はありますか

公式ドキュメントに具体的な上限は明記されていません。検索の範囲は接続したアカウントが閲覧できるスペースの権限で決まります。

複数のConfluenceサイト(複数ドメイン)を同時に検索できますか

組織向けのClaude Tag経由の接続は、1つのAtlassianサイトのホスト名を指定して作る仕組みです。個人のclaude.aiコネクタで複数サイトを横断できるかは公式ドキュメントに明記がなく、断定はできません。複数サイトを使い分けている場合は、まず1サイトで接続を試し、必要な範囲が届くか確認するのが確実です。

Google DriveやNotionと同時に検索させることはできますか

はい。コネクタはそれぞれ独立してオン・オフできるため、Confluence・Google Drive・Notionを同時に接続し、1つの会話の中で横断して検索させることもできます。