跳转到正文
Your Zestful Notions

输入内容开始搜索…

手动给 Agent 配置飞书：lark-cli Skills 与 OpenAPI MCP

用一条清晰的命令链手动安装飞书 Skills、完成授权，并把官方 OpenAPI MCP 接入 Agent。

开发实践1分钟阅读

我这次给 Agent 接入飞书，实际完成四件事：安装官方 Skills、配置飞书应用、完成登录、接入官方 OpenAPI MCP。

可以先这样理解：

  • lark-cli 负责配置和登录。
  • Skills 告诉 Agent 应该怎样完成飞书操作。
  • MCP 提供 Agent 可以调用的飞书工具。

本文以 macOS 和 Zsh 为例。命令里的 App ID、App Secret 都是占位符，真实密钥只保存在本机。

先确认 Node.js 和 npm 可以使用：

Terminal window
node --version
npm --version

安装官方 lark-cli 和 Skills：

Terminal window
npx -y @larksuite/cli@latest install
npx -y skills add larksuite/cli -g -y

检查安装结果：

Terminal window
lark-cli --version
command -v lark-cli

官方 Skills 包含文档、云盘、电子表格、多维表格、日历、即时通讯、任务和邮件等能力。

首次使用时执行：

Terminal window
lark-cli config init --new --lang zh

按照提示绑定飞书开放平台应用。准备好以下信息：

  • App ID：应用标识。
  • App Secret：应用密钥。
  • 应用权限：决定 Agent 可以调用哪些接口。

检查配置：

Terminal window
lark-cli config show
lark-cli doctor --offline

配置文件通常位于：

~/.lark-cli/config.json

发起授权：

Terminal window
lark-cli auth login --recommend --no-wait --json

命令会返回授权链接和临时 device_code。在浏览器中完成授权后，执行：

Terminal window
lark-cli auth login --device-code '<device_code>' --json

检查登录结果：

Terminal window
lark-cli auth status --json

重点确认用户身份已经准备好、令牌状态有效。企业管理员策略可能会限制部分权限，需要到飞书开放平台补充授权。

官方 MCP 项目是 larksuite/lark-openapi-mcp。它通过标准 stdio 方式启动，Agent 可以直接调用。

在 Agent 的 MCP 配置文件中加入：

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": ["-y", "@larksuiteoapi/lark-mcp", "mcp", "--language", "zh"],
      "env": {
        "APP_ID": "<APP_ID>",
        "APP_SECRET": "<APP_SECRET>",
        "LARK_DOMAIN": "https://open.feishu.cn"
      }
    }
  }
}

包含密钥的配置文件设置为仅当前用户可读：

Terminal window
chmod 600 /path/to/mcp-config.json

Codex 可以直接注册 MCP：

Terminal window
codex mcp add lark-openapi \
  --env APP_ID='<APP_ID>' \
  --env APP_SECRET='<APP_SECRET>' \
  --env LARK_DOMAIN='https://open.feishu.cn' \
  -- \
  npx -y @larksuiteoapi/lark-mcp mcp --language zh

如果已经把 App Secret 放进钥匙串，也可以让 Codex 只登记本机启动脚本：

Terminal window
codex mcp add lark-openapi \
  -- \
  /Users/Apple/.local/bin/lark-openapi-mcp

先检查 CLI 和 MCP：

Terminal window
lark-cli auth status --json
lark-cli doctor --offline
codex mcp list
codex mcp get lark-openapi

看到下面的信息，说明 MCP 已经注册：

enabled: true
transport: stdio

重启 Agent 或新建任务，让它重新加载 MCP 工具。第一次建议执行只读查询：

请列出我有权限访问的飞书文档，只读取信息，不修改内容。

查询成功后，再逐步使用创建、编辑、发消息等操作。

  • lark-cli 登录解决用户授权。
  • MCP 使用的 App ID 和 App Secret 决定应用身份。
  • 应用权限、用户授权、企业管理员策略共同决定最终调用结果。
  • App Secret、用户令牌和本机密钥文件只保存在本机安全存储中。
  • 文章、配置示例和 Git 仓库中只保留占位符。

需要让官方 MCP 使用用户身份登录时，可以执行：

Terminal window
npx -y @larksuiteoapi/lark-mcp login \
  --app-id '<APP_ID>' \
  --app-secret '<APP_SECRET>'

~/.lark-cli/config.json          # lark-cli 配置
~/.agents/skills/lark-*/         # 官方飞书 Skills
~/.codex/config.toml             # Codex MCP 注册信息
~/.local/bin/lark-openapi-mcp    # 本机 MCP 启动脚本

手动给 Agent 配置飞书，可以记住这条命令链：

安装 Skills → 初始化应用 → 完成登录 → 注册 MCP → 只读验证

先验证查询能力，再逐步开放写入权限，整个配置过程会更容易理解。

© yznn007. 保留所有权利。