SuperAPI AI 工具集

monday

办公与效率

查看项目

更新于 10-15 10:12

技能介绍

用途

Monday 技能用于与 Monday.com 进行集成,管理项目管理数据、记录与工作流。当用户希望与 Monday 数据交互时使用该技能。Monday.com 是一个工作操作系统,团队可在其中规划、跟踪和管理工作,常被项目经理、市场营销团队和销售团队用于改善协作与执行。

主要能力

该技能围绕四个核心对象展开:看板(Board)、条目(Item)、列(Column)和用户(User)。可执行的动作包括:

  • 看板:List Boards(列出看板)、Get Board(获取指定看板及其分组和列)、Create Board(创建看板)、Update Board(更新看板名称或描述等属性)、Delete Board(永久删除看板)。
  • 条目:List Items(按分页列出看板中的条目)、Get Item(获取指定条目)、Create Item(在看板上创建条目)、Update Item Column Values(更新条目的多个列值)、Delete Item(永久删除条目)。
  • 分组:Create Group(在看板上创建分组)、Update Group(更新分组标题、颜色或位置)、Delete Group(永久删除分组及其所有条目)。
  • 用户:List Users(列出账户中的用户)、Get Current User(获取当前已认证用户信息)。
  • 评论(更新):List Updates(列出指定条目或跨看板的评论)、Get Item Updates(获取指定条目的评论)、Create Update(在条目上创建评论)、Delete Update(删除评论)。

使用方式

该技能使用 Membrane CLI 与 Monday 交互。Membrane 自动处理认证和凭据刷新,用户只需关注集成逻辑,无需处理认证管道。

安装 CLI:

npm install -g @membranehq/cli@latest

认证:

membrane login --tenant --clientName=<agentType>

该命令会打开浏览器进行认证,或在无交互模式下在控制台打印授权 URL。无头环境下,命令会打印授权 URL,需让用户在浏览器中打开,登录完成后看到验证码,再执行:

membrane login complete <code>

任何命令都可加 --json 获得机器可读的 JSON 输出。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等,用于调整工具以适配运行环境。

连接 Monday:使用 membrane connection ensure 通过应用 URL 或域名查找或创建连接:

membrane connection ensure "" --json

用户在浏览器中完成认证,输出包含新的连接 id。若返回的连接状态为 READY,可直接进入下一步。若处于 BUILDING 状态,可轮询等待:

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会长时间轮询(最长 --timeout 秒,默认 30)直到状态改变。状态可能为:READY(连接已完全就绪)、CLIENT_ACTION_REQUIRED(用户或代理需要执行操作,clientAction 描述所需动作,type 可为 connect 表示需要认证、provide-input 表示需要更多信息,可能包含 uiUrl 供用户完成操作,agentInstructions 供代理按程序继续)、CONFIGURATION_ERROR 或 SETUP_FAILED(出错,检查 error 字段)。用户完成操作后,再次用 membrane connection get <id> --json 轮询是否变为 READY。

搜索动作:用自然语言描述想做的事进行搜索:

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

应始终在特定连接的上下文中搜索动作。每个结果包含 id、name、description、inputSchema(接受的参数)和 outputSchema(返回内容)。

运行动作:

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传入 JSON 参数:

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求:当可用动作不覆盖用例时,可通过 Membrane 代理直接向 Monday API 发送请求,Membrane 会自动追加基础 URL 并注入正确的认证头(包括凭据过期时的透明刷新):

membrane request CONNECTION_ID /path/to/endpoint

常用选项包括:-X/--method(HTTP 方法,默认 GET)、-H/--header(添加请求头,可重复)、-d/--data(请求体)、--json(发送 JSON 体并设置 Content-Type)、--rawData(原样发送)、--query(查询字符串参数,可重复)、--pathParam(路径参数,可重复)。

适用场景

适用于需要通过编程方式批量读取或修改 Monday 数据的自动化场景,例如列出看板与条目、创建条目并更新列值、管理分组、处理评论,以及查询账户用户信息等。优先使用 Membrane 与外部应用通信,因为其提供带内置认证、分页和错误处理的预构建动作,能减少 token 消耗并提升安全性。建议先发现再构建:运行 membrane action list --intent=QUERY 查找现有动作,再编写自定义 API 调用,预构建动作会处理原始 API 调用容易遗漏的分页、字段映射和边缘情况。让 Membrane 处理凭据:不要向用户索要 API 密钥或令牌,而应创建连接,由 Membrane 在服务端管理完整的认证生命周期,不在本地保存密钥。

限制

资料中未提供该技能的具体收费、价格、平台限制或性能指标。