通过 Rube MCP 实现 Airtable 自动化

通过 Composio 提供的 Airtable 工具包，借助 Rube MCP 自动化执行 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. 调用 RUBE_MANAGE_CONNECTIONS，并指定工具包为 airtable
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 启用自动类型转换

常见问题：

• 每页最多返回 100 条记录；采用偏移量分页（offset pagination）；跨页请求时若修改筛选条件，可能导致记录跳过或重复
• 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 次请求/秒；遇到 429 响应时，请依据 Retry-After 头部重试

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 类型的可选项列表、number 类型的小数精度等）
• description：字段描述

常见问题：

• UPDATE_FIELD 仅支持修改字段名和描述，不支持变更字段类型或选项；如需变更类型，请新建字段并迁移数据
• 计算字段（formula、rollup、lookup）无法通过 API 创建
• 字段类型选项缺失或格式错误将返回 422

4. 管理评论

适用场景：用户希望查看或添加某条记录的评论

工具调用顺序：

1. AIRTABLE_LIST_COMMENTS — 列出某条记录下的所有评论（必需）

关键参数：

• baseId：Base ID
• tableIdOrName：表标识符（ID 或名称）
• 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 条

速查表