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サーバーは3つの汎用ツールを提供し、kickflow APIのすべての機能にアクセスできます。

discover_apis

利用可能なKickflow APIの一覧を表示します。get_api_info、call_apiで使用するoperationIdを確認できます。

get_api_info

指定したoperationIdのAPI情報をJSON Schemaで取得します。call_apiを呼ぶ前に必要なパラメータを確認できます。

call_api

Kickflow APIを実行します。operationId、pathParams、queryParams、requestBodyをそれぞれ個別に指定してAPIを呼び出します。

使用例

1. discover_apis でAPIの一覧を確認

結果例:

listCategories: カテゴリの一覧を取得
createCategory: カテゴリを作成
getTicket: チケットを取得
...

2. get_api_info で必要なパラメータを確認

入力例:

{
  "operationId": "getTicket"
}

結果例:

{
  "pathParams": {
    "type": "object",
    "properties": {
      "ticketId": { "type": "string", "format": "uuid" }
    },
    "required": ["ticketId"]
  }
}

3. call_api でAPIを実行

パラメータなしの例:

{
  "operationId": "listCategories"
}

パスパラメータありの例:

{
  "operationId": "getTicket",
  "pathParams": {
    "ticketId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

クエリパラメータありの例:

{
  "operationId": "listTickets",
  "queryParams": {
    "page": 1,
    "perPage": 25
  }
}

リクエストボディありの例:

{
  "operationId": "createCategory",
  "requestBody": {
    "name": "新しいカテゴリ"
  }
}

開発者向け

セットアップ

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

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

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

   npm install
   

3. ビルド:

   npm run build
   

開発

開発サーバーの実行

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

npm run dev

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

テストの実行

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

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

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

Lint と型チェック

# vp lint によるコードチェック（Type-Aware Linting により型チェックも同時に行われる）
npm run lint

OpenAPI型定義の更新

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

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

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

ライセンス

MIT