convez.ai
MCP ServerIntegração & APIsIntermediário
kickflow

Kickflow MCP Server

kickflow/kickflow-mcp-server

Integração oficial Kickflow com Model Context Protocol

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP oficial que integra a API Kickflow com Claude Desktop, Cursor e outras ferramentas compatíveis. Fornece acesso a todas as operações da plataforma Kickflow (gerenciamento de tickets, categorias e workflows) através de três ferramentas genéricas: descoberta de APIs, consulta de informações e execução de chamadas.

Instalação

$npx convez-ai kickflow/kickflow-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
2
Saúde
50%
Último commit
há 1 dia
Versão
v1.5.7
Issues abertas
2
Contribuidores
10

Casos de uso

  • Automatizar gerenciamento de tickets e categorias no Kickflow via Claude
  • Consultar esquema e documentação de APIs Kickflow dentro do contexto do Claude
  • Orquestrar workflows Kickflow em conversas com assistentes de IA

Veredito

MCP server robusto e bem-documentado que expõe completamente a API Kickflow. Arquitetura limpa com ferramentas de descoberta, introspecção e execução torna a integração prática para usuários e desenvolvedores.

README

A tradução para o português deste README ainda está na fila.

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

開発者向け

セットアップ

  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

Ver o original no GitHub

Bom para

Relacionados