confluence

Confluence 管理スキル

Claude Code を通じて Confluence ドキュメントを管理します。ページを Markdown にダウンロードしたり、画像を含む大きなドキュメントをアップロードしたり、形式を相互変換したり、Mermaid／PlantUML 図を統合したりできます。

目次

• クイック判断マトリックス
• MCP のサイズ制限
• 前提条件
• 主要なワークフロー
• リファレンスドキュメント

クイック判断マトリックス

タスク	ツール	備考
ページの読み取り	MCP ツール	confluence_get_page、confluence_search
小規模なテキストのみのアップロード（<10KB）	MCP ツール	confluence_create_page、confluence_update_page
大きなドキュメント（>10KB）	upload_confluence_v2.py	REST API、サイズ制限なし
画像を含むドキュメント	upload_confluence_v2.py	添付ファイルを自動的に処理します
Git から Confluence への同期	mark CLI	CI/CD ワークフローに最適です
ページを Markdown にダウンロード	download_confluence.py	マクロを変換し、添付ファイルをダウンロードします

MCP のサイズ制限

MCP ツールにはアップロードのサイズ制限（10～20KB）があります。大きなドキュメントや画像を含むページには、upload_confluence_v2.py を介して REST API を使用してください。

# Upload large document
python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id 780369923

# Dry-run preview
python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id 780369923 --dry-run

MCP はページの読み取りには使えますが、大きなコンテンツのアップロードには使えません。

前提条件

必須

• Atlassian MCP Server（mcp__atlassian-evinova）と Confluence の認証情報

任意

• mark CLI：Git から Confluence への同期（brew install kovetskiy/mark/mark）
• Mermaid CLI：図のレンダリング（npm install -g @mermaid-js/mermaid-cli）

主要なワークフロー

ページを Markdown にダウンロード

# Single page
python3 ~/.claude/skills/confluence/scripts/download_confluence.py 123456789

# With child pages
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --download-children 123456789

# Custom output directory
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --output-dir ./docs 123456789

詳細はダウンロードガイドを参照してください。

画像を含むページをアップロード

1. まず design-doc-mermaid または plantuml スキルを使って図を画像に変換します
2. 標準的な Markdown で画像を参照します：![Description](./images/diagram.png)
3. REST API 経由でアップロードします：

python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id PAGE_ID

詳細は画像の取り扱いに関するベストプラクティスを参照してください。

Confluence を検索

mcp__atlassian-evinova__confluence_search({
  query: 'space = "DEV" AND text ~ "API"',
  limit: 10
})

ページの作成／更新（小規模なドキュメント）

// Create page
mcp__atlassian-evinova__confluence_create_page({
  space_key: "DEV",
  title: "API Documentation",
  content: "h1. Overview\n\nContent here...",
  content_format: "wiki"
})

// Update page
mcp__atlassian-evinova__confluence_update_page({
  page_id: "123456789",
  title: "Updated Title",
  content: "h1. New Content",
  version_comment: "Updated via Claude Code"
})

Git から同期（mark CLI）

Markdown ファイルにメタデータを追加します：

# API Guide
Content...

Confluence に同期します：

mark -f documentation.md
mark --dry-run -f documentation.md  # Preview first

詳細はmark ツールガイドを参照してください。

形式を相互変換

変換方法の完全な一覧は変換ガイドを参照してください。

クイックリファレンス：

Markdown	Wiki Markup
# Heading	h1. Heading
**bold**	*bold*
*italic*	_italic_
`code`	{{code}}
[text](url)	[text|url]

リファレンスドキュメント

詳しいガイドは references/ ディレクトリにあります。

ガイド	目的
Wiki Markup リファレンス	Confluence Wiki Markup の完全な構文
変換ガイド	Markdown から Wiki Markup への変換ルール
ストレージ形式	Confluence XML ストレージ形式の詳細
画像の取り扱い	画像、Mermaid、PlantUML のワークフロー
mark ツールガイド	mark CLI を使った Git から Confluence への同期
トラブルシューティング	よくあるエラーと解決方法

利用可能な MCP ツール

ツール	説明
confluence_search	CQL またはテキストで検索
confluence_get_page	ID またはタイトルでページを取得
confluence_create_page	新しいページを作成
confluence_update_page	既存のページを更新
confluence_delete_page	ページを削除
confluence_get_page_children	子ページを取得
confluence_add_label	ページにラベルを追加
confluence_get_labels	ページのラベルを取得
confluence_add_comment	ページにコメントを追加
confluence_get_comments	ページのコメントを取得

ユーティリティスクリプト

スクリプト	目的
scripts/upload_confluence_v2.py	画像を含む大きなドキュメントをアップロードします
scripts/download_confluence.py	ページを Markdown にダウンロードします
scripts/convert_markdown_to_wiki.py	Markdown を Wiki Markup に変換します
scripts/convert_wiki_to_markdown.py	Wiki Markup を Markdown に変換します
scripts/render_mermaid.py	Mermaid の図をレンダリングします

---

バージョン: 2.1.0 | 最終更新日: 2025-01-21