企业官网建设流程全解析

• AI 技能
• AI 插件

本文以仓库内 coda-automation 技能文档为核心，讲解如何通过 Rube MCP（基于 Composio 的 Coda 工具包）实现 Coda 文档、页面、表格、行、公式、权限与发布的全链路自动化。读完本文，你将掌握 Rube MCP 的接入与 Coda 连接激活流程、六大核心工作流的工具调用顺序与关键参数、ID 解析与分页等通用模式，以及配额、数据类型等避坑要点，可直接在 Agent 工作流中落地使用。

本文基于 AAS Core 仓库中的社区技能文档编写，该技能在 catalog.json 中被标记为source: community、risk: critical（含权限变更与发布等敏感操作），使用前请确保输入、权限、安全边界与成功标准均已明确。

前置条件与 Rube MCP 接入

在开始任何 Coda 自动化之前，需要满足三个前置条件：

1. Rube MCP 已连接：确保 Agent 环境中存在RUBE_SEARCH_TOOLS工具。
2. Coda 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS以工具包coda建立连接。
3. 始终先调用RUBE_SEARCH_TOOLS：获取当前最新的工具 schema，避免使用过时的参数签名。

添加 Rube MCP 服务器

无需任何 API Key，只需在客户端配置中将https://rube.app/mcp添加为 MCP 服务器即可。

激活 Coda 连接的四个步骤

1. 确认RUBE_SEARCH_TOOLS有响应，验证 Rube MCP 可用；
2. 调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为coda；
3. 若连接状态不是 ACTIVE，点击返回的授权链接完成 Coda 认证；
4. 在运行任何工作流之前，确认连接状态显示为 ACTIVE。

核心工作流一：搜索与浏览文档

适用场景：用户需要查找、列出或查看 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：用于 resolve 操作的浏览器 URL

注意事项：

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

核心工作流二：操作表格与数据

适用场景：用户需要读取、写入或查询表格数据。

工具调用顺序：

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允许在行数据中使用人类可读的名称
• 行数据值必须匹配列类型（text、number、date 等）

核心工作流三：管理公式

适用场景：用户需要列出或求值文档中的公式。

工具调用顺序：

1. CODA_LIST_FORMULAS— 列出文档中的所有命名公式（必选）
2. CODA_GET_A_FORMULA— 获取特定公式的当前值（可选）

关键参数：

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

注意事项：

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

核心工作流四：导出文档内容

适用场景：用户需要将文档或页面导出为 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 秒间隔

核心工作流五：管理权限与共享

适用场景：用户需要查看或管理文档访问权限。

工具调用顺序：

1. CODA_GET_SHARING_METADATA— 查看当前共享设置（必选）
2. CODA_GET_ACL_SETTINGS— 获取访问控制列表设置（可选）
3. CODA_ADD_PERMISSION— 向用户或邮箱授予访问权限（可选）

关键参数：

• docId：文档 ID
• access：权限级别（'readonly'、'write'、'comment'）
• principal：接收者邮箱或用户 ID 的对象
• suppressEmail：是否跳过共享通知邮件

注意事项：

• 权限级别：'readonly'、'write'、'comment'
• 添加权限默认发送邮件通知，使用suppressEmail可阻止
• 并非所有情况下都能通过 API 移除权限，需检查 ACL 设置

核心工作流六：发布与自定义文档

适用场景：用户需要公开发布文档或管理自定义域名。

工具调用顺序：

1. CODA_PUBLISH_DOC— 公开发布文档（必选）
2. CODA_UNPUBLISH_DOC— 取消发布文档（可选）
3. CODA_ADD_CUSTOM_DOMAIN— 为已发布文档添加自定义域名（可选）
4. CODA_GET_DOC_CATEGORIES— 获取文档类别用于发现（可选）

关键参数：

• docId：文档 ID
• slug：已发布文档的自定义 URL 段
• categoryIds：用于可发现性的类别 ID

注意事项：

• 发布后任何持有链接的人都可以访问文档
• 自定义域名需要 DNS 配置
• 取消发布会移除公共访问，但保留共享访问

通用模式

ID 解析

文档 URL -> 文档 ID：

1. 使用 Coda URL 调用CODA_RESOLVE_BROWSER_LINK
2. 从响应中提取docId

表格名称 -> 表格 ID：

1. 使用docId调用CODA_LIST_TABLES
2. 按名称找到表格，提取id

列名称 -> 列 ID：

1. 使用docId和tableIdOrName调用CODA_LIST_COLUMNS
2. 按名称找到列，提取id

分页

