MCP Multi Jira

🚀 mcp-multi-jira

複数アカウント対応のJira MCPサーバーです。複数のAtlassian Jiraアカウントを設定し、アカウントエイリアスによってツール呼び出しをルーティングします。

🚀 クイックスタート

まず、アカウントを設定します。

npx -y mcp-multi-jira login Work
npx -y mcp-multi-jira login Personal

次に、お好きなコーディングエージェントにMCPをインストールします。

npx -y mcp-multi-jira install

以上です！コーディングエージェントまたはIDEを再起動して、新しいMCPサーバーを適用します。

✨ 主な機能

ほとんどのJira MCP設定は単一アカウントですが、以下のようなアカウントを頻繁に切り替える必要がある場合、不便に感じることがあります。

• 仕事用と個人用のJira
• 複数のクライアント/テナント
• 異なる権限を持つ別々のJiraサイト

このプロジェクトは、複数のJiraアカウントを保持できる単一のMCPサーバーを提供し、明示的なaccountパラメーターを介してすべてのツール呼び出しをルーティングすることを目的としています（つまり、プロンプトで異なるアカウントを使用するように指示しながら、エージェントの設定を安定させることができます）。

このプロジェクトには以下のような機能があります。

• オプションの暗号化またはOSキーチェーンによるトークン保存
• 一般的なMCPクライアント（Cursor、Claude Code、Codex CLI）と互換性がある
• サポートされるエージェントに対するMCP設定の自動インストール

📦 インストール

アカウントのログイン

mcp-multi-jira login WorkJira

アカウントの一覧表示

mcp-multi-jira list

サーバーの起動

（注: インストールコマンドを使用すると、エージェントによってサーバーは自動的に起動されます）

mcp-multi-jira serve

サポートされるエージェントへのMCP設定のインストール

mcp-multi-jira install

💻 使用例

基本的な使用法

# アカウントのログイン
mcp-multi-jira login WorkJira

# アカウントの一覧表示
mcp-multi-jira list

# サーバーの起動
mcp-multi-jira serve

# サポートされるエージェントへのMCP設定のインストール
mcp-multi-jira install

高度な使用法

トークン保存方法の変更

デフォルトでは、トークンは平文ファイルに保存されます。暗号化またはOSキーチェーンを使用するには、以下のコマンドでデフォルトのバックエンドを一度設定します。

# オプション: plain (デフォルト), encrypted, keychain
mcp-multi-jira token-store encrypted

暗号化された保存方法を使用する場合、環境にマスターパスワードが設定されていることを確認してください。そうでないと、MCPの起動に失敗します。

export MCP_JIRA_TOKEN_PASSWORD="your-master-password"

平文のトークンは~/.mcp-jira/tokens.jsonに保存されます（共有マシンでは使用しないでください）。

トークン保存方法を切り替え、既存のアカウントがある場合、CLIはトークンを新しいバックエンドに移行するように促します。

OAuthクライアントの上書き

export MCP_JIRA_CLIENT_ID="your-client-id"
export MCP_JIRA_CLIENT_SECRET="your-client-secret"

エージェントの手動設定

エージェントの設定を自動インストールすることができます。

mcp-multi-jira install

以下は、高度な設定のための手動設定のスニペットです。

Cursor

~/.cursor/mcp.json（またはプロジェクトごとの.cursor/mcp.json）:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "npx",
      "args": ["-y", "mcp-multi-jira", "serve"]
    }
  }
}

Claude Code

~/.claude/mcp_servers.json:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "npx",
      "args": ["-y", "mcp-multi-jira", "serve"]
    }
  }
}

OpenAI Codex CLI

~/.codex/config.toml:

[mcp_servers.mcp_jira]
command = "npx"
args = ["-y", "mcp-multi-jira", "serve"]