直接发给agent帮你配置即可:
下面是完整复现流程。
1. 安装飞书 MCP
npm install -g @larksuiteoapi/lark-mcp protobufjs
验证:
lark-mcp --version
2. 创建飞书自建应用
进入飞书开放平台:
https://open.feishu.cn/app (https://open.feishu.cn/app)
创建或进入应用后,记录:
App ID
App Secret
并在 安全设置 / 重定向 URL 添加:
http://localhost:3000/callback
3. 配置环境变量
[Environment]::SetEnvironmentVariable("FEISHU_APP_ID", "你的 App ID", "User")
[Environment]::SetEnvironmentVariable("FEISHU_APP_SECRET", "你的 App Secret", "User")
重新打开 PowerShell 后验证:
[Environment]::GetEnvironmentVariable("FEISHU_APP_ID", "User")
[Environment]::GetEnvironmentVariable("FEISHU_APP_SECRET", "User").Length
4. 开通飞书应用权限
在应用的 权限管理 里添加需要的权限,我是直接全选。
然后必须:
发布应用版本
安装/更新到企业
如需审批,等待管理员审批通过
5. 配置 Claude MCP
在项目目录创建 .mcp.json,内容类似:
{
"mcpServers": {
"lark-mcp": {
"command": "cmd",
"args": [
"/c",
"lark-mcp",
"mcp",
"--oauth",
"--scope",
"offline_access auth:user.id:read docx:document im:message bitable:app calendar:calendar wiki:wiki
contact:user.id:readonly",
"--host",
"localhost",
"-p",
"3000",
"-t",
"preset.im.default,preset.doc.default,preset.base.default,preset.base.batch,preset.calendar.default,docx.v1.docume
nt.create,docx.v1.document.get,docx.v1.documentBlock.list,docx.v1.documentBlockChildren.create,docx.v1.documentBlo
ck.patch,docx.v1.documentBlock.batchUpdate,docx.v1.documentBlockChildren.batchDelete,calendar.v4.calendarEvent.lis
t,calendar.v4.calendarEvent.search,calendar.v4.calendar.list",
"-l",
"zh"
],
"env": {
"APP_ID": "${FEISHU_APP_ID}",
"APP_SECRET": "${FEISHU_APP_SECRET}",
"LARK_DOMAIN": "https://open.feishu.cn"
}
}
}
}
6. OAuth 登录授权
$appId = [Environment]::GetEnvironmentVariable("FEISHU_APP_ID", "User")
$appSecret = [Environment]::GetEnvironmentVariable("FEISHU_APP_SECRET", "User")
lark-mcp login -a $appId -s $appSecret --host localhost -p 3000 --scope "offline_access auth:user.id:read
docx:document im:message bitable:app calendar:calendar wiki:wiki contact:user.id:readonly"
浏览器打开后完成授权。
验证:
lark-mcp whoami
看到 scopes 包含文档、消息、日历、多维表格权限即可。
7. 启动 Claude
重启 Claude Code,进入包含 .mcp.json 的目录。如果提示启用/信任 MCP,选择允许。
注意:API 权限只是应用权限。实际访问某个文档、表格、群聊时,还需要该账号或机器人对具体资源有权限。