feishu-project-connector（飞书项目连接器）

Meego (飞书项目) Skill

通过 MCP 服务连接 Meego（飞书项目），支持 OAuth 认证。

前置要求

本技能依赖以下环境：

• Node.js（>= 18）及 npx
• @lark-project/meego-mcporter：MCP 传输工具，来源 npm（npm install -g @lark-project/meego-mcporter 或通过 npx 自动获取）

凭证管理说明

本技能使用 ~/.mcporter/credentials.json 存储 OAuth 凭证（由 mcporter 管理）。

• 方式一（推荐）：浏览器 OAuth——mcporter 自动完成授权并写入凭证，agent 无需接触凭证内容。
• 方式二（远程服务器）：当服务器没有浏览器时，需要用户在本地电脑完成 OAuth 后将凭证同步到服务器。此流程中 agent 会协助展示 OAuth 客户端配置（不含 token）以及写入用户提供的已授权凭证，所有操作均需用户逐步确认。

安全约束：

• agent 不得自主发起凭证操作，每一步均需用户明确确认
• agent 不得将凭证内容记录到日志、历史消息或任何非 ~/.mcporter/ 的位置
• 操作过程中产生的临时文件必须立即清理

连接方式

1. 询问用户使用哪种方式进行认证

注意：一定要询问用户，让用户主动选择，禁止自动帮用户选择。 本工具支持两种认证方式：

• 浏览器 OAuth（推荐）：适用于本地安装 OpenClaw 的场景，自动调起浏览器完成授权
• 远程 OAuth 代理：适用于在远程服务器（无浏览器环境）安装 OpenClaw 的场景

2. 浏览器 OAuth（推荐）

2.1. 创建配置文件

将技能包目录中的 meego-config.json 拷贝到工作目录下。

2.2. 执行 OAuth 认证（只需一次）

npx @lark-project/meego-mcporter auth meego --config meego-config.json

这会打开浏览器让你授权飞书账号。授权完成后，凭证会缓存到 ~/.mcporter/credentials.json，后续调用不需要再次授权。

3. 远程 OAuth 代理

适用场景：远程服务器没有浏览器，用户需要在本地电脑完成 OAuth 后将凭证同步回服务器。

3.1. 创建配置文件

将技能包目录中的 meego-config.json 拷贝到工作目录下。

3.2. 生成 OAuth 客户端配置

npx @lark-project/meego-mcporter auth meego --config meego-config.json --oauth-timeout 1000

此命令会在 ~/.mcporter/credentials.json 中生成 OAuth 客户端配置（仅包含 client 参数，不含 token）。

3.3. 协助用户完成本地授权

此步骤需要 agent 与用户配合完成凭证同步。由于远程服务器没有浏览器，用户需要在本地电脑完成 OAuth 授权。

步骤 A — 向用户展示 OAuth 客户端配置（需用户确认）：

读取 ~/.mcporter/credentials.json 的内容（此时仅包含 OAuth 客户端参数，不含 token），向用户展示并告知：

以下是 OAuth 客户端配置，请参考文档 https://project.feishu.cn/b/helpcenter/1ykiuvvj/1n3ae9b4 在本地电脑中完成授权，授权完成后请将生成的凭证文件提供给我。

步骤 B — 接收用户提供的已授权凭证（需用户确认）：

用户在本地完成 OAuth 后会提供已授权的凭证文件。在得到用户确认后，将其写入 ~/.mcporter/credentials.json。

写入完成后，立即清理操作过程中可能产生的任何中间临时文件。凭证内容仅存储在 ~/.mcporter/credentials.json，不得保存到其他任何位置。

3.4. 验证授权结果

尝试连接 MCP 服务器，确认已成功通过授权。

4. 后续使用

npx @lark-project/meego-mcporter call meego <tool_name> --config meego-config.json

可用功能

• 查询：待办、视图、工作项信息
• 操作：创建、修改、流转工作项