---

name: coda-automation description: "通过 Rube MCP (Composio) 自动化 Coda 任务：管理文档、页面、表格、行、公式、权限和发布。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Coda 自动化

通过 Composio 的 Coda 工具包经由 Rube MCP 自动化 Coda 文档和数据操作。

前置条件

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

设置

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

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

核心工作流

1. 搜索和浏览文档

使用场景：用户想要查找、列出或检查 Coda 文档

工具调用顺序：

1. CODA_SEARCH_DOCS 或 CODA_LIST_AVAILABLE_DOCS - 查找文档 [必需]
2. CODA_RESOLVE_BROWSER_LINK - 将 Coda URL 解析为 doc/page/table ID [备选]
3. CODA_LIST_PAGES - 列出文档中的页面 [可选]
4. CODA_GET_A_PAGE - 获取特定页面详情 [可选]

关键参数：

• query：用于查找文档的搜索词
• isOwner：筛选用户拥有的文档
• docId：用于页面操作的文档 ID
• pageIdOrName：页面标识符或名称
• url：用于解析操作的浏览器 URL

注意事项：

• 文档 ID 是字母数字字符串（例如 'AbCdEfGhIj'）
• CODA_RESOLVE_BROWSER_LINK 是将 Coda URL 转换为 API ID 的最佳方式
• 页面名称在文档中可能不唯一；优先使用页面 ID
• 搜索结果包括与用户共享的文档，不仅仅是用户拥有的文档

2. 处理表格和数据

使用场景：用户想要读取、写入或查询表格数据

工具调用顺序：

1. CODA_LIST_TABLES - 列出文档中的表格 [前置条件]
2. CODA_LIST_COLUMNS - 获取表格的列定义 [前置条件]
3. CODA_LIST_TABLE_ROWS - 列出所有行（可选筛选）[必需]
4. CODA_SEARCH_ROW - 按查询搜索特定行 [备选]
5. CODA_GET_A_ROW - 按 ID 获取特定行 [可选]
6. CODA_UPSERT_ROWS - 在表格中插入或更新行 [可选]
7. CODA_GET_A_COLUMN - 获取特定列的详情 [可选]

关键参数：

• docId：包含表格的文档 ID
• tableIdOrName：表格标识符或名称
• query：用于搜索行的筛选查询
• rows：用于 upsert 操作的行对象数组
• keyColumns：upsert 时用于匹配的列 ID
• sortBy：用于排序结果的列
• useColumnNames：在行数据中使用列名而非 ID

注意事项：

• 表格名称可能包含空格；如需要请进行 URL 编码
• CODA_UPSERT_ROWS 在 keyColumns 无匹配时执行插入，有匹配时执行更新
• keyColumns 必须引用具有唯一值的列才能实现可靠的 upsert
• 列 ID 与列名不同；先列出列以映射名称到 ID
• useColumnNames: true 允许在行数据中使用人类可读的名称
• 行数据值必须匹配列类型（文本、数字、日期等）

3. 管理公式

使用场景：用户想要列出或计算文档中的公式

工具调用顺序：

1. CODA_LIST_FORMULAS - 列出文档中所有命名公式 [必需]
2. CODA_GET_A_FORMULA - 获取特定公式的当前值 [可选]

关键参数：

• docId：文档 ID
• formulaIdOrName：公式标识符或名称

注意事项：

• 公式是文档中定义的命名计算
• 公式值在服务器端计算；结果反映当前状态
• 公式名称区分大小写

4. 导出文档内容

使用场景：用户想要将文档或页面导出为 HTML 或 Markdown

工具调用顺序：

1. CODA_BEGIN_CONTENT_EXPORT - 启动导出任务 [必需]
2. CODA_CONTENT_EXPORT_STATUS - 轮询导出状态直到完成 [必需]

关键参数：

• docId：要导出的文档 ID
• outputFormat：导出格式（'html' 或 'markdown'）
• pageIdOrName：要导出的特定页面（可选，省略则导出整个文档）
• requestId：用于状态轮询的导出请求 ID

注意事项：

• 导出是异步的；轮询状态直到 status 为 'complete'
• 大型文档可能需要较长时间导出
• 完成响应中的导出 URL 是临时的；请及时下载
• 轮询过于频繁可能触发速率限制；使用 2-5 秒间隔

5. 管理权限和共享

使用场景：用户想要查看或管理文档访问权限

工具调用顺序：

1. CODA_GET_SHARING_METADATA - 查看当前共享设置 [必需]
2. CODA_GET_ACL_S