新版 AI 表格 MCP 上线啦 !
本次对外发布聚焦 AI 表格的核心能力，覆盖 AI 表格本体、数据表、字段、行记录、模板搜索 5 大类，共 19 个工具。
对比旧版预发 MCP：
新版从 14 个偏早期形态的工具，升级为 19 个面向 AI Agent 的标准化工具；
从“能做基础增删改查”升级为“能完成 AI 表格搭建、结构设计、批量写入、结构化查询、模板起表”的完整闭环。
﻿﻿
﻿
如何更新 AI 表格 MCP
1.登录钉钉 MCP 市场，找到 AI 表格 MCP https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail﻿
2.登录对应组织后，获取 MCP Server 配置，如下图：
﻿﻿
3.复制 StreamableHttp URL 发送给 OpenClaw 或钉钉机器人，执行 MCP 升级，这样就完成了升级操作啦！
﻿﻿
﻿﻿
﻿
一句话概览升级能力
新版钉钉 AI 表格 MCP 已支持：
●创建、查询、重命名、删除 AI 表格
●创建、读取、更新、删除数据表
●创建、读取、更新、删除字段
●批量新增、更新、删除、查询记录
●基于模板创建 AI 表格
●按关键词搜索 AI 表格
●记录级过滤、排序、分页、关键字检索
适合让 AI 直接完成“建库、建表、设计字段、写数据、查数据、改数据”的整套闭环。
﻿
本次升级，核心变化是什么
如果你用过旧版，会明显感受到这次升级主要体现在 5 个方面：
1. 工具体系从“零散能力”升级成“标准化工具集”
●旧版工具数：14
●新版工具数：19
●新版统一采用更稳定的 create_* / get_* / update_* / delete_* / query_* / search_* 命名
●资源定位统一收敛为 baseId / tableId / fieldId / recordId﻿
这意味着：
●模型更容易理解“下一步该调用哪个工具”
●用户看到工具名就能判断用途
●工具链路更适合做多步自动化，而不是一次一条零散调用
2. 从“按名称凑合调用”升级成“按稳定 ID 串联调用”
旧版很多工具仍依赖：
●﻿dentryUuid﻿
●﻿sheetIdOrName﻿
●﻿fieldIdOrName﻿
●﻿target﻿
●﻿filename﻿
新版统一提升为业务稳定语义：
●﻿baseId﻿
●﻿tableId﻿
●﻿fieldId﻿
●﻿recordId﻿
●﻿baseName / tableName / fieldName﻿
这意味着：
●AI 在多轮调用中更不容易串错对象
●改名后不容易丢上下文
●更适合复杂自动化、批量操作和后续链路复用
3. 从基础表格操作升级到“结构化查询 + 批量写入”
旧版记录能力主要是：
●新增记录
●分页列记录
●删除记录
●更新记录
新版进一步支持：
●﻿query_records 统一做记录读取
●按 recordIds 精准读取
●按 filters 过滤
●按 sort 排序
●按 cursor 分页
●按 keyword 搜索
●按 fieldIds 做字段裁剪
这意味着：
●不只是“把数据放进去”
●还可以让 AI 真正基于表格做筛选、检索、排序、决策和回写
4. 字段能力大幅扩展
●旧版公开字段类型：7 种
●新版公开字段类型：28 种
旧版以基础字段为主：
●﻿text﻿
●﻿number﻿
●﻿singleSelect﻿
●﻿multipleSelect﻿
●﻿date﻿
●﻿user﻿
●﻿attachment﻿
新版新增了大量业务常用字段：
●组织与协同：department、group﻿
●展示与交互：checkbox、url、richText﻿
●联系方式：telephone、email﻿
●身份与编码：idCard、barcode﻿
●度量与展示：currency、rating、progress﻿
●地理与文档：geolocation、primaryDoc﻿
●关联与系统字段：unidirectionalLink、bidirectionalLink、creator、lastModifier、createdTime、lastModifiedTime﻿
这意味着：
●新版不再只是“轻量台账”
●已经可以覆盖更真实的项目管理、销售跟进、运营台账、内容生产和业务流程场景
5. 从“能建表”升级到“能基于模板起表”
新版新增：
●﻿search_templates﻿
●﻿create_base 支持基于模板创建
这意味着：
●用户不一定要从零设计
●AI 可以先搜索模板，再快速起一个接近业务目标的表格结构
﻿
新老版本对比
对比项
旧版预发 MCP
新版 AI 表格 MCP
工具数量
14
19
工具风格
早期能力型工具，命名不统一
标准化 CRUD / Query / Search 工具体系
资源定位
﻿dentryUuid、sheetIdOrName、fieldIdOrName 混用
﻿baseId、tableId、fieldId、recordId 统一
表格管理
有基础能力
更完整，含 get_base、get_tables、批量详情
字段管理
新增 / 列出 / 删除为主
新增 / 详情 / 更新 / 删除完整闭环
记录查询
主要是分页列出
支持 ID 精读、过滤、排序、分页、关键词检索
模板能力
无
有 search_templates﻿
字段类型
7 种基础类型
28 种类型，覆盖更多真实业务场景
批量能力
相对弱
字段、记录、查询均有明确批量协议
Agent 友好度
一般
明显增强，更适合多步自动化
﻿
对比旧版，最直接感受到什么变化
●不再需要记忆 add_base_table / list_base_field / search_base_record 这类旧名字了
●可以直接让 AI “先创建表，再补字段，再批量写记录，再按条件查出来”
●可以做真正的结构化查询，而不只是翻页看数据
●可以设计更丰富的字段结构，而不局限于少量基础字段
●可以让 AI 基于模板快速开工，而不是每次从零搭
﻿
旧版到新版的理解映射
为了方便老用户迁移，可以简单这么理解：
●﻿create_base_app -> create_base﻿
●﻿search_accessible_ai_tables -> list_bases / search_bases﻿
●﻿add_base_table -> create_table﻿
●﻿list_base_tables -> get_base / get_tables﻿
●﻿update_base_tables -> update_table﻿
●﻿delete_base_table -> delete_table﻿
●﻿add_base_field -> create_fields﻿
●﻿list_base_field -> get_tables / get_fields﻿
●﻿delete_base_field -> delete_field﻿
●﻿add_base_record -> create_records﻿
●﻿search_base_record -> query_records﻿
●﻿delete_base_record -> delete_records﻿
●﻿update_records -> update_records﻿
升级后的新版 MCP ，能做什么
1. AI 表格全生命周期管理
●获取 AI 表格列表：list_bases﻿
●按关键词搜索 AI 表格：search_bases﻿
●创建 AI 表格：create_base﻿
●获取 AI 表格目录信息：get_base﻿
●更新 AI 表格名称：update_base﻿
●删除 AI 表格：delete_base﻿
●搜索模板：search_templates﻿
适用场景：
●让 AI 先查找已有业务表，再决定复用还是新建
●按模板快速起一个项目管理表、客户跟进表、运营台账
●在流程结束后自动清理测试表或临时表
2. 数据表管理
●创建数据表：create_table﻿
●获取数据表详情：get_tables﻿
●更新数据表名称：update_table﻿
●删除数据表：delete_table﻿
适用场景：
●在一个 AI 表格里拆分“需求池 / 任务池 / 版本计划 / 复盘记录”等多张表
●由 AI 自动初始化表结构，而不是手工逐张新建
●批量生成业务子表，例如“按地区建表”“按项目建表”
3. 字段设计与演进
●创建字段：create_fields﻿
●获取字段详情：get_fields﻿
●更新字段：update_field﻿
●删除字段：delete_field﻿
适用场景：
●让 AI 先搭一个最小表结构，再随着需求补字段
●给已有表补充状态、负责人、日期、金额、评分等字段
●自动调整单选/多选枚举项
●做“表结构迁移”或“字段标准化整理”
4. 行记录 CRUD 与结构化查询
●新增记录：create_records﻿
●更新记录：update_records﻿
●删除记录：delete_records﻿
●查询记录：query_records﻿
适用场景：
●AI 批量写入任务、客户、线索、库存、内容选题
●按条件筛选高优先级事项、即将到期任务、某状态记录
●对表格数据做分页读取、按 ID 精准读取、按关键字搜索
●让 AI 对记录做持续更新，而不是一次性写死
﻿
已发布工具清单
AI 表格
●﻿list_bases﻿
●﻿search_bases﻿
●﻿create_base﻿
●﻿get_base﻿
●﻿update_base﻿
●﻿delete_base﻿
●﻿search_templates﻿
数据表
●﻿create_table﻿
●﻿get_tables﻿
●﻿update_table﻿
●﻿delete_table﻿
字段
●﻿create_fields﻿
●﻿get_fields﻿
●﻿update_field﻿
●﻿delete_field﻿
记录
●﻿create_records﻿
●﻿update_records﻿
●﻿delete_records﻿
●﻿query_records﻿
﻿
支持的字段类型
当前发布版本支持在 create_table / create_fields 中声明以下字段类型：
基础字段
●﻿text 文本
●﻿number 数字
●﻿date 日期
●﻿currency 货币
●﻿checkbox 勾选
●﻿url 链接
●﻿richText 富文本
●﻿telephone 电话
●﻿email 邮件
●﻿idCard 身份证
●﻿barcode 条码
●﻿geolocation 地理位置
枚举与评分进度
●﻿singleSelect 单选
●﻿multipleSelect 多选
●﻿rating 评分
●﻿progress 进度
人员与组织
●﻿user 人员
●﻿department 部门
●﻿group 群组
关联与附件
●﻿attachment 附件
●﻿unidirectionalLink 单向关联
●﻿bidirectionalLink 双向关联
文档与系统字段
●﻿primaryDoc 文档
●﻿creator 创建人
●﻿lastModifier 最后编辑人
●﻿createdTime 创建时间
●﻿lastModifiedTime 最后编辑时间
高级能力
●﻿formula 公式
﻿
记录查询能力
﻿query_records 是这版里非常实用的核心工具，支持：
●按 recordIds 精准读取
●按 filters 做结构化过滤
●按 sort 排序
●按 cursor 分页遍历
●按 keyword 做全文关键词匹配
●按 fieldIds 做字段投影，减少返回体积
已公开的过滤操作包括：
●通用：eq、ne、exist、un_exist﻿
●数值：lt、gt、lte、gte﻿
●文本：contain、exclusive﻿
●多选：all_of、any_of、none_of﻿
●日期：date_eq、before、after、not_before、not_after、from_now、date_between﻿
﻿
典型应用场景
项目管理 / 研发协作
●AI 自动创建“需求池、开发排期、测试计划、上线清单”
●用 singleSelect 管状态，用 date 管截止时间，用 user 管负责人
●用 query_records 找出“本周到期 + 未完成”的事项
销售 / CRM 跟进
●创建客户表、商机表、跟进记录表
●用 currency 管金额，用 progress 管商机阶段，用 multipleSelect 管标签
●批量导入线索，按状态和金额做筛选与排序
运营台账 / 数据采集
●用 AI 快速搭建活动台账、投放台账、门店巡检台账
●通过 create_records 批量写入数据
●通过 query_records 做分页读取和条件过滤
内容生产 / 选题库
●设计“选题、负责人、发布时间、渠道、素材链接、审核状态”等字段
●用 richText 写内容说明，用 url 挂素材链接
●用 AI 持续更新内容进度和审核状态
表结构治理
●让 AI 先读取已有表结构，再补字段、改字段名、扩枚举项
●用 get_tables + get_fields 做结构审查
●用 update_field 做字段配置演进
﻿
已知边界与使用建议
字段与结构边界
●﻿create_table 单次最多附带 15 个字段
●﻿create_fields 单次最多创建 15 个字段
●﻿get_tables 单次最多获取 10 张表
●﻿get_fields 单次最多获取 10 个字段
●﻿create_records / update_records / delete_records 单次最多 100 条
●﻿query_records 单次最多返回 100 条；fieldIds / recordIds 单次最多 100 个
已知字段边界
●﻿formula 当前存在“not supported yet”的边界，调用前不要默认可用
●关联字段创建依赖目标表底层约束，即使传了 linkedSheetId，也可能因目标表条件不满足而失败
●﻿primaryDoc 只能放在第一列使用
删除保护
●删除字段时，禁止删除主字段
●删除字段时，禁止删除最后一个字段
●删除数据表时，如果它是 Base 内最后一张表，会删除失败
协议使用建议
●跨调用引用资源时，优先使用 baseId / tableId / fieldId / recordId﻿
●记录写入时使用 cells﻿
●查询字段详情时，推荐先 get_tables 拿字段目录，再用 get_fields 按需展开
﻿
适合怎么向 AI 下指令
你可以直接让 AI 做类似这些事情：
●“帮我创建一个项目排期表，包含任务名称、负责人、优先级、截止日期、状态”
●“在这个 base 里新建一张客户表，再补充金额、跟进阶段、负责人字段”
●“把这 50 条任务批量写入表格，并按优先级排序读回来”
●“筛选出本周到期但状态不是 Done 的记录”
●“把 Status 字段新增一个枚举值 Lost，并保留现有选项不丢失”
﻿
本次发布范围说明
本公告仅覆盖 ability.json 中已发布的 19 个工具。
未出现在 ability.json 的能力，不属于本次对外发布范围，不建议在用户群公告中一并宣传。