MCP Atlassian

MCP Atlassian

Atlassian 製品（Confluence および Jira）向けの Model Context Protocol（MCP）サーバーです。Cloud と Server/Data Center の両方のデプロイメントに対応しています。

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence デモ

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

クイックスタート

1. API トークンを取得する

https://id.atlassian.com/manage-profile/security/api-tokens にアクセスして、トークンを作成します。

Server/Data Center の場合は、代わりに Personal Access Token を使用してください。詳しくは認証をご覧ください。

2. IDE を設定する

Claude Desktop または Cursor の MCP 設定に追加します。

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center ユーザーの場合：JIRA_USERNAME と JIRA_API_TOKEN の代わりに JIRA_PERSONAL_TOKEN を使用してください。詳しくは認証をご覧ください。

Autohand Code

Atlassian の認証情報を使用して、同じ uvx サーバーを利用します。

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  [email protected] \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  [email protected] \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

設定を現在のプロジェクト内に保持するには、add の後に --scope project を追加します。最新のインストール方法と CLI の詳細については、Autohand Codeをご覧ください。

3. 使い始める

AI アシスタントに次のように依頼します。

• 「PROJ プロジェクトで自分に割り当てられた課題を検索して」
• 「Confluence でオンボーディング資料を検索して」
• 「ログインの問題についてバグチケットを作成して」
• 「PROJ-123 のステータスを Done に更新して」

ドキュメント

完全なドキュメントは mcp-atlassian.soomiles.com でご覧いただけます。

LLM が簡単に利用できる llms.txt 形式のドキュメントもあります。

• llms.txt — ドキュメントのサイトマップ
• llms-full.txt — ドキュメントの全文

トピック	説明
インストール	uvx、Docker、pip、ソースからのインストール
認証	API トークン、PAT、OAuth 2.0
設定	IDE の設定、環境変数
HTTP トランスポート	SSE、streamable-http、マルチユーザー
ツールリファレンス	Jira と Confluence のすべてのツール
トラブルシューティング	よくある問題とデバッグ

互換性

製品	デプロイメント	サポート
Confluence	Cloud	完全対応
Confluence	Server/Data Center	対応（v6.0 以降）
Jira	Cloud	完全対応
Jira	Server/Data Center	対応（v8.14 以降）

主なツール

Jira	Confluence
jira_search - JQL で検索	confluence_search - CQL で検索
jira_get_issue - 課題の詳細を取得	confluence_get_page - ページのコンテンツを取得
jira_create_issue - 課題を作成	confluence_create_page - ページを作成
jira_update_issue - 課題を更新	confluence_update_page - ページを更新
jira_transition_issue - ステータスを変更	confluence_add_comment - コメントを追加

合計 98 個のツール — 全ツールの一覧はツールリファレンスをご覧ください。

セキュリティ

API トークンは絶対に共有しないでください。.env ファイルは安全に保管してください。詳しくは SECURITY.md をご覧ください。

貢献

開発環境のセットアップについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT - LICENSE をご覧ください。Atlassian の公式製品ではありません。