Skip to main content
Glama

kSQL アクション — 設定のオーサリング(tools と MCP)

kintone プラグイン 「kSQL アクション」(rex0220 kSQL Action) の設定を、AI(Claude)が要望から作り・直すための環境です。 作った設定は、利用者がプラグインの設定画面で 設定をアップロード → 保存 → 運用環境に反映 して使います。

  • AI は kintone に書き込みません。 読むのは項目定義などの GET だけで、取り込みと実行は必ず人が画面で行います。

  • 検査はプラグイン本体と同じコードを使います。 設定の形・SQL(kSQL の Flow dialect 1)・テーブルへの書き戻し(APPLY)・計算式の検査は、 利用者が持っているプラグインの zip に同梱された「オーサリング API」(config_js/ksql-action-authoring-api.js)を読み込んで呼びます。 このリポジトリに有償プラグインのコードは入っていません。

  • 配り方は 2 つ: Claude Code のプラグイン(ツール名の接頭辞は kact_)と、Claude Desktop の .mcpb。

要るもの

もの

置き場所

備考

kSQL アクションプラグインの zip

利用者が配布元から入手したもの

.env の KACT_PLUGIN_ZIP(または MCP の設定項目)で場所を指定

kintone の接続のファイル

作業フォルダーの外

kSQL の ksql.config.json と同じ形。アプリごとの閲覧だけの API トークン

Node

20 以上

Related MCP server: Kintone Development Support MCP Server

使い方(概要)

  1. 作業フォルダーを用意し、MCP(または CLI)を登録する。

  2. AI に作りたいアクションを伝える(「受注を顧客ごとに集計して、集計アプリのテーブルに書き戻したい」など)。

  3. AI が項目定義を読み、SQL と計算式を組み立て、本体と同じ検査を通してから設定ファイルを保存する。

  4. 利用者が設定画面で取り込み、保存し、運用環境に反映して、ボタンを押して確かめる。

このリポジトリの中身

フォルダー

中身

src/

tools の中核(zip の読み取り、エンジンとオーサリング API の読み込み、検査の呼び出し)と MCP サーバー

vendor/

zip に入っていない moment(プラグインは CDN から読むため、tools は自前で持つ)

docs/

手順と資料(kact_docs が返すもの)

ライセンス

MIT(LICENSE)。zip から読み込む kSQL アクションプラグインと計算式エンジンのコードはこのリポジトリには含まれません。

Related MCP Connectors

Related MCP Servers