🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Feishu Project(Meego) Connector - Bytedance Internal Version

by @wadxm

通过 MCP 服务连接 Meego(飞书项目字节内网版),支持 OAuth 认证,可查询和管理工作项、视图等。

Versionv1.0.10
Downloads1,152
Stars1
TERMINAL
clawhub install feishu-project-connector-bytedance-internal

📖 About This Skill


name: feishu-project-connector description: 通过 MCP 服务连接 Meego(飞书项目字节内网版),支持 OAuth 认证,可查询和管理工作项、视图等。 version: 1.0.10 homepage: https://www.npmjs.com/package/@lark-project/meego-mcporter metadata: openclaw: homepage: https://www.npmjs.com/package/@lark-project/meego-mcporter emoji: 📋 requires: bins: - node - npx config: - ~/.mcporter/credentials.json install: - kind: node package: "@lark-project/meego-mcporter" bins: - meego-mcporter

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_btd --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_btd --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://bytedance.larkoffice.com/wiki/UspfwpHaFi6LxQkt9xBcIS54nNg 在本地电脑中完成授权,授权完成后请将生成的凭证文件提供给我。

    步骤 B — 接收用户提供的已授权凭证(需用户确认):

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

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

    #### 3.4. 验证授权结果

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

    4. 后续使用

    npx @lark-project/meego-mcporter call meego_btd  --config meego-config.json
    

    可用功能

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