ClaudeとConfluenceの連携方法と、できないこと

ClaudeとConfluenceを実際に接続しているもの

Confluence専用のClaude連携というものは存在しない。存在するのはAtlassianのコネクタひとつで、Confluenceはその中に乗っているだけだ。

実際に仕事をしているのは、以前はAtlassian Remote MCP Serverと呼ばれていたAtlassian Rovo MCPサーバーだ。これはhttps://mcp.atlassian.com/v1/mcp/authv2にあるクラウドホスト型のブリッジで、AnthropicがAIクライアントを外部システムに接続するために作った公開標準であるModel Context Protocolを話す。Atlassianはこれを製品というよりプロキシだと説明しており、「あなたのJiraやConfluenceのコンテンツを保存もキャッシュもしない」とはっきり述べている。

これについて驚く人が多い事実が2つある。

1つ目は価格だ。Freeティールを含むすべてのAtlassian Cloudプランで無料であり、Rovoの購読も不要だ。なぜならAtlassian自身の説明では、これはAIモデルではまったくなく、単なる統合レイヤーに過ぎないからだ。プランに応じてスケールするのはスループットの方である。レート制限はFreeで1時間あたり500コール、Standardで1,000コール、Premium・Enterpriseでは1,000コールに加えユーザーあたり20コールで最大10,000コールまでとなる。これらの上限はユーザー単位ではなくサイト単位で、Jiraと共有されているため、意欲的なエージェントセッションがひとつあるだけで小さなチームの予算を食い尽くしてしまうこともある。

2つ目は、Confluenceが特別扱いを受けているという点だ。3つのConfluence権限グループはすべて、OAuth 2.1とAPIトークン認証の両方を受け付ける。これは、兄弟にあたる他製品と比べるまではただの豆知識に聞こえる。

Claude for Jira Service Managementについて書いたとき、オチは「通常のOAuthログインではJSMのツールがひとつも表面化しない」というものだった。Confluenceはその逆のケースだ。同意画面を通過すれば、フルセットが手に入る。

独自クライアントをつまずかせる落とし穴がひとつある。getAccessibleAtlassianResourcesはどのツールにとっても必須の最初の呼び出しだ。すべての呼び出しにcloudIdが必要だからである。Atlassianのドキュメントにもそのままそう書かれている。マルチサイトの組織では、これはエージェントがどのConfluenceにこれから書き込もうとしているのかを静かに決めている場面でもある。

そしてCloud専用で、Data Centerへの道は一切ない。これはロードマップ上の欠落というより構造的なものだ。自己管理型インスタンスには渡せるcloudIdがそもそも存在しないからだ。これに関するGitHubの要望は2025年11月から開いたままになっている。

Confluenceの12個のツールと、それがカバーする範囲

Atlassianは3つの権限グループにまたがってちょうど12個のConfluenceツールを公開している。読み取り7個、書き込み4個、検索1個だ。管理者はこれをグループ単位でまとめて付与するのであって、個別に付与することはない。

ツールをただ列挙する代わりに、人々がClaudeにウィキで実際にやらせようとする9つのことに対して、それが何を意味するかを見ていこう。

存在しないものの一覧は、二度読む価値がある。添付ファイルなし、ラベルなし、ページ履歴なし、削除なし、移動やコピーなし、テンプレートなし。Atlassianのサポート済みツールリファレンスがそれらを列挙している唯一のページで、これらのギャップのほとんどについて未対応の機能リクエストが存在する。ここでのギャップが妨げになるなら、次に検討すべきはたいていマーケットプレイス経由の選択肢だ。私はConfluenceアプリのトップとConfluence AIアプリでより良い選択肢をまとめている。

ClaudeをConfluenceに接続する方法

セットアップは速い。手順の順番はコマンド自体よりも重要だ。管理者の同意ステップが、最初の試みの大半をつまずかせる原因になるからだ。

1. サイト管理者を準備しておく。 Rovo MCPサーバーは事前にインストールするMarketplaceアプリではない。誰かが最初にOAuth同意フローを完了した時点でジャストインタイムでインストールされ、サイト管理者がその最初の同意を承認する必要がある。あなたが管理者でないなら、壁に突き当たってからではなく、始める前に確認しておくべきだ。

2. 使っている環境にコネクタを追加する。 Claude Codeでは1行で済む。

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

その後、セッション内で/mcpを実行して認証する。プロジェクト単位の設定にしたい場合は、リポジトリ自身の.mcp.jsonが同じ役割を果たす。

{
  "mcpServers": {
    "atlassian": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v1/mcp/authv2"
    }
  }
}

