SteveとConfluenceの連携

概要

Confluenceは、AtlassianのRovo MCPサーバーを指す外部MCPコネクターとしてSteveに接続します。接続後、Steveはスペースを検索し、ページの内容をバトルカード、Canvasブロック、Insights返信に取り込めます。

必要なのはURL1つ、APIトークン1つ、メールアドレス1つ。そしてAtlassianの組織管理者が先に有効化しなければならない設定が1つあります。設定が失敗するのは、ほぼ必ずこの設定です。

対象者: 📣 PMM / Steve組織マネージャー — ステップ1にはAtlassian組織管理者が必要です。

必要なもの

接続情報

atlassian.com のURLでは、SteveはHTTP Basicに自動的に切り替えます。Atlassianが完全なツールセットを返すのはこの方式のみだからです。旧 /v1/sse エンドポイントは非推奨です。/v1/mcp を使用してください。

ステップ1：APIトークン認証を有効化する（Atlassian組織管理者）

これが本当のブロッカーです。 Rovo MCPは既定でOAuth 2.1が有効、Allow API token authentication が無効です。SteveはAPIトークンで認証するため、組織管理者が有効化するまで最初のリクエストで必ず失敗します。ツールも取得できず、コネクターも接続されません。

1. admin.atlassian.com にサインインします。
2. 組織を選択します（複数ある場合）。
3. Rovo → Rovo MCP server を開きます。
4. Authentication（認証）セクションで Allow API token authentication をオンにします。

同じ画面は Security → Rovo MCP server からも開けます。

キャプション：Rovo → Rovo MCP server → Authentication。Steveが接続するには Allow API token authentication をオンにする必要があります。

ステップ2に進む前に、必ずオンになっていることを確認してください。この設定がオフのままだと、正しいトークンでも失敗し、エラーはトークン不正の場合とまったく同じに見えます。

ステップ2：APIトークンを作成する

1. Steveに使わせるアカウントでサインインし、id.atlassian.com/manage-profile/security/api-tokens を開きます。
2. Create API token をクリックします。スコープの選択を求められたら、Confluenceの読み取りスコープを含めます（Steveにページの作成・編集をさせる場合のみ書き込みスコープを追加）。
3. 後で判別できる名前を付けます（例：Steve MCP connector）。
4. トークンをその場でコピーします。Atlassianは一度しか表示しません。

個人アカウントではなく、共有のサービスアカウントを使用してください。 トークンはそのアカウントのConfluence権限を引き継ぎます。Steveが見られるのは、そのアカウントが見られるスペースとページだけです。個人のトークンは、その担当者が退職した時点で機能しなくなります。

ステップ3：Steveにコネクターを追加する

1. 設定 → コネクター（または /settings#connectors）を開きます。
2. コネクターを追加をクリックします。
3. ダイアログを入力します。

4. 追加をクリックします。

キャプション：アカウントメール欄はURLがAtlassianのものになると表示されます。メールとトークンの両方が必須です。

Steveが接続して tools/list を呼び出し、コネクターを接続済みとして保存します。**「Confluence を接続しました · 25件のツールを検出」**のようなトーストが表示されます。トークンは暗号化して保存され、ブラウザーには返されません。

ステップ4：有効化する

接続しただけでは何も起きません。コネクターの詳細パネルで範囲を指定します。

1. 使用プロジェクト → ＋ 追加 → Confluenceを使うプロジェクトを選択。
2. 使用機能 → ＋ 追加 → バトルカード作成、Canvas、Insights replies から選択。
3. ツール権限 → 必要なものを許可し、それ以外はブロック。

詳細は設定と管理を参照してください。

推奨するツール権限

Rovo MCPは同じ接続でJira、Compass、Bitbucketのツールも公開します。不要なものはブロックするか、上部のドロップダウンを常に拒否にして上記の行だけを許可してください。

キャプション：読み取りは許可、書き込みはブロック。ドキュメントソースとしての安全な既定値です。

生成プロンプトの例

コネクターの生成プロンプト欄に次のように入力すると、Steveが適切な場面でWikiを参照します。

「ポジショニングや価格に関する質問に答える前に、searchConfluenceUsingCql で製品Wikiを確認すること。Confluence由来の記述には必ずページタイトルとURLを併記すること。」

トラブルシューティング

追加直後に「認証に失敗しました」と表示される

まずステップ1を確認してください。トークンよりもこちらが原因であることの方が多いです。次に、アカウントメールがトークンを作成したアカウントと一致しているか、トークンが失効していないかを確認します。

接続済みなのにSteveがConfluenceを参照しない

範囲指定が漏れている可能性が高いです。使用中の機能に対応するプロジェクトチップと機能チップの両方があること、読み取り系ツールが許可になっていることを確認してください。

Atlassian側の変更後にツールが消えた

⋯ メニュー → 接続テストを実行します。認証情報を再検証してツール一覧を更新し、許可／ブロックの設定は維持されます。

コネクターが「要対応」のままになる

このグループのコネクターは生成時にスキップされます。接続テストで現在のエラーを確認し、上の表と突き合わせてください。

期待される結果

• ✅ Atlassian組織のRovo MCPサーバー設定で Allow API token authentication がオン
• ✅ Confluence コネクターが接続済みに表示され、ツールが一覧される
• ✅ コネクターにプロジェクトチップと機能チップが1つ以上ある
• ✅ Confluenceの読み取り系ツールが許可、書き込み系は意図しない限りブロック

次のステップ

• 設定と管理 — プロジェクト、機能、ツール、プロンプトの詳細。
• 概要 — コネクターが動作する場所。
• コネクターを追加する — 他のMCPサーバーを追加する一般的な手順。