kickflow MCP Server

kickflow API をModel Context Protocol (MCP)経由で利用するためのサーバーです。

ユーザー向け

必要条件

• Node.js v22.18.0以上

• kickflow アクセストークン

  • アクセストークンの取得方法

インストール

MCPクライアント（Claude Desktop, Cursor, Clineなど）の構成ファイル (claude_desktop_config.json など) に、以下のような記述を追加してください。 KICKFLOW_ACCESS_TOKEN には、取得したアクセストークンを設定してください。

MacOS/Linux

{
  "mcpServers": {
    "kickflow": {
      "command": "npx",
      "args": ["-y", "@kickflow/mcp-server"],
      "env": {
        "KICKFLOW_ACCESS_TOKEN": "your-kickflow-access-token"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "kickflow": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kickflow/mcp-server"],
      "env": {
        "KICKFLOW_ACCESS_TOKEN": "your-kickflow-access-token"
      }
    }
  }
}

機能一覧

このMCPサーバーは以下のツールをカテゴリ別に提供します:

Audit Logs

• list_audit_logs: 監査ログの一覧を取得します。

Categories

• list_categories: カテゴリの一覧を取得します

• create_category: カテゴリを作成します

• delete_category: カテゴリを削除します

• update_category: カテゴリを更新します

Comments

• list_comments: チケットのコメント一覧を取得します

• create_comment: チケットにコメントを投稿します

• get_comment: チケットのコメントを取得します

• update_comment: チケットのコメントを更新します

• delete_comment: チケットのコメントを削除します

Folders

• list_folders: フォルダの一覧を取得します

• create_folder: フォルダを作成します

• delete_folder: フォルダを削除します

• update_folder: フォルダを更新します

• get_folder: フォルダを一件取得します

General Master Items

• list_general_master_items: 汎用マスタアイテムの一覧を取得します

• create_general_master_item: 汎用マスタアイテムを作成します

• get_general_master_item: 汎用マスタアイテムを一件取得します

• update_general_master_item: 汎用マスタアイテムを更新します

• delete_general_master_item: 汎用マスタアイテムを削除します

General Masters

• list_general_masters: 汎用マスタの一覧を取得します

• create_general_master: 汎用マスタを作成します

• get_general_master: 汎用マスタを一件取得します

• update_general_master: 汎用マスタを更新します

• delete_general_master: 汎用マスタを削除します

Grades

• list_grades: 役職の一覧を取得します

• create_grade: 役職を作成します

• get_grade: 役職を一件取得します

• delete_grade: 役職を削除します

• update_grade: 役職を更新します

• set_default_grade: 指定した役職をデフォルトにします

Organization Charts

• list_organization_charts: 組織図の一覧を取得します

• create_organization_chart: 組織図を作成します

• delete_organization_chart: 組織図を削除します

• get_organization_chart: 組織図を一件取得します

• update_organization_chart: 組織図を更新します

• get_current_organization_chart: 現在有効になっている組織図を取得します

• activate_organization_chart: 指定した組織図を有効化します

Proxy Applicants

• list_proxy_applicants: 代理申請の一覧を取得します

• create_proxy_applicant: 代理申請を作成します

• delete_proxy_applicant: 指定した代理申請を削除します

Proxy Approvers

• list_proxy_approvers: 代理承認の一覧を取得します

• create_proxy_approver: 代理承認を作成します

• delete_proxy_approver: 指定した代理承認を削除します

Roles

• list_roles: 管理者ロールの一覧を取得します

• create_role: 管理者ロールを作成します

• get_role: 管理者ロールを一件取得します

• update_role: 管理者ロールを更新します

• delete_role: 管理者ロールを削除します

• create_role_members: 管理者ロールにメンバーを追加します

• list_role_members: 管理者ロールのメンバー一覧を取得します

• delete_role_member: 管理者ロールからメンバーを削除します

Routes

• list_routes: 経路の一覧を取得します

• get_route: 指定した経路を取得します

Teams

• list_teams: 指定した組織図内のチーム一覧を取得します

• create_team: 指定した組織図内にチームを作成します

• get_team: チームを一件取得します

• update_team: チームを編集します

• delete_team: チームを削除します

• list_team_members: チームのメンバー一覧を取得します

• create_team_members: 指定したチームにメンバーを追加します

• delete_team_members: 指定したチームからメンバーを削除します

• update_team_member: チームのメンバーを更新します

Ticket Links

• list_ticket_links: 指定したチケットの関連チケットを取得します

Tickets

• get_ticket: 指定したチケットの詳細情報を取得します

• list_tickets: チケットの一覧を取得します

• approve_ticket: チケットを承認または確認します

• reject_ticket: チケットを差し戻します

• deny_ticket: チケットを却下します

• withdraw_ticket: 自分が作成したチケットを取り下げます

• archive_ticket: チケットをアーカイブします

• list_tasks: 承認リクエスト一覧を取得します

Users

• get_current_user: 現在のユーザーを取得します

• list_users: ユーザー一覧を取得します

• create_user: ユーザーを作成（招待）します

• get_user: ユーザーを一件取得します

• delete_user: ユーザーを削除します

• update_user: ユーザーを更新します

• lookup_user_by_email: メールアドレスからユーザーを取得します

• reinvite_user: 削除されたユーザーを再び招待します

• suspend_user: 有効なユーザーを一時停止します

• reactivate_user: 一時停止中のユーザーを有効化します

• list_user_teams: ユーザーの所属チーム一覧を取得します

• list_user_roles: ユーザーの管理者ロール一覧を取得します

Viewers

• list_viewers: チケットの共有ユーザー一覧を取得します

• create_viewer: チケットに共有ユーザーを追加します

• delete_viewer: チケットの共有ユーザーを削除します

Workflows

• list_workflows: ワークフローの一覧を取得します

• get_workflow: 指定したワークフローを取得します

開発者向け

セットアップ

1. リポジトリをクローン:

   git clone [リポジトリURL]
   cd kickflow-mcp-server

2. 依存パッケージのインストール:

   npm install

3. ビルド:

   npm run build

開発

開発サーバーの実行

変更を監視し、自動的に再ビルドしてサーバーを再起動します。

npm run dev

(開発時も

テストの実行

# ユニットテストを実行
npm run test

# ウォッチモードでテストを実行（ファイル変更時に自動再実行）
npm run test:watch

# MCP Inspector でサーバーをデバッグ
npm run test:inspector

Lint と型チェック

# ESLint によるコードチェック
npm run lint

# TypeScript の型チェック
npm run typecheck

OpenAPI型定義の更新

kickflow APIのスキーマから TypeScript の型定義を更新するには:

# 公開されている最新版のスキーマを取得
npm run update-schema

# Orvalを使って型定義を生成
npm run generate-api

ライセンス

MIT