wisegrid-mcp

WiseGrid MCP

Claude、Cursor、または任意の MCP クライアントからWiseGridのシートを読み書きできます。シートの一覧表示、行のページ送り、レコードの追加と更新、レポートの実行を会話の中から行えます。

このファミリーの他のサーバーと異なり、これらのツールは実際のデータを操作するため、API キーが必要です。

インストール

{
  "mcpServers": {
    "wisegrid": {
      "command": "uvx",
      "args": ["wisegrid-mcp"],
      "env": {
        "WISEGRID_API_KEY": "wg_live_xxx"
      }
    }
  }
}

または pip install wisegrid-mcp を実行します。

変数	必須	用途
WISEGRID_API_KEY	はい	WiseGrid の「Settings」で作成します
WISEGRID_BASE_URL	いいえ	セルフホストインスタンスの URL を上書きします

このツールでアクセスできる範囲は、キーのスコープによって決まります。エージェントに参照のみさせる場合は、読み取り専用のスコープを付与してください。

ツール

ツール	機能
whoami	キーの ID、スコープ、レート制限を確認します。デバッグ時は最初に呼び出してください
list_sheets	キーから参照できるシートをカーソルページネーションで取得します
get_sheet	シート、列、最初のページの行を一度の呼び出しで取得します
list_columns	セルの辞書でキーとして使う列 ID を取得します
list_rows	行をカーソルページネーションで取得します。各行には更新に必要な version が含まれます
add_rows	一括挿入します。一部成功に対応し、最大 2000 件です
update_row	1 行の変更されたセルをバージョンチェック付きで更新します
update_rows	行ごとにバージョンチェックを行い、一括更新します。最大 2000 件です
delete_row	行とそのサブツリーを削除します。confirm=True が必要です
list_reports / get_report / run_report	レポートとその行を取得します

知っておかないと困ること

セルのキーには列名ではなく列 ID を使います。 {"Client": "Acme Corp"} ではなく、{"101": "Acme Corp"} のように指定します。先に get_sheet または list_columns を呼び出してください。

更新時にはバージョンチェックが行われます。 すべての行に version が含まれます。読み取ったバージョンを渡し、その間に行が変更されていた場合は、上書きが黙って行われる代わりに version_conflict が返されます。これは通常起こりうる結果なので、適切に処理してください。行を再読み込みし、変更がまだ適用できるか判断してから再試行します。バージョンをむやみに増やして書き込みを強制すると、同時編集が失われます。

update_row はマージし、update_rows は上書きします。 単一行用のツールには、変更したセルだけを渡します。一括更新用のツールは行のセル一式を置き換えるため、更新後に行に含めたいセルをすべて渡してください。

delete_row は子行も削除します。 行とそのサブツリー全体を削除します。この操作は API から元に戻せません。そのため confirm=True が必要です。先に行を読み取ってください。

書き込みは冪等です。 書き込みごとに Idempotency-Key が付与されるため、タイムアウト後に再試行しても二重適用されません。レート制限には Retry-After に従って対応します。

開発

git clone https://github.com/RyanKramer/wisegrid-mcp
cd wisegrid-mcp
pip install -e .
WISEGRID_API_KEY=wg_live_xxx wisegrid-mcp

概要

WiseGrid が開発しました。REST API の完全なリファレンスは wisegrid.co/docs/api をご覧ください。

MIT ライセンスです。