• Coda 使用基于游标的分页，参数为pageToken
• 检查响应中的nextPageToken
• 将其作为pageToken传入下一次请求，直到不再出现
• 默认页大小因端点而异

行 Upsert 模式

1. 调用CODA_LIST_COLUMNS获取列 ID
2. 使用列 ID 作为键构建行对象
3. 将keyColumns设置为唯一标识列
4. 使用rows和keyColumns调用CODA_UPSERT_ROWS

已知避坑点

ID 格式：

• 文档 ID：字母数字字符串
• 表格/列/行 ID：带前缀的字符串（如'grid-abc'、'c-xyz'）
• 使用RESOLVE_BROWSER_LINK将 URL 转换为 ID

数据类型：

• 行值必须匹配列类型
• 日期列期望 ISO 8601 格式
• 选择/多选列期望精确的选项值
• 人员列期望邮箱地址

速率限制：

• Coda API 有每 token 速率限制
• 对 429 响应实现退避重试
• 通过UPSERT_ROWS批量行操作比逐条更新更高效

快速参考表

使用场景与限制

本技能适用于执行概述中描述的 Coda 自动化工作流与动作。使用时请注意：

• 仅当任务与上述范围明确匹配时使用本技能；
• 不要将技能输出视为环境特定验证、测试或专家审查的替代品；
• 当所需输入、权限、安全边界或成功标准缺失时，应停下来向用户确认，而不是盲目执行。

深入阅读

• 查看技能原文：coda-automation/SKILL.md（本仓库同时保留了 plugins/agentic-awesome-skills/skills/coda-automation/SKILL.md 与 plugins/agentic-bundle-aas-automation-builder/skills/airtable-automation/SKILL.md 等同类自动化技能，供横向参考）
• 了解本技能在 AAS 目录中的元数据（id、category、risk、triggers 等）：catalog.json
• 若需在 Agent 环境中启用本技能，请参照 AAS Core 的插件与目录机制，技能文件的相对路径为skills/coda-automation/SKILL.md

本文所引用的全部信息均来自仓库内实际存在的文档与目录数据，使用前请结合自身环境验证连接状态、权限边界与工具 schema 的当前版本。

通过 Rube MCP 与 Composio Coda 工具包实现 Coda 自动化：文档、表格、公式与权限全链路操作指南

本文以仓库内 coda-automation 技能 为核心，系统讲解如何通过 Rube MCP（基于 Composio 的 Coda 工具包）完成 Coda 文档与数据的全链路自动化：从 Rube MCP 接入、Coda 连接激活，到文档浏览、表格读写、公式管理、内容导出、权限共享与文档发布六大工作流。读完本文，你将掌握每一类 Coda 任务的工具调用顺序、关键参数、ID 解析与分页等通用模式，以及数据类型、限流等常见避坑点，可直接应用于 Agent 驱动的 Coda 工作流。

适用前提：该技能在 catalog.json 中标记为source: community、risk: critical（涉及权限变更与文档发布等敏感操作），且是uncategorized分类的社区技能。使用时请确保输入、权限、安全边界与成功标准均已明确。

前置条件与 Rube MCP 接入

三个前置条件

在启动任何 Coda 自动化之前，必须先满足以下三点：

1. Rube MCP 已连接：RUBE_SEARCH_TOOLS工具必须可用；
2. Coda 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS以 toolkitcoda建立连接；
3. 先查 schema 再调用：任何工具调用之前，先调用RUBE_SEARCH_TOOLS获取当前工具的最新 schema，防止因参数签名变化导致调用失败。

添加 Rube MCP 服务器

无需任何 API Key：只需在客户端 MCP 配置中添加端点https://rube.app/mcp，添加后即可使用。

激活 Coda 连接的四个步骤

1. 验证 Rube MCP 可用——确认RUBE_SEARCH_TOOLS有响应；
2. 调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为coda；
3. 若连接状态不是 ACTIVE，跟随返回的授权链接完成 Coda 认证；
4. 运行任何工作流之前，确认连接状态已显示为 ACTIVE。

核心工作流一：搜索与浏览文档

适用场景：用户需要查找、列出或查看 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：用于 resolve 操作的浏览器 URL

注意事项：

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

核心工作流二：操作表格与数据

适用场景：用户需要读取、写入或查询表格数据。

工具调用顺序：

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允许在行数据中使用人类可读的名称；
• 行数据值必须匹配列类型（text、number、date 等）。

核心工作流三：管理公式

适用场景：用户需要列出或求值文档中的命名公式。

工具调用顺序：

1. CODA_LIST_FORMULAS—— 列出文档中的所有命名公式（必选）
2. CODA_GET_A_FORMULA—— 获取特定公式的当前值（可选）

