用途:管理企业微信智能表格的表结构,包括子表与字段(列)的增删改查。所有操作通过 wecom_mcp 这个 MCP tool 完成,品类为 doc。
前置条件:首次调用 wecom_mcp 前,必须按 wecom-preflight 技能执行前置条件检查,确保工具已加入白名单。所有接口支持通过 docid 或 url 二选一定位文档。
调用方式:使用 wecom_mcp tool 调用 wecom_mcp call doc <tool_name> '<json_params>'。
返回格式:所有接口返回 JSON 对象,含公共字段 errcode(0 成功,非 0 失败)与 errmsg(成功为 "ok")。errcode 非 0 时可重试 1 次,仍失败则将 errcode 和 errmsg 展示给用户。
子表管理:smartsheet_get_sheet 查询所有子表信息(sheet_id、title、类型等);smartsheet_add_sheet 添加空子表,新子表不含视图、记录和字段,需其他接口补充,新建智能表格文档默认已含一个子表,仅需多个子表时调用;smartsheet_update_sheet 修改子表标题,需 sheet_id 和新 title;smartsheet_delete_sheet 永久删除子表,不可逆。
字段管理:smartsheet_get_fields 查询子表所有字段(field_id、field_title、field_type);smartsheet_add_fields 添加一个或多个字段,单个子表最多 150 个字段,字段类型参见字段类型参考;smartsheet_update_fields 仅能改字段标题,不能改类型(field_type 必须传原始类型),field_title 不能更新为原值;smartsheet_delete_fields 删除一列或多列字段,不可逆,field_id 可通过 smartsheet_get_fields 获取。
典型工作流:了解表结构用 smartsheet_get_sheet 再 smartsheet_get_fields;创建表结构用 smartsheet_add_sheet 添加子表再 smartsheet_add_fields 定义列;修改表结构用 smartsheet_update_fields 改列名或 smartsheet_delete_fields 删列。
限制:删除子表与字段均不可逆;字段类型不可修改;单子表字段上限 150;首次使用需完成前置条件检查。