kickflow-mcp-server by kickflow - MCP Server

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: 監査ログの一覧を取得します。

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: 指定したワークフローを取得します

開発者向け

セットアップ

リポジトリをクローン:

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

依存パッケージのインストール:
```
npm install
```
ビルド:
```
npm run build
```

開発

開発サーバーの実行

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

npm run dev

(開発時も KICKFLOW_ACCESS_TOKEN 環境変数の設定が必要です)

テストの実行

# ユニットテストを実行
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

kickflow/kickflow-mcp-server