---

name: airtable-automation description: "通过 Rube MCP (Composio) 自动化 Airtable 任务：记录、数据库、表、字段、视图。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Airtable 自动化

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

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit airtable 建立活跃的 Airtable 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

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

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

核心工作流

1. 创建和管理记录

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

工具调用顺序：

1. AIRTABLE_LIST_BASES - 发现可用数据库 [前置]
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：数据库 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 速率限制：每个数据库约 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：类型特定选项（选择项的 choices，数字的 precision）
• description：字段描述

常见陷阱：

• UPDATE_FIELD 只能更改名称/描述，不能更改类型/选项；需创建替代字段并迁移
• 计算字段（formula, rollup, lookup）无法通过 API 创建
• 类型选项缺失或格式错误时返回 422

4. 管理评论

适用场景：用户想查看或添加记录评论

工具调用顺序：

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

关键参数：

• baseId：数据库 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}=）