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	否	为可自托管实例指定覆盖值

密钥的作用域决定这些工具可以访问哪些内容。如果你只想让 Agent 查看数据，请授予只读作用域。

工具

工具	功能
whoami	查看密钥的身份、作用域和速率限制——调试时先调用此工具
list_sheets	列出密钥可查看的表格，使用游标分页
get_sheet	一次调用即可获取表格、列和第一页行
list_columns	列 ID，单元格字典以此为键
list_rows	列出行，使用游标分页；每行都包含更新时需要的 version
add_rows	批量插入，支持部分成功，最多 2000 行
update_row	更新单行中有变化的单元格，并检查版本
update_rows	批量更新，逐行检查版本，最多 2000 行
delete_row	删除一行及其子树——需要 confirm=True
list_reports / get_report / run_report	报告及其行

否则可能遇到的问题

单元格以列 ID 而非列名为键。 应使用 {"101": "Acme Corp"}，而不是 {"Client": "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 许可。