Claude Desktopでは、Settings、Extensions、Browse extensionsと進み、Atlassianを検索する。claude.aiにはJSONというもの自体がなく、コネクタディレクトリからAtlassian Rovoのリストを追加するだけだ。これはコミュニティプロジェクトではなく、Atlassianが作った公式のリストである。

3. 同意する前に権限グループを決めておく。後ではない。 管理者は権限タブからグループ単位でアクセスを制御でき、それぞれが「許可」「ブロック」「一部許可」として表示される。読み取りだけにしたいなら、今のうちにwrite_confluenceをブロックしておくこと。後でエージェントがページを台無しにしても、元に戻すツールは存在しない。

4. Confluenceが何かの背後にある場合はネットワーク経路を確認する。 ClaudeはDesktopを含むすべてのクライアントで、あなたのノートPCからではなくAnthropicのクラウドからMCPサーバーに到達する。ファイアウォールがある構成では、Anthropicのアドレス範囲を許可リストに登録する必要がある。Atlassianのドメイン制御もオールオアナッシングであり、パートナーリスト全体を許可するかブロックするかしかできない。つまりClaudeだけ許可してChatGPTだけ拒否することはできない。

5. プロンプトの中でコネクタの名前を明示する。 これは実際に使ってみて初めてわかることで、あるRedditユーザーがうまく言い表している。

"I have had quite a bit of luck using it with JIRA and Confluence to read docs/tickets as well as generate them. I am using it mostly through Claude Code and Claude Desktop on Mac. I find if I'm not super explicit that I want it to use the MCP it will go haywire."

ChezTheHero, r/ClaudeAI, Reddit

この連携が本当に得意なこと

情報検索だ。それが正直な答えであり、聞こえる以上に大きな話でもある。というのも、Confluenceのネイティブ検索には評判というものがあるからだ。

私が見つけた最も強い後押しは、MCP経由の検索をConfluence自体の検索と比較した開発者からのものだった。

"Considering how poor the Confluence search function is, the results from Confluence via an MCP-powered search are remarkably good. I was able to solve one or two obscure, company-specific issues purely by using the MCP search, and I'm convinced that finding these pages would have been almost impossible without it."

icanintospace, Hacker News

これは、ツールがそもそも何のために作られているかと合致する。searchConfluenceUsingCqlを呼び出し、結果を読み、それからgetConfluencePageDescendantsでページツリーを下っていけるモデルは、Confluenceの検索ボックスが構造的にできないことをやっている。そのループを自分で組みたいなら、Confluence AI APIのガイドが直接的な方法を解説している。

コネクタにはさらに6つのエージェントスキルがバンドルされており、そのうち4つがConfluenceに関わる。Search Company Knowledgeは並行して引用付きの検索を実行し、Spec to BacklogはConfluenceの仕様書をJiraのエピックとチケットに変換し、Generate Status ReportsはJiraのイシューを公開済みのConfluenceページに反映し、Capture Tasks from Meeting Notesはその名の通りのことをする。すでにAtlassian AIプロジェクト管理を使っているなら、Spec to Backlogが最初に試す価値のあるものであり、そのJira側の半分はJiraコパイロットがやっていることと大きく重なる。ステータスレポートのスキルは、本物のConfluenceワークフロー自動化に最も近いものだ。

リポジトリ自体について知っておく価値があるのは、atlassian/atlassian-mcp-serverにはサーバーのソースコードが一切含まれていないという点だ。含まれているのはREADME、マニフェスト、Claude Codeプラグイン、そしてそれらのスキルだけである。サーバー自体はクローズドソースでクラウドホスト型だ。スター数は952、ライセンスはApache-2.0、未解決のイシューは78件で、そのうち34件がConfluence関連だ。

どこで壊れるか: Confluenceへの書き込み

読み取りはしっかりしている。書き込みは私なら慎重になる部分であり、その根拠は珍しいほど具体的だ。

2026年5月、あるユーザーがAtlassianコミュニティにデータ損失の報告を投稿した。これはこのテーマ全体の中で最も鋭い証拠だ。

"I used Claude via the Atlassian Rovo MCP connector to rename and reorganize pages in my Confluence workspace. Claude sent update calls that changed the title but did not include the body field. The Confluence API interpreted the missing body as an instruction to clear the page content. Every page that was renamed had its entire body silently deleted."

Ryan Wilson, Atlassian Community

同じ投稿は、15,000文字あったページをゼロにしてしまう呼び出しが、警告も確認プロンプトもなしに実行されると指摘している。

