Skip to main content
Glama
kickflow

kickflow MCP Server

Official
by kickflow
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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_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": "新しいカテゴリ"
  }
}

Related MCP server: Procesio MCP Server

開発者向け

セットアップ

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

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

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

    npm install

  3. ビルド:

    npm run build

開発

開発サーバーの実行

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

npm run dev

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

環境変数による設定

接続先や送信ヘッダーは、必要に応じて環境変数で変更できます（いずれも任意）。

環境変数

説明

KICKFLOW_API_BASE_URL

接続先のベースURL。未指定時は https://api.kickflow.com

KICKFLOW_ACCESS_TOKEN_HEADER

アクセストークンを送信するヘッダー名。未指定時は Authorization

KICKFLOW_API_HEADERS

全リクエストに付与する追加ヘッダー（JSON形式の文字列）

KICKFLOW_API_HEADERS='{"X-Example-Header":"value"}' \
KICKFLOW_ACCESS_TOKEN=your-token \
npm run dev

テストの実行

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

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • PacedLoop MCP Server

    gvfullstack
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with the hosted PacedLoop API to manage workflows and monitor process runs. It provides tools for workflow CRUD operations, run execution management, and access to detailed performance analytics within MCP-capable clients.
    -