Atlassian 公式のリモート MCP サーバで Confluence/Jira を操作する

普段、仕事ではドキュメント管理に Confluence を使っている。全社的には Google ドキュメントも使っているけど、見た目やドキュメントの検索のしやすさを考えると Confluence のほうが好み。

だけどあまり活用も整理もされてないのが悩み。 GitHub Copilot とかでなんとかできないかなぁと思っていたところ、Atlassian 公式の Confluence と Jira を GitHub Copilot Agent mode や Claude Desktop から扱えるリモート MCP サーバが公開されていることに気づいた。

https://www.atlassian.com/ja/blog/remote-mcp-server

この発表記事から辿れるページを見てもやり方わからなかった。そのせいでコメント欄には野良 MCP を使った方法がたくさん投稿される始末。

ドキュメント管理サービスを提供しているならドキュメントから用意してほしいところだけど、リモート MCP サーバの設定方法は他の記事に載っていた。

https://community.atlassian.com/forums/Atlassian-Platform-articles/Atlassian-Remote-MCP-Server-beta-now-available-for-desktop/ba-p/3022084

ということで Atlassian 公式の MCP サーバがどんな風に使えるか試してみた。

MCP Tools

Atlassian MCP サーバで使える Tools (Copilot などから使える機能) は色々ある。

認証・基本情報

atlassianUserInfo - 現在の Atlassian ユーザ情報を取得
getAccessibleAtlassianResources - アクセス可能な Atlassian リソース (cloudId) を取得

Confluence

ページ管理

createConfluencePage - 新しい Confluence ページを作成
updateConfluencePage - 既存の Confluence ページを更新
getConfluencePage - 特定のページを取得
getPagesInConfluenceSpace - 指定したスペース内のページ一覧を取得

スペース管理

getConfluenceSpaces - Confluence スペース一覧を取得

ページ階層

getConfluencePageAncestors - ページの祖先（親ページ）を取得
getConfluencePageDescendants - ページの子孫（子ページ）を取得

コメント機能

createConfluenceFooterComment - ページにフッターコメントを追加
createConfluenceInlineComment - ページにインラインコメントを追加
getConfluencePageFooterComments - ページのフッターコメント一覧を取得
getConfluencePageInlineComments - ページのインラインコメント一覧を取得

検索

searchConfluenceUsingCql - CQL（Confluence Query Language）を使ってコンテンツ検索

Jira

課題管理

createJiraIssue - 新しい Jira 課題を作成
editJiraIssue - 既存の Jira 課題を更新
getJiraIssue - 特定の課題の詳細を取得
transitionJiraIssue - 既存の Jira 課題のステータスを更新

プロジェクト・メタデータ

getVisibleJiraProjects - アクセス可能な Jira プロジェクト一覧を取得
getJiraProjectIssueTypesMetadata - プロジェクトの課題タイプメタデータを取得

ワークフロー

getTransitionsForJiraIssue - 課題で利用可能な遷移（ステータス変更）を取得

コメント・リンク

addCommentToJiraIssue - 課題にコメントを追加
getJiraIssueRemoteIssueLinks - 課題のリモートリンク（Confluenceリンクなど）を取得

検索・ユーザ

searchJiraIssuesUsingJql - JQL（Jira Query Language）を使って課題検索
lookupJiraAccountId - ユーザの表示名やメールアドレスからアカウント ID を検索

事前準備

GitHub MCP サーバなどの場合は認証に必要なトークンは VS Code や Claude Desktop の設定ファイルに記録されるけど、Atlassian MCP サーバの場合はローカルで動かした mcp-remote というパッケージを中継することでトークンなどを設定ファイルに残さずリモート MCP サーバに繋ぐらしい。

ということでローカルに Node.js と mcp-remote のインストールが必要。

npm i mcp-remote

GitHub Copilot Agent mode の MCP 設定

GitHub Copilot Agent mode から Atlassian MCP サーバを使うには VS Code の設定ファイルに以下を追加する。

{
    "mcp": {
        "servers": {
            "atlassian": {
                "command": "npx",
                "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
            }
        }
    }
}

設定ファイルから Atlassian MCP サーバを起動するとブラウザで Atlassian の認証画面が表示されるので、Copilot が Atlassian のアカウントを利用できるように権限付与を承認する。