正当に評価すべき点として、Atlassianはこれを黙殺しなかった。Confluence MCPチームの開発者は翌日、チームが修正すると返信し、2026年7月には「先ごろリリースしたV2 MCPプレビューでは、Confluenceのページ編集の仕組みを、狙いを定めた粒度の細かい編集を使うように完全に書き直した」とフォローアップした。あなたがこれを読んでいるのがV2が広く展開された後であれば、この具体的な不具合は解消されているはずだ。

とはいえ、根底にある設計上の圧力は今も残っており、それが未解決イシューの一群を説明している。updateConfluencePageは編集のたびにページ本文全体を要求し、パッチや範囲指定のオプションはない。イシュー#106は、それが大規模な場面でどれほどのコストになるかを記録している。ADF本文は50〜70KBに達し、モデルはそれをまるごと保持してツール呼び出しの中で再出力しなければならず、Claude Codeは約20KBを超えるツール出力をディスクに永続化するため、コンテンツが作業コンテキストに届くことは決してない。関連する報告としては、インラインコメントのアンカーが削除される問題、画像と目次が消える問題、そしてエッジのCloudflareルールが原因でClaudeコネクタに生じる約5KBの書き込み上限がある。

さらに、Confluenceとはまったく関係なく、サインイン状態を維持することだけに関わる摩擦もある。これについてのAtlassianコミュニティのスレッドは16,500回以上閲覧されている。

"Atlassian MCP is unusable due to the longevity of their auth tokens. Needing to reauthenticate twice a working day is horrible. Why can;t I inject my personal access token into it; that is longlived and properly in control."

Jochem Berends, Atlassian Community

同じスレッドの別のユーザーは、おおよそ30分ごとに再認証が必要だと報告している。これはこのサーバーに関して最も引用される運用上の不満であり、手作りのAtlassian MCPサーバーという小さな家内産業が存在する理由でもある。

誰も最初にはチェックしない権限の天井

ここからは安心できる部分と、それに続いて人々の1週間を無駄にする部分だ。

アクセスはサインインしたユーザーの既存のConfluence権限に限定される。Atlassianは3つの別々の場所でこれを明言しており、サーバーは「サインインしたユーザーの権限の範囲内で動作し、その人が見ることを許可されているデータにのみアクセスする」とも述べている。制限されたスペースは見えないままだ。getConfluenceSpacesはそのアカウントがすでに開けるものだけを返す。MCPサーバーは権限昇格をまったく許していない。

この保証の代償は、回答の質がConfluenceに何が書かれているかではなく、接続したアカウントによって上限を決められてしまうという点だ。これは私がeeselのサポートキューで目にする最も一般的な誤警報であり、外から見ると権限の問題にはまったく見えない。顧客がConfluenceを接続し、92件のドキュメントがきれいにインデックスされるのを確認し、その後それらのドキュメントが明らかに答えられるはずの質問をして、何も返ってこない。どのダッシュボードも同期は成功したと表示している。実際に成功しているからだ。ページはずっとACLによって隠されていただけだ。私はeesel自身のエージェントが、まさにこの状態を同期障害だと誤診するのを見たことがある。これは役に立たないどころか害悪で、顧客はその後、決して壊れていなかった連携を再認可しに行ってしまうからだ。

3年間、実際の稼働中のサポートキューにAIを乗せてきた経験から、これを何よりも先にチェックすべきだと学んだ。検索結果がなぜか空に見えるとき、問うべきは「インデックスは機能しているか」ではない。「接続されたアカウントが実際に見られるものは何か」だ。

セキュリティレビューを担当する人に伝える価値のある関連ギャップが2つある。サーバーを特定のスペースに限定する方法がなく、これはリポジトリで最も議論されているイシューで23件のコメントがついている。つまり自分自身のアカウントを接続する管理者は、自分が編集できるすべてのスペースに対する管理者並みの到達範囲をエージェントに渡してしまうことになる。そしてAtlassianは、Rovo Chat、Agents、Searchが対応範囲に含まれる一方で、Rovo MCPはCLI、Chrome拡張機能、モバイル・デスクトップアプリとともにHIPAA対応範囲から除外されていると明言している。FedRAMP対応もない。

あなたのConfluenceがボトルネックであり、Claudeではない

これは大半のガイドが省略する部分であり、導入がうまくいくかどうかを決める部分でもある。

Hacker News、Reddit、G2を通じて、互いに同意する理由など何もない人々から、同じ発見が独立して繰り返し届いている。最も明快な一文は、AIとエンジニアリング業務についてのスレッドから来た。

