Skip to main content
Glama
kickflow
by kickflow

kickflow MCP Server

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


ユーザー向け

必要条件

インストール

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_infocall_apiで使用するoperationIdを確認できます。

get_api_info

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

call_api

Kickflow APIを実行します。operationIdpathParamsqueryParamsrequestBodyをそれぞれ個別に指定して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

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kickflow/kickflow-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server