Atlassian MCP

Model Context Protocol に基づくカスタムサーバーで、AIエージェントがAtlassian Cloud上のJiraおよびConfluenceと対話できるようにします。バックグラウンドでは、Jira REST API v3 と Confluence REST API v2 を使用してプレーンなREST呼び出しを行います。

セットアップ

1. 依存関係をインストールしてビルドします:

   npm install
   npm run build

2. サーバーをグローバルコマンドとして公開し、任意のワークスペースから起動できるようにします (package.json の bin エントリを使用):

   npm link

   これにより、atlassian-mcp コマンドが PATH に追加されます。コードを変更したら npm run build を再実行してください。リンクされたコマンドは常に現在の dist を指します。

3. https://id.atlassian.com/manage-profile/security/api-tokens でAPIトークンを作成します。

4. 環境変数で資格情報を指定します (.env.example を参照):

   変数	説明
   ATLASSIAN_SITE_URL	サイトのURL。例: https://your-domain.atlassian.net
   ATLASSIAN_EMAIL	Atlassianアカウントのメールアドレス
   ATLASSIAN_API_TOKEN	上記で作成したAPIトークン

Related MCP server: jira-mcp

クライアントの接続

VS Code (推奨)

このリポジトリには標準の .vscode/mcp.json が同梱されています。このサーバーは、ログイン + 対話型zsh (zsh -lic) を介して起動されるため、~/.zshrc (または ~/.zshenv) でエクスポートされたAtlassianの資格情報を継承します — 設定ファイルにシークレットは含まれません — また、グローバルにリンクされた atlassian-mcp コマンドを呼び出すため、開いているリポジトリに関係なく動作します:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

ここでは ${workspaceFolder} を避けてください。これは現在開いているリポジトリに解決されるため、他のワークスペースからサーバーを使用すると壊れてしまいます。代わりに、npm link コマンド名はシェルの PATH から解決されます。

サーバーをすべてのワークスペースで利用できるようにするには、同じ servers ブロックをユーザーレベルのMCP設定に追加します (コマンドパレット → MCP: Open User Configuration)。

代替案: 絶対パスで node を実行

npm link を使いたくない場合は、ワークスペースごとに変わる ${workspaceFolder} ではなく、絶対パスを使用してビルドされたエントリファイルを直接 node で指定します。VS Code の ${userHome} 変数を使用すると、マシン間で移植性が保たれます:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

リポジトリを別の場所にクローンした場合は、パスを調整してください。zsh -lic ラッパーは引き続きシェルプロファイルから資格情報を提供します。

設定ファイルの代わりに、シェルプロファイルで変数をエクスポートします:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

シェルプロファイルを変更したら、VS Codeウィンドウをリロードして、新しい値が反映されるようにしてください。

その他のクライアント (Claude Desktop, Cline, Cursor)

シェルを介して起動しないクライアントは、同じ zsh -lic ラッパーを使用するか、変数を明示的に設定できます:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

npm link を使用しない場合は、ビルドされたエントリファイルへの絶対パスを指定して node を使用します:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

ローカル開発では、npm run dev を使用してサーバーを直接実行できます。

ツール

Jira

Confluence