MCP Atlassian

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

プログレッシブフォークプロファイル

このフォークは、アップストリームの直接的なAtlassian MCPサーフェスを維持し、MCP_PROFILE=progressive によって制御されるローカルのプログレッシブプロファイルを追加します。プログレッシブモードでは、サーバーは完全な直接ツールサーフェスの代わりに、jira_discover、jira_capability_schema、jira_execute_read、jira_execute_write_guarded などのディスカバリ/スキーマ/実行ラッパーのみを公開します。

アップストリームの sooperset/mcp-atlassian には現在このプログレッシブレイヤーが含まれていないため、アップストリームの更新は選択的に調整する必要があります。アップストリームを盲目的にマージすると、プログレッシブパッケージやテストが削除される可能性があります。FORK_WORKFLOW.md を参照してください。

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

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

Related MCP server: MCP Atlassian

クイックスタート

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": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Centerユーザー: JIRA_USERNAME + JIRA_API_TOKEN の代わりに JIRA_PERSONAL_TOKEN を使用してください。詳細は認証を参照してください。

Autohand Code

同じ uvx サーバーをAtlassianの認証情報で使用します：

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  JIRA_USERNAME=your.email@company.com \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  CONFLUENCE_USERNAME=your.email@company.com \
  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 で入手できます。

ドキュメントは llms.txt形式 でも提供されており、LLMが簡単に利用できます：

• llms.txt — ドキュメントサイトマップ

• llms-full.txt — 完全なドキュメント

互換性

主要ツール

合計98ツール — 完全なリストはツールリファレンスを参照してください。

セキュリティ

APIトークンを共有しないでください。.env ファイルを安全に保管してください。SECURITY.mdを参照してください。

コントリビューション

開発環境のセットアップについてはCONTRIBUTING.mdを参照してください。

ライセンス

MIT - LICENSEを参照してください。Atlassian公式製品ではありません。