"How can AI search into documentation, if the documentation is a thousands of obsolete and contradicting Jira tickets, few outdated Confluence pages with mail attachments and handful of excel files on SharePoint?"

ponector, Hacker News

あるエンジニアリングマネージャーは、私がずっと思い返している数字を挙げた。

"we had a confluence wiki with 400+ pages. nobody read it. nobody updated it. new hires were told 'the wiki has everything' and then spent a week being confused because the wiki was 60% outdated."

r/Notion, replacing a Confluence wiki

これを単なる愚痴以上のものにしているのは、同じ指摘が次にどこで現れるかだ。G2のRovoのリストはレビュー数わずか7件で5点満点中4.6となっているが、そこでの批判は満足しているレビュアーから来ている。5点満点中4点をつけたエンタープライズのSDETは、「最大の限界は、Rovoは元となるデータと同程度にしか効果を発揮できないということだ。ドキュメントが古く、一貫性がなく、不完全であれば、検索結果やAIが生成する洞察は必ずしも期待通りに正確で有用とは限らない」と書いている。別の月、別の業界にいたクラウドBIエンジニアも、独立して同じ結論にたどり着いた。

本当に重要な失敗モードは「AIが何も見つけられなかった」ではない。重複ページのケース、つまり同じポリシーの重なり合った3つのバージョンが存在し、モデルが自信満々に間違った方を選んでしまうケースだ。Hacker Newsの誰かは、Rovoが実際にConfluenceのコンテンツ上でこの純粋なバージョンをやらかしている場面、つまり誰かが単に大文字で書いただけの単語について、略語の展開形を捏造してしまう様子を捉えていた。

これは何ひとつClaudeのせいではなく、モデルを乗り換えても解決しない。だからこそConfluenceナレッジ統合のガイドは、コネクタよりもキュレーションに多くの時間を割いているし、Confluenceの代替を比較するチームは、移行してもそれが解決しないことにしばしば気づく。腐敗はついてくる。Confluence対SharePointを検討している場合や、n8n経由でページを連携している場合も同じだ。

RovoかClaudeか: どちらがあなたのConfluenceを読むべきか

Atlassian自身のAIはConfluenceの内部で動き、設定も不要なので、それが自然な比較対象になる。本当の違いはメーターの方だ。

クレジットの計算はここで具体的な話になる。Rovo Chatのクイックな回答は10クレジット、agentの実行は10クレジット、Deep Researchのクエリは100クレジットかかる。つまり月70クレジットのConfluence Premiumシートでは、チャットの回答7回分、あるいはDeep Researchのクエリの3分の2しか買えない。検索、要約、定義は無料でメーターに触れないため、これは日常的な利用にとってRovoの本当の強みだ。

公平のために2つ補足しておく。Atlassianは現時点では超過分を課金しておらず、課金開始前には90日の事前通知をすると約束しており、クレジットのダッシュボードがAdmin Hubに届くのは2026年8月からなので、今のところ誰も予想外の請求を受けることはない。そしてRovoのコネクタ一覧は幅広く、Google Drive、Slack、SharePoint、GitHub、その他約40のサードパーティソースをカバーしている。

私の見立てはこうだ。一日中Confluenceの中で暮らしていて、たまに質問する程度なら、Rovoで十分だし十分に無料だ。多くのページにわたって継続的な作業をするなら、MCP経由のClaudeの方が優れた道具だ。質問1回ごとのメーターに躊躇させられることがないからだ。さらに詳しくはConfluence検索AIとConfluence AIコパイロットで掘り下げており、セットアップの手順はConfluenceコパイロットにある。

実際にかかる費用

コネクタは無料だ。その下にあるものはすべて無料ではない。Confluence Cloudはユーザーあたりの累進的な価格体系で、人数を増やすほど1席あたりの単価は下がる。

この表の中で人々をつまずかせるものが2つある。Freeプランにはスペースやページの権限がまったく存在しないため、AI関連の何かをテストするには不向きな場所になっている。MCPアクセスを安全にする権限の絞り込みそのものが単に存在しないからだ。そしてRovoには検証済みのビジネスドメインが必要なので、コンシューマー向けメールドメインの組織では有効化できない。

書き留めておく価値のある期限もある。Confluence Data Centerは2029年3月28日に読み取り専用になる。より詳しい内訳はConfluenceの料金とConfluence AIの料金の記事を、両方を購入するつもりならJira料金ガイドも参照してほしい。

チャットウィンドウが回答の置き場所として不適切なとき

