Backlog MCP

Backlog API アクセス用 Model Context Protocol (MCP) サーバー

概要

このパッケージは、Backlog API と連携して課題管理やプロジェクト管理を行うための MCP (Model Context Protocol) サーバーを提供します。AI アシスタントから Backlog の機能を利用するためのインターフェースとして機能します。

使用方法

API キーの取得

1. Backlog にログイン
2. 個人設定 > API > API キーの発行
3. 発行された API キーをコピー

MCPクライアント（ Claude Desktop や VSCode 等）から npx で直接実行

以下MCPサーバーを設定ファイル（ Claude Desktop であれば claude_desktop_config.json ）に追加

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": ["-y", "@kawano_r102/backlog-mcp"],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

利用可能なツール

プロジェクト関連

• getProjects - プロジェクト一覧を取得
• getProjectStatuses - プロジェクトの状態一覧を取得
• getProjectCategories - プロジェクトのカテゴリー一覧を取得
• getProjectVersions - プロジェクトのマイルストーン一覧を取得
• getProjectUsers - プロジェクトのユーザー一覧を取得

課題関連

• createIssue - 課題を作成
• updateIssue - 課題を更新
• deleteIssue - 課題を削除
• getIssues - 課題一覧を取得
• getIssueTypes - 課題種別一覧を取得
• getPriorities - 優先度一覧を取得

ツールリファレンス

プロジェクト関連ツール

getProjects

• プロジェクト一覧を取得します
• 入力:
  • archived (boolean, オプション): アーカイブ状態（true: アーカイブ済み, false: アーカイブなし, 省略: すべて）
  • all (boolean, オプション): すべてのプロジェクト取得（true: すべて, false: 参加中のみ）
• 戻り値: プロジェクト一覧

getProjectStatuses

• プロジェクト固有の課題に設定できる状態一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクトIDまたはキー
• 戻り値: 状態一覧

getProjectCategories

• プロジェクトに登録されているカテゴリー一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクトIDまたはキー
• 戻り値: カテゴリー一覧

getProjectVersions

• プロジェクトに登録されているマイルストーン(バージョン)一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクトIDまたはキー
• 戻り値: マイルストーン一覧

getProjectUsers

• プロジェクトのユーザー一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクトIDまたはキー
  • excludeGroupMembers (boolean, オプション): グループを介してプロジェクトに参加しているメンバーを除外する
• 戻り値: ユーザー一覧

課題関連ツール

createIssue

• 課題を作成します
• 入力:
  • projectId (number): 課題を登録するプロジェクトのID
  • summary (string): 課題の件名
  • issueTypeId (number): 課題の種別のID
  • priorityId (number): 課題の優先度のID
  • parentIssueId (number, オプション): 課題の親課題のID
  • description (string, オプション): 課題の詳細
  • startDate (string, オプション): 課題の開始日 (yyyy-MM-dd)
  • dueDate (string, オプション): 課題の期限日 (yyyy-MM-dd)
  • estimatedHours (number, オプション): 課題の予定時間
  • actualHours (number, オプション): 課題の実績時間
  • categoryId (number[] | number, オプション): 課題のカテゴリーのID（複数指定可）
  • versionId (number[] | number, オプション): 課題のバージョンのID（複数指定可）
  • milestoneId (number[] | number, オプション): 課題のマイルストーンのID（複数指定可）
  • assigneeId (number, オプション): 課題の担当者のユーザーのID
  • notifiedUserId (number[] | number, オプション): 課題の追加の通知を受け取るユーザーのID（複数指定可）
  • attachmentId (number[] | number, オプション): 添付ファイルのID（複数指定可）
• 戻り値: 作成された課題

updateIssue

