airtable-automation

通过 Rube MCP 实现 Airtable 自动化

通过 Rube MCP 使用 Composio 的 Airtable 工具包自动化 Airtable 操作。

先决条件

• 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 airtable 建立有效的 Airtable 连接
• 始终先调用 RUBE_SEARCH_TOOLS 以获取最新的工具 schema

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥——只需添加该端点即可使用。

1. 通过确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 airtable 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE，请按照返回的授权链接完成 Airtable 授权
4. 在运行任何工作流之前，确认连接状态显示为 ACTIVE

核心工作流

1. 创建和管理记录

使用场景：用户想要创建、读取、更新或删除记录

工具调用顺序：

1. AIRTABLE_LIST_BASES - 发现可用的 base [先决条件]
2. AIRTABLE_GET_BASE_SCHEMA - 检查表结构 [先决条件]
3. AIRTABLE_LIST_RECORDS - 列出/筛选记录 [可选]
4. AIRTABLE_CREATE_RECORD / AIRTABLE_CREATE_RECORDS - 创建记录 [可选]
5. AIRTABLE_UPDATE_RECORD / AIRTABLE_UPDATE_MULTIPLE_RECORDS - 更新记录 [可选]
6. AIRTABLE_DELETE_RECORD / AIRTABLE_DELETE_MULTIPLE_RECORDS - 删除记录 [可选]

关键参数：

• baseId：Base ID（以 'app' 开头，例如 'appXXXXXXXXXXXXXX'）
• tableIdOrName：表 ID（以 'tbl' 开头）或表名
• fields：将字段名映射到值的对象
• recordId：用于更新/删除的记录 ID（以 'rec' 开头）
• filterByFormula：用于筛选的 Airtable 公式
• typecast：设置为 true 以自动进行类型转换

注意事项：

• pageSize 上限为 100；使用 offset 分页；在分页之间更改筛选条件可能会跳过/重复行
• CREATE_RECORDS 每次请求硬性限制为 10 条记录；较大的导入需分批处理
• 字段名区分大小写，必须与 schema 完全匹配
• 字段名错误时出现 422 UNKNOWN_FIELD_NAME；权限问题时为 403
• INVALID_MULTIPLE_CHOICE_OPTIONS 可能需要 typecast=true

2. 搜索和筛选记录

使用场景：用户想要使用公式查找特定记录

工具调用顺序：

1. AIRTABLE_GET_BASE_SCHEMA - 验证字段名和类型 [先决条件]
2. AIRTABLE_LIST_RECORDS - 使用 filterByFormula 查询 [必需]
3. AIRTABLE_GET_RECORD - 获取完整记录详情 [可选]

关键参数：

• filterByFormula：Airtable 公式（例如 {Status}='Done'）
• sort：排序对象数组
• fields：要返回的字段名数组
• maxRecords：所有页面的最大记录总数
• offset：来自上一个响应的分页游标

注意事项：

• 公式中的字段名必须用 {} 包裹，并与 schema 完全匹配
• 字符串值必须加引号：{Status}='Active'，而不是 {Status}=Active
• 语法错误或字段不存在时出现 422 INVALID_FILTER_BY_FORMULA
• Airtable 速率限制：每个 base 约 5 次请求/秒；通过 Retry-After 处理 429

3. 管理字段和 schema

使用场景：用户想要创建或修改表字段

工具调用顺序：

1. AIRTABLE_GET_BASE_SCHEMA - 检查当前 schema [先决条件]
2. AIRTABLE_CREATE_FIELD - 创建新字段 [可选]
3. AIRTABLE_UPDATE_FIELD - 重命名/描述字段 [可选]
4. AIRTABLE_UPDATE_TABLE - 更新表元数据 [可选]

关键参数：

• name：字段名
• type：字段类型（singleLineText、number、singleSelect 等）
• options：类型特定选项（select 的 choices、number 的 precision）
• description：字段描述

注意事项：

• UPDATE_FIELD 仅更改 name/description，不更改 type/options；请创建一个替代字段并迁移数据
• 计算字段（formula、rollup、lookup）无法通过 API 创建
• 类型选项缺失或格式错误时出现 422

4. 管理评论

使用场景：用户希望查看或添加记录上的评论

工具调用顺序：

1. AIRTABLE_LIST_COMMENTS - 列出记录上的评论 [必需]

关键参数：

• baseId：Base ID
• tableIdOrName：表格标识符
• recordId：记录 ID（17 个字符，以 'rec' 开头）
• pageSize：每页评论数（最大 100）

注意事项：

• 记录 ID 必须正好是 17 个字符，并以 'rec' 开头

常见模式

Airtable 公式语法

比较：

• {Status}='Done' - 等于
• {Priority}>1 - 大于
• {Name}!='' - 非空

函数：

• AND({A}='x', {B}='y') - 两个条件都满足
• OR({A}='x', {A}='y') - 任一条件满足
• FIND('test', {Name})>0 - 包含文本
• IS_BEFORE({Due Date}, TODAY()) - 日期比较

转义规则：

• 值中的单引号：将其双写（{Name}='John''s Company'）

分页

• 设置 pageSize（最大 100）
• 检查响应中的 offset 字符串
• 将 offset 原样传给下一个请求
• 在页面之间保持筛选/排序/视图不变

已知注意事项

ID 格式：

• Base ID：appXXXXXXXXXXXXXX（17 个字符）
• 表格 ID：tblXXXXXXXXXXXXXX（17 个字符）
• 记录 ID：recXXXXXXXXXXXXXX（17 个字符）
• 字段 ID：fldXXXXXXXXXXXXXX（17 个字符）

批量限制：

• CREATE_RECORDS：每个请求最多 10 个
• UPDATE_MULTIPLE_RECORDS：每个请求最多 10 个
• DELETE_MULTIPLE_RECORDS：每个请求最多 10 个

快速参考

任务	工具标识	关键参数
列出 base	AIRTABLE_LIST_BASES	（无）
获取架构	AIRTABLE_GET_BASE_SCHEMA	baseId
列出记录	AIRTABLE_LIST_RECORDS	baseId, tableIdOrName
获取记录	AIRTABLE_GET_RECORD	baseId, tableIdOrName, recordId
创建记录	AIRTABLE_CREATE_RECORD	baseId, tableIdOrName, fields
创建多条记录	AIRTABLE_CREATE_RECORDS	baseId, tableIdOrName, records
更新记录	AIRTABLE_UPDATE_RECORD	baseId, tableIdOrName, recordId, fields
更新多条记录	AIRTABLE_UPDATE_MULTIPLE_RECORDS	baseId, tableIdOrName, records
删除记录	AIRTABLE_DELETE_RECORD	baseId, tableIdOrName, recordId
创建字段	AIRTABLE_CREATE_FIELD	baseId, tableIdOrName, name, type
更新字段	AIRTABLE_UPDATE_FIELD	baseId, tableIdOrName, fieldId
更新表格	AIRTABLE_UPDATE_TABLE	baseId, tableIdOrName, name
列出评论	AIRTABLE_LIST_COMMENTS	baseId, tableIdOrName, recordId

使用场景

此技能适用于执行概述中描述的工作流或操作。

示例

用户请求：

通过 Rube MCP（Composio）自动化 Airtable 任务：记录、base、表格、字段、视图。

限制

• 仅当任务与上述范围明确匹配时才使用此技能。
• 不要将输出视为针对特定环境的验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。