Dingtalk Ai Table

核心功能与用法

dingtalk-ai-table 是钉钉官方推出的AI表格（多维表）MCP技能，通过mcporter CLI连接钉钉MCP Server，提供企业级数据管理能力。核心采用四层ID体系：Base（多维表空间）、Table（数据表）、Field（字段）、Record（记录），完全替代旧版dentryUuid/sheetIdOrName方案。

典型工作流：先list_bases/search_bases定位Base → get_base获取Table目录 → get_tables展开表结构 → get_fields读取字段配置 → 最后执行query_records/create_records等记录操作。支持批量操作：字段创建（单次≤15）、记录增删改（单次≤100）。

显著优势

• 官方背书：钉钉原生MCP服务，API稳定性与长期维护有保障
• 完整CRUD：覆盖Base/Table/Field/Record全生命周期，支持模板建表
• 批量高效：字段批量创建、CSV/JSON数据导入脚本，降低重复劳动
• 类型完备：支持text、number、singleSelect、multipleSelect、telephone等丰富字段类型

局限与风险

• 令牌敏感：Streamable HTTP URL含访问令牌，泄露即等于密码外泄
• 沙箱限制：文件操作受OPENCLAW_WORKSPACE限制，仅支持工作区内.json/.csv
• ID依赖：强依赖baseId/tableId/fieldId/recordId，无友好名称查询能力
• 选项过滤门槛：singleSelect/multipleSelect过滤必须用option ID而非名称，学习成本高

适合人群

• 钉钉企业用户、数据管理员、低代码开发者
• 需要自动化表格操作、批量数据迁移的运维人员
• 构建AI Agent对接企业数据源的开发者

安全建议

务必通过环境变量或mcporter config管理URL，避免硬编码；生产环境建议配合最小权限的钉钉应用授权。

核心功能

钉钉 AI 表格（多维表）操作技能，基于新版 MCP 协议架构设计，采用四层资源模型（Base-Table-Field-Record）实现企业级表格数据的完整管理能力。

显著优点：

• 官方生态背书：钉钉官方 MCP 广场收录（mcpId=1060），来源可信度 T2 级，由钉钉团队维护
• 功能覆盖全面：支持从基础库创建、表结构设计到记录批量操作的完整工作流，涵盖 17+ 核心 API 端点
• 安全设计严谨：实现资源 ID 格式校验（^[A-Za-z0-9_-]{8,128}$）、文件扩展名白名单（.json/.csv）、路径穿越防护及 OPENCLAW_WORKSPACE 沙箱隔离
• 批量操作高效：内置批量新增字段（最多15个）、批量导入记录（最多100条）脚本，适配 CSV/JSON 双格式
• 调试友好：提供渐进式工作流（先 Base → 再 Table → 再 Field → 最后 Record），复杂参数支持 --args JSON 模式

潜在局限：

• 外部依赖耦合：核心功能完全依赖 mcporter CLI（>=0.7.0），工具不可用则 Skill 失效
• 配置门槛较高：需手动获取 Streamable HTTP URL 并配置环境变量或 mcporter config，URL 含敏感令牌需妥善保管
• 批量上限约束：受 MCP server 限制，单次操作上限分别为字段15个、表/字段查询10个、记录100条
• 无直接网络容错：网络通信完全委托 mcporter，Skill 层无重试或降级机制

适合人群：

• 已使用钉钉作为协同平台的中小企业数据管理员
• 需要将本地业务系统与钉钉多维表集成的开发者
• 熟悉 CLI 工具链、具备基础 JSON 处理能力的技术用户
• 追求低代码/无代码数据自动化，但需要批量导入导出的场景

常规风险：

• 令牌泄露风险：DINGTALK_MCP_URL 等同密码，若写入日志或提交代码仓库可能导致未授权访问
• 供应链风险：mcporter 工具若出现漏洞或被投毒，将直接影响本 Skill 安全性
• 误操作风险：批量删除/更新记录无二次确认，脚本执行前建议先 query_records 核验
• 沙箱绕过风险：OPENCLAW_WORKSPACE 若配置为根目录或空值，可能削弱文件隔离效果

安全评级：S（优秀）- 代码结构清晰，输入验证完善，无高危函数，适合生产环境使用（评分87/100）