第 2 课
搜索与执行：search_actions、连接账号、execute_action
按官方工具表：列出服务、英文搜索 Action、connect_account / complete_connection，再执行一次只读任务。
课程目录第 2 / 2 课
学习位置仅保存在当前浏览器，有效期 180 天。
图文讲义
来源：Liner · Actions MCP · Requesting tasks、liner.com/mcps/actions、Console actions.liner.com/my。 本课假设你已完成第一课 OAuth；工具名以官方表格为准。
你将得到什么
- 会触发官方四件套：
search_actions、execute_action、connect_account、complete_connection - 完成「先列服务 →（可选）连一个应用账号 → 执行一次任务」的闭环
- 知道 Action 搜索查询需用英文、凭证存在 Liner 侧、可在 Console 断开连接
官方工具一览
| 工具 | 作用 |
|---|---|
search_actions | 用自然语言搜索 Action；无 query 时返回可用服务 |
execute_action | 执行已选定的 Action |
connect_account | 打开某服务的账号连接引导 |
complete_connection | 确认你已在浏览器完成该服务连接 |
对话可用中文描述任务；官方写明助手负责搜索，频道名、仓库名等专有名词按你写的原文传递。但若搜索无结果，官方要求 用英文再搜一次。
步骤 1：列出可用服务（无需第三方账号）
发送：
Show me the services available through Liner Actions.
或更短：
Use search_actions with an empty query and list available services.
对照结果：出现服务/应用目录（如 GitHub、Linear、Notion、Slack 等，以你账号可见目录为准）。此步不要求先连接第三方账号。
步骤 2：用英文搜索具体 Action
官方限制：Action search only works with English queries.
示例（只读向，按你已有账号替换服务名）：
Search Liner Actions (in English) for listing my GitHub repositories. Do not create or delete anything yet.
对照结果：助手调用 search_actions，返回候选 Action；若空结果，把关键词改成更短的英文（如 list GitHub repos）再试。
步骤 3：首次使用某应用时连接账号
当你真正要执行需要权限的操作（例如「在 Linear 建 bug 单」）时，官方流程是：
- 助手用
search_actions找到合适 Action - 若缺账号，调用
connect_account并给出连接链接/打开连接屏 - 你在浏览器登录该应用并批准（有的服务要填 API Key——在连接屏填写，不要把密钥贴进聊天）
- 回到助手说「我已在浏览器完成连接」
- 助手调用
complete_connection确认后继续execute_action
可抄提示词模板：
I need to [describe the task in English, e.g. list open issues assigned to me in Linear].
If an account connection is required, call connect_account and wait.
After I finish in the browser I will say: connection done — then call complete_connection and continue.
Do not invent credentials in chat.
对照结果：Console https://actions.liner.com/my 出现该服务为已连接；任务继续执行或返回明确权限错误（而非一直「未连接」）。
官方注意：浏览器点完批准还不够，必须让助手再跑
complete_connection。若仍显示未连接，到 Actions Console 核对。
步骤 4：执行一次可验证任务（优先只读）
在已连接且你有权限的服务上，选一条低风险任务。示例（按你实际已连接的服务二选一）：
A. 仅列目录 / 只读
Using Liner Actions, list services I already connected. Then, if GitHub is connected, list my repositories (read-only). Do not create issues, PRs, or delete anything.
B. 官方产品页类任务（有 Linear 时）
Catch up on assigned issues in Linear: list issues assigned to me and summarize titles and statuses. Read-only.
对照结果：能看到 execute_action（或等价工具调用）痕迹；返回的仓库/议题列表与你在网页端看到的一致或合理子集。若权限不足，错误信息应指向账号权限，而不是 MCP 未登录。
步骤 5：账号与安全习惯
- 打开 https://actions.liner.com/my 查看已连接应用，不需要的断开。
- 记住：服务凭证由 Liner 存储，不会把 token 交给助手上下文。
- 应用连接挂在 Liner 账号上，不绑死某个 IDE——官方说明：在 Claude Code 连过的 GitHub，也可在 Cursor 里用。
- Liner Actions 登录批准约 30 天过期；第三方应用权限以各应用授权页为准。
常见问题（本课）
| 现象 | 处理 |
|---|---|
| search 无结果 | 改用英文短查询再搜 |
| 浏览器已连但仍 disconnected | 明确告诉助手已完成，触发 complete_connection；再到 Console 检查 |
| 想「跳过搜索直接跑」 | 仍建议先 search_actions 让助手选对 Action，再 execute_action |
| 误选 SSE | 换 Streamable HTTP；SSE 官方不支持 |
| 密钥贴进聊天 | 停；只在连接屏填写，聊天里撤销/轮换密钥 |
本课检查清单
-
search_actions能列出服务或英文搜索到候选 Action - 至少对一个应用走通连接（或确认 Console 里已有连接）
- 完成一次只读（或可逆）
execute_action并对照网页结果 - 知道 Console 地址与 30 天 OAuth 过期
课后延伸
- 产品页用例：整理 GitHub issues、分享会议纪要、在 Linear 记 bug、发项目进度更新（见 https://liner.com/mcps/actions ）。
- 若你在做产品集成、要按用户分别授权，官方建议看 Liner Actions API（与 MCP 同一 Action Engine）；本课只覆盖 MCP 个人代理场景。
- 站内工具卡：https://www.kun.net/tools/liner-actions-mcp/