Atlassian MCP v1→v2 で Confluence の更新はこう変わったHow Confluence Updates Changed from Atlassian MCP v1 to v2
匿名の公開いいねです。記事の保存・お気に入りではなく、Featured、Top 3、重要度、掲載順位には影響しません。仕組みとプライバシーAnonymous public likes are reactions, not saved articles or bookmarks. They do not affect Featured, Top 3, importance, or listing order.How it works and privacy
- Atlassian MCP v2は、Confluenceページをノード単位で差分更新でき、保存前の確認、同時編集の衝突検知、添付ファイルとラベルの操作にも対応した。
- 全文再送によるトークン消費や画像・コメント消失の危険を抑え、安全な文書保守を可能にする。
Atlassian MCP v2 adds node-level Confluence updates, pre-save review, conflict detection, and attachment and label handling, enabling safer, leaner agent-driven maintenance.
本ページの本文と要約は AI による自動生成です。日本語版と英語版は言語ごとに独立して生成されるため、表現や詳しさが異なる場合があります。正確性は元記事 (zenn.dev) をご確認ください。The body and summaries are AI-generated independently for each language, so wording and detail may differ. Verify accuracy at the original source (zenn.dev).
要約と収集メタデータに基づく AI 解説。元記事全文の転載・翻訳ではありません。AI explainer based on the summaries and collected metadata, not a copy or translation of the full source article.
Atlassian MCPサーバーv2では、Confluenceページの更新が全文の置き換えからノード単位の部分編集へ変わった。保存前の確認や編集競合の検知も加わり、エージェントによる文書更新で生じていた負担や危険を抑えられるようになった。
v1の全置換
v1はシンプルな新規ページの作成には便利だった一方、既存ページを更新する手段は本文の全置換に限られていた。更新時には全文を取得し、編集したうえで、再び全文を送信する必要があるため、消費トークン量がかさんでいた。
全置換では、ページに貼られた画像を復元できなかったり、インラインコメントがアンカーを失って表示されなくなったりする危険もあった。このため、更新のたびに何かが消えていないかを人が数えて確認する作業が発生していた。
ノード単位の編集
v2では、対象となるノードを指定し、ページの一部分だけを編集できる。全文を取得して送り直す方式ではないため、変更箇所に絞った差分更新が可能になり、v1で問題になっていたトークン消費や、画像・コメントを損なう危険を抑えられる。
また、添付ファイルとラベルも操作対象になった。議事録、設計メモ、運用手順などをエージェントに下書きさせ、MCPサーバー経由でページ化する使い方において、更新時に扱える範囲が広がっている。
保存前と競合検知
v2には、変更結果を保存前に確かめる手段が用意された。さらに、ほかの人による編集との競合を検知する仕組みも入っている。部分編集、事前確認、競合検知を組み合わせることで、既存ページを保守する際にv1で生じていた問題の多くが解消されたとされる。
GAと移行時期
changelogでは、v2は2026-07-01にプレビューとなり、2026-09-08にGAとなった。v1は2027-03-01に自動でv2のツールを見るようになると説明されている。
移行期には、どちらへ接続しているか分かりにくい場合がある。Claude Codeでは接続先のURLを表示できるため、検証に入る前に接続先を確認することが重要になる。
How Confluence Updates Changed
Atlassian MCP v2 changes how agents can update Confluence pages, making document maintenance safer and leaner. This matters when Confluence holds substantial amounts of material such as meeting minutes, design notes, and operational procedures, with agents drafting content and turning it directly into pages through the Atlassian MCP server.
Confluence Updates in v1
In v1, creating a simple new page was convenient, but updating an existing page required replacing its entire body. The agent had to retrieve the full text, edit it, and send the complete text back, increasing token consumption even when only a small change was needed.
Full replacement also introduced risks. Images attached to a page could fail to be restored, while inline comments could lose their anchors and stop appearing. As a result, each update required a manual check to confirm that nothing had disappeared.
Node-Level Confluence Updates
V2 adds node-level updates, allowing an agent to edit only the relevant part of a page instead of resending the full body. It also provides a way to review the result before saving and includes conflict detection for cases where another person has edited the page.
Attachments and labels can also be handled through v2. Together, these changes address many of the problems encountered with v1 and reduce both token consumption and the danger of losing images or comments during agent-driven maintenance.
Preview and GA
According to the changelog, Atlassian MCP v2 entered preview on 2026-07-01 and became generally available on 2026-09-08. V1 is expected to begin seeing v2 tools automatically on 2027-03-01, so users will eventually need to transition.
During this period, it may not always be obvious which version a connection is using. Checking the destination first can clarify the setup; in Claude Code, a command can display the connected URL.
ポコとTECHガイドPoko & TECH Guide
ポコと当サイトのTECHガイドが、記事の要約と収集した情報から読みどころを語るAI生成の対話です。Poko and TECH Dashboard's own TECH Guide discuss the article's highlights in an AI-generated conversation based on its summary and collected source details.
- ポコPoko議事録や運用手順をエージェントに直してもらうとき、普段の作業はどう変わるの？When an agent edits meeting notes or operating procedures, what changes in the day-to-day workflow?
- TECHガイドTECH Guideこの記事では、ページ内のまとまりであるノードだけを直し、保存前に確認できるようになったそうじゃ。競合検知や添付・ラベル操作にも対応しておる。The article says agents can edit just a node—a section within the page—and show the result before saving. They can also detect conflicts and handle attachments and labels.
- ポコPokoへえ、すごい！前のv1では、必要な部分だけ直したり、保存前に確認したりできなかったの？Wow, that’s great! Couldn’t v1 edit only the part you needed or let you review changes before saving?
- TECHガイドTECH Guide検証では、v1の既存ページ更新は本文の全置換だけじゃった。全文の再送でトークンを使い、画像やインラインコメントが失われる危険もあったのう。In the test, v1 could only replace the entire body of an existing page. Resending everything used more tokens and risked losing images or inline comments.
- ポコPokoつまり一番の収穫は、全部を書き直さず、必要な場所だけを確認しながら安全に更新しやすくなったことだね！So the biggest win is being able to update only what’s needed, review it, and avoid rewriting the whole page. That sounds much safer!
- TECHガイドTECH Guideそうじゃな。本文では、まず接続先のURLを見て、v1とv2のどちらにつながっているか確認するよう勧めておるよ。Exactly. The piece recommends checking the connection URL first, since it may be unclear whether you’re connected to v1 or v2.
