Jira MCP Server（無料プラン対応）

MCPクライアント（Claude Desktop、または任意のMCPクライアント）がJiraの課題を読み取り、作成、更新、コメント、ステータス遷移できるようにする小さなMCPサーバーです。Jira Cloudの無料プランで構築・テスト済みです。有料のJiraサブスクリプションは不要です。

公開するツール

1. 無料のJira Cloudサイトを取得

1. https://www.atlassian.com/software/jira にアクセスしてサインアップします（無料、最大10ユーザー、プロジェクト無制限）。

2. プロジェクトを作成し、そのプロジェクトキー（例: PROJ）をメモします。プロジェクト名の横に表示されます。

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

2. 依存関係をインストール

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. 認証情報を設定

.env.example を .env にコピーして値を入力するか、またはシェルで直接エクスポートします：

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. 直接テストする（Claude Desktopは不要）

test_client.py の先頭にある PROJECT_KEY / ISSUE_KEY を自分のJiraプロジェクトに合わせて編集し、次を実行します：

python test_client.py

これにより、jira_server.py がstdio経由のサブプロセスとして起動し（実際のMCPクライアントと同じ方法）、利用可能なツールを一覧表示し、実際のJiraサイトに対して get_issue、search_issues、create_issue を実行します。

5. Claude Desktopに接続する（任意）

これをClaude DesktopのMCP設定（claude_desktop_config.json — 設定 → 開発者 → 設定を編集）に追加します：

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Desktopを再起動し、「PROJ-1のステータスは？」のように尋ねてみてください。get_issue ツールが呼び出されるはずです。

注意点 / 落とし穴

• Jiraのv3 APIは、説明とコメントをプレーンテキストではなくAtlassian Document Format（ADF）で保存します。サーバーが双方向の変換を処理します。

• create_issue の issue_type は、そのプロジェクトで設定されているタイプ（通常は Task、Bug、Story、Epic）と完全に一致する必要があります。「issuetype」エラーが発生した場合は、プロジェクトの課題タイプを確認してください。

• 無料プランでは自動化の実行回数が月100回、ストレージが2 GBに制限されています。この種の手動/APIテストには関係ありませんが、知っておく価値はあります。

• このサーバーはstdioトランスポートを使用するため、ローカルでのみ実行され、通信するMCPクライアントによって起動されます。公開Webサービスではなく、これがMCPをテストする最もシンプルで一般的な方法です。