ここまでの話はすべて、回答を必要としている人物とClaudeに入力している人物が同一であることを前提にしている。それは多くの実際の仕事をカバーしている。決定事項を再構築するエンジニア、仕様をチケットに変換するPM、デプロイのランブックを探そうとする新入社員などだ。

これがカバーしていないのは、私が最も多くの時間を費やしているケース、つまりあなたの会社の外にいる誰かが、あなたのConfluenceがすでに答えている質問をしてくる場合だ。

12個のツールはすべてプル型だ。人がプロンプトを入力し、Claudeが取得し、回答がチャットに届く。この一式の中に、受信トレイを監視するもの、届いたチケットを読むもの、返信を送るものは何一つない。これはAtlassianの設計上の見落としではなく、まさにMCPサーバーというものの本来の目的だ。

2つ目の問題は、ウィキが回答の半分しか持っていないという点だ。注文がどこにあるか尋ねる顧客には、配送ポリシーと注文記録の両方が必要だ。有給休暇の残日数について尋ねる新入社員には、ポリシーと自分自身の残日数の両方が必要だ。Confluenceは前者だけを持っていて後者は何も持っていない。だからこそドキュメントだけから組み立てられたサポートの回答は、正しくて同時に役に立たないという状態になりがちだ。Confluenceエージェント型AIの記事で、そのギャップを埋めることが何を意味するかを詳しく解説しており、Confluenceエージェントを見つけるでは候補の絞り込みを扱っている。

あなたが対応している相手が社内の技術者であれば、ここで止まって構わない。Rovo MCPサーバーとClaudeの組み合わせは良い構成であり、私ならそれを使う。相手が顧客や、依頼を持ちかけてくる従業員であれば、キューの向こう側に何かを用意する必要がある。

Confluence向けのeesel AI

私はこの問題について、大半の人よりも長い付き合いがあり、しかも最初はあまり誇れるものではなかった。eeselの最初の本当の成長エンジンは、ChatGPT for Confluenceという名前のAtlassian Marketplaceアプリで、現在はAI for Confluenceという名前になっている。人々はクレジットカードの入力ステップなしにマーケットプレイスからそれをインストールし、そのまま払い続けてくれた。それが早い段階で私に教えてくれたのは、需要はより良いウィキ検索ボックスに対してあるのではないということだ。需要は、ウィキがわざわざ読みに行かなければならないものであることをやめることにある。

そこでeeselは逆の端から取り組んでいる。Rovo MCPサーバーがConfluenceを読むのと同じ方法でそれをインデックスし、それからヘルプデスク、Slack、あるいはチャットウィジェットに乗って、返信そのものを自分で下書きする。誰もClaudeを開く必要はない。自信がないときは、推測する代わりに出典を添えて人間に引き継ぐ。

上記の制約から直接導かれる3つのポイントがある。

• 本番投入前に、あなたの実際の過去の履歴に対してシミュレーションする。 私は自信ありげな口ぶりのボットが、古いページから静かに間違った回答を出しているのを目にしたことがある。まさにこの記事が説明している重複ページの失敗モードそのものだ。過去のチケットに対して先にロールアウトを走らせてみることが、顧客より先にそれを捕まえる唯一の方法だと私は知っている。
• Cloud専用ではない。 Rovo MCPサーバーにはData Centerへの道が存在せず、構造的に持つことができない。あなたのConfluenceが自己管理型であれば、それは公式コネクタにとっては完全な行き止まりだが、eeselにとってはそうではない。
• 料金は対応したタスクごとに0.40ドルで、チケットであろうとチャットセッションであろうと同じであり、席単位の料金もクレジットの上限を気にする必要もない。試すための50ドル分の無料利用枠があり、カードは不要だ。

ConfluenceとSlackでまさにこの構成を運用しているEUのHRコンプライアンス企業の開発ディレクターは、要件を率直にこう表現した。

"We needed a turnkey solution for Confluence that met our GDPR requirements and could serve different teams through dedicated Slack bots. eesel AI delivered exactly that, with EU data residency included."

同じくConfluenceを使っている決済企業のチーフイノベーションオフィサーは、回答を見つける作業と新入社員のオンボーディングで最大80%の時間削減を報告している。これがいつも取る2つの形だ。コンプライアンス寄りか、スピード寄りかのどちらかである。

他のツールについてこの比較のClaude側のバージョンが読みたいなら、私はClaude for Jira Service Management、Atlassian AIについてのより広い視点、そしてConfluenceロードマップアシスタントの記事を書いている。そして、その上に乗るAIではなくウィキ自体を検討しているなら、Confluence対Notionと私のConfluenceレビューから始めるとよい。