• 課題を更新します
• 入力:
  • issueIdOrKey (string): 課題IDまたはキー
  • summary (string, オプション): 課題の件名
  • parentIssueId (number, オプション): 親課題のID
  • description (string, オプション): 課題の詳細
  • statusId (number, オプション): 課題の状態のID
  • resolutionId (number, オプション): 課題の完了理由のID
  • startDate (string, オプション): 課題の開始日（yyyy-MM-dd）
  • dueDate (string, オプション): 課題の期限日（yyyy-MM-dd）
  • estimatedHours (number, オプション): 課題の予定時間
  • actualHours (number, オプション): 課題の実績時間
  • issueTypeId (number, オプション): 課題の種別のID
  • categoryId (number[] | number, オプション): 課題のカテゴリーのID（複数指定可）
  • versionId (number[] | number, オプション): 課題のバージョンのID（複数指定可）
  • milestoneId (number[] | number, オプション): 課題のマイルストーンのID（複数指定可）
  • priorityId (number, オプション): 課題の優先度のID
  • assigneeId (number, オプション): 課題の担当者のユーザーのID
  • notifiedUserId (number[] | number, オプション): 課題の追加の通知を受け取るユーザーのID（複数指定可）
  • attachmentId (number[] | number, オプション): 添付ファイルのID（複数指定可）
  • comment (string, オプション): コメント
• 戻り値: 更新された課題

deleteIssue

• 課題を削除します
• 入力:
  • issueIdOrKey (string): 課題IDまたはキー
  • projectIdOrKey (string, オプション): プロジェクトIDまたはキー
  • comment (string, オプション): 削除理由などのコメント
• 戻り値: 削除結果

getIssues

• 課題一覧を取得します
• 入力:
  • projectId (number[] | number | string[] | string, オプション): プロジェクトのID（複数指定可）
  • issueTypeId (number[] | number | string[] | string, オプション): 課題の種別のID（複数指定可）
  • categoryId (number[] | number | string[] | string, オプション): 課題のカテゴリーのID（複数指定可）
  • versionId (number[] | number | string[] | string, オプション): 課題のバージョンのID（複数指定可）
  • milestoneId (number[] | number | string[] | string, オプション): 課題のマイルストーンのID（複数指定可）
  • statusId (number[] | number | string[] | string, オプション): 課題の状態のID（複数指定可）
  • priorityId (number[] | number | string[] | string, オプション): 課題の優先度のID（複数指定可）
  • assigneeId (number[] | number | string[] | string, オプション): 課題の担当者のユーザーのID（複数指定可）
  • createdUserId (number[] | number | string[] | string, オプション): 課題の登録者のユーザーのID（複数指定可）
  • resolutionId (number[] | number | string[] | string, オプション): 課題の完了理由のID（複数指定可）
  • parentChild (number, オプション): 親子課題の条件（0:すべて、1:子課題以外、2:子課題、3:親子どちらでもない、4:親課題）
  • attachment (boolean, オプション): 添付ファイルの有無（true:あり、false:なし）
  • sharedFile (boolean, オプション): 共有ファイルの有無（true:あり、false:なし）
  • sort (string, オプション): ソート項目（例: updated, created, dueDate）
  • order (string, オプション): ソート順（asc:昇順、desc:降順）
  • offset (number, オプション): 取得開始位置
  • count (number, オプション): 取得件数（最大100件）
  • createdSince (string, オプション): 登録日の期間開始日（yyyy-MM-dd）
  • createdUntil (string, オプション): 登録日の期間終了日（yyyy-MM-dd）
  • updatedSince (string, オプション): 更新日の期間開始日（yyyy-MM-dd）
  • updatedUntil (string, オプション): 更新日の期間終了日（yyyy-MM-dd）
  • startDateSince (string, オプション): 開始日の期間開始日（yyyy-MM-dd）
  • startDateUntil (string, オプション): 開始日の期間終了日（yyyy-MM-dd）
  • dueDateSince (string, オプション): 期限日の期間開始日（yyyy-MM-dd）
  • dueDateUntil (string, オプション): 期限日の期間終了日（yyyy-MM-dd）
  • id (number[] | number | string[] | string, オプション): 課題のID（複数指定可）
  • parentIssueId (number[] | number | string[] | string, オプション): 親課題のID（複数指定可）
  • keyword (string, オプション): 検索キーワード
• 戻り値: 課題一覧

getIssueTypes

• プロジェクトの課題種別一覧を取得します
• 入力:
  • projectIdOrKey (string): プロジェクトIDまたはキー
• 戻り値: 課題種別一覧

getPriorities

• 課題に設定できる優先度の一覧を取得します
• 入力: なし
• 戻り値: 優先度一覧

ライセンス

ISC

作者

kawano_r102