昆
昆仑AI工具大全KUN.NET
提交工具

第 1 课

注册 MCP 端点：Claude Code / Cursor / Codex 与 OAuth

按官方 Docs：注册 https://actions.liner.com/api/v1/mcp（Streamable HTTP），完成浏览器 OAuth；可选 mcp-remote。

图文18 分钟

课程目录第 1 / 2 课
  1. 01注册 MCP 端点：Claude Code / Cursor / Codex 与 OAuth18 分钟
  2. 02搜索与执行：search_actions、连接账号、execute_action22 分钟
返回课程介绍

学习位置仅保存在当前浏览器，有效期 180 天。

01 / 图文教材

图文讲义

来源：Liner · Actions MCP、liner.com/mcps/actions。 远程 MCP 端点以官方为准：https://actions.liner.com/api/v1/mcp；传输 Streamable HTTP；鉴权 OAuth 2.1（浏览器登录 Liner Actions，勿填 Bearer / API Key）。

你将得到什么

  • 在 Claude Code、Cursor 或 Codex 中挂好名为 liner-actions 的远程 MCP
  • 一次成功的 OAuth：浏览器授权后，助手能调用 Liner Actions 工具
  • （可选）用 mcp-remote 给不支持远程 OAuth 的客户端桥接同一端点

开始前准备

  1. 可完成浏览器登录的 Liner Actions 账号（授权页常见 Google 企业/个人登录，以当前页面为准）。
  2. 任选其一客户端：Claude Code（终端）、Cursor、Codex CLI；可选 VS Code / 其他支持 Streamable HTTP + OAuth 的 MCP 客户端。
  3. 先打开通读：https://liner.com/developers/docs/actions-mcp

核心事实（先记住）

项官方值
MCP 端点https://actions.liner.com/api/v1/mcp
传输Streamable HTTP（不支持 SSE）
鉴权OAuth 2.1（浏览器；不要加 Authorization 头）
建议服务器名liner-actions
执行身份挂在你已登录的 Liner Actions 账号下的服务账号连接
Consolehttps://actions.liner.com/my

步骤 1：Claude Code 注册（推荐）

按官方 Quick installation / Claude Code：

claude mcp add --transport http liner-actions https://actions.liner.com/api/v1/mcp -s user

说明（官方强调）：

  • 必须带 --transport http，否则 Claude Code 会把 liner-actions 当成本地 STDIO 程序去跑。
  • -s user 表示账号级注册，任意项目目录可用；去掉则仅当前项目。

然后新开 Claude Code 会话（旧会话不会重读 MCP 配置），执行：

/mcp

选择 liner-actions → Authenticate，在浏览器登录并批准。

对照结果：/mcp 里 liner-actions 状态为 connected；工具列表可见（下一课再调用）。

核对列表：

claude mcp list

移除（若需重装，-s 须与注册时一致）：

claude mcp remove liner-actions -s user

步骤 2：Cursor 写入 mcp.json

按官方 Cursor 说明，把下列配置写入 ~/.cursor/mcp.json（全局）；若只要当前仓库，写入该项目的 .cursor/mcp.json。若文件已存在，只把 liner-actions 条目合并进 mcpServers，勿整文件覆盖。

{
  "mcpServers": {
    "liner-actions": {
      "url": "https://actions.liner.com/api/v1/mcp"
    }
  }
}

然后：

  1. Cursor Settings → Tools & MCP
  2. 找到 liner-actions，点击 Needs login / 登录按钮
  3. 浏览器完成 Liner Actions 授权

对照结果：列表出现工具数量；若完全看不到该服务器，命令面板执行 Reload Window（Cursor 仅在启动时读 MCP 配置）。

步骤 3：Codex CLI（可选）

codex mcp add liner-actions --url https://actions.liner.com/api/v1/mcp
codex mcp login liner-actions

对照结果：浏览器授权完成后，重启已打开的 Codex 会话；codex mcp list 可见 liner-actions。

官方说明：给 --url 时 Codex 会自动选 Streamable HTTP；不要使用 --bearer-token-env-var（API Key 会让 OAuth 失败）。

步骤 4：（可选）其他客户端 / mcp-remote

官方「Other MCP clients」：若客户端不原生支持远程 OAuth，可用 mcp-remote 桥接：

{
  "mcpServers": {
    "liner-actions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://actions.liner.com/api/v1/mcp"
      ]
    }
  }
}

VS Code 可用 HTTP 型 MCP（字段名以当前 VS Code 文档为准），端点同为 https://actions.liner.com/api/v1/mcp，传输选 Streamable HTTP，鉴权字段留空。

步骤 5：连接健康检查（不改业务数据）

在已连接的 Claude Code / Cursor / Codex 对话中发送（官方文档示例）：

Show me the services available through Liner Actions.

对照结果：助手应调用 MCP（常见为 search_actions），即使尚未连接任何第三方应用账号，也应返回可用服务/目录信息。若 401 或未连接，回到步骤 1–3 重新 Authenticate。

常见问题（本课）

现象处理
工具不出现保存配置后重启客户端；确认 URL 完全一致；传输选 Streamable HTTP，勿选 SSE
浏览器登录窗没开从客户端 MCP 设置手动点登录 / /mcp → Authenticate
invalid_client / invalid_request上次关掉窗口未批准又重试：先 remove 再 add，再登录
曾可用后变 401官方：登录批准约 30 天过期，重新登录即可
Claude Code 报找不到本地程序漏了 --transport http

本课检查清单

  • 端点记牢：https://actions.liner.com/api/v1/mcp
  • Claude Code 或 Cursor（或 Codex）至少一条路径 OAuth 成功
  • 「Show me the services…」试问有工具调用痕迹
  • 未在配置里塞 Bearer / API Key

下一课

用 search_actions / execute_action 完成一次真实（可只读）任务，并在需要时走 connect_account → 浏览器连应用 → complete_connection。

本课资料