关键参数：

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

注意事项：

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

核心工作流四：导出文档内容

适用场景：用户需要将文档或页面导出为 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 秒间隔。

核心工作流五：管理权限与共享

适用场景：用户需要查看或管理文档访问权限。

工具调用顺序：

1. CODA_GET_SHARING_METADATA—— 查看当前共享设置（必选）
2. CODA_GET_ACL_SETTINGS—— 获取访问控制列表设置（可选）
3. CODA_ADD_PERMISSION—— 向用户或邮箱授予访问权限（可选）

关键参数：

• docId：文档 ID
• access：权限级别（'readonly'、'write'、'comment'）
• principal：接收者邮箱或用户 ID 的对象
• suppressEmail：是否跳过共享通知邮件

注意事项：

• 权限级别：'readonly'、'write'、'comment'；
• 添加权限默认发送邮件通知，使用suppressEmail可阻止；
• 并非所有情况下都能通过 API 移除权限，需检查 ACL 设置。

核心工作流六：发布与自定义文档

适用场景：用户需要公开发布文档或管理自定义域名。

工具调用顺序：

1. CODA_PUBLISH_DOC—— 公开发布文档（必选）
2. CODA_UNPUBLISH_DOC—— 取消发布文档（可选）
3. CODA_ADD_CUSTOM_DOMAIN—— 为已发布文档添加自定义域名（可选）
4. CODA_GET_DOC_CATEGORIES—— 获取文档类别用于发现（可选）

关键参数：

• docId：文档 ID
• slug：已发布文档的自定义 URL 段
• categoryIds：用于可发现性的类别 ID

注意事项：

• 发布后任何持有链接的人都可以访问文档；
• 自定义域名需要 DNS 配置；
• 取消发布会移除公共访问，但保留共享访问。

通用模式

ID 解析

文档 URL → 文档 ID：

1. 使用 Coda URL 调用CODA_RESOLVE_BROWSER_LINK
2. 从响应中提取docId

表格名称 → 表格 ID：

1. 使用docId调用CODA_LIST_TABLES
2. 按名称找到表格，提取id

列名称 → 列 ID：

1. 使用docId与tableIdOrName调用CODA_LIST_COLUMNS
2. 按名称找到列，提取id

分页

• Coda 使用基于游标的分页，参数为pageToken；
• 检查响应中的nextPageToken；
• 将其作为pageToken传入下一次请求，直到不再出现；
• 默认页大小因端点而异。

行 Upsert 模式

1. 调用CODA_LIST_COLUMNS获取列 ID；
2. 使用列 ID 作为键构建行对象；
3. 将keyColumns设置为唯一标识列；
4. 使用rows与keyColumns调用CODA_UPSERT_ROWS。

已知避坑点

ID 格式：

• 文档 ID：字母数字字符串；
• 表格/列/行 ID：带前缀的字符串（如'grid-abc'、'c-xyz'）；
• 使用RESOLVE_BROWSER_LINK将 URL 转换为 ID。

数据类型：

• 行值必须匹配列类型；
• 日期列期望 ISO 8601 格式；
• 选择/多选列期望精确的选项值；
• 人员列期望邮箱地址。

速率限制：

• Coda API 有每 token 速率限制；
• 对 429 响应实现退避重试；
• 通过UPSERT_ROWS的批量行操作比逐条更新更高效。

快速参考表

使用场景与限制

本技能适用于执行概述中描述的 Coda 自动化工作流与动作。使用时请注意：

• 仅当任务与上述范围明确匹配时使用本技能；
• 不要将技能输出视为环境特定验证、测试或专家审查的替代品；
• 当所需输入、权限、安全边界或成功标准缺失时，应停下来向用户确认，而不是盲目执行。

深入阅读

• 技能原文：plugins/agentic-awesome-skills-claude/skills/coda-automation/SKILL.md
• 同源技能（AAS 基础插件中也保留了一份相同文档）：plugins/agentic-awesome-skills/skills/coda-automation/SKILL.md
• 该技能在 AAS 目录中的元数据（id、description、risk、triggers 等）：data/catalog.json
• 同类自动化技能参考（同为通过 Rube MCP + Composio 工具包）：plugins/agentic-awesome-skills-claude/skills/googlesheets-automation/SKILL.md

本文所述全部信息均来自仓库内实际存在的技能文档与目录数据。Coda 工具的实际 schema 可能随 Rube MCP / Composio 版本演进而变化，正式使用前请务必以RUBE_SEARCH_TOOLS返回的最新 schema 为准，并结合自身环境完成连接状态与权限边界的验证。

• AI 技能
• AI 插件