飞书 MCP Pro 登录鉴权指南

概述

使用 @mi/feishu-mcp-pro 工具进行飞书授权登录，获取用户身份访问飞书文档。

登录命令

npx @mi/feishu-mcp-pro login

授权流程

1. 执行登录命令后，系统会自动打开浏览器进行授权
2. 如果浏览器没有自动打开，手动访问输出的授权链接
3. 在飞书授权页面完成登录和授权
4. 授权成功后，终端会显示登录信息

授权成功输出示例

✅ Login successful!
open_id: ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
expires: M/D/YYYY, H:MM:SS PM
refresh valid until: M/D/YYYY, H:MM:SS PM

授权信息说明

注意事项

• 授权方式: 浏览器 OAuth (用户身份)
• 环境要求: WSL2/Windows 环境
• 回调端口: 本地 9192 端口
• 授权范围: 包含文档、云文档、多维表格、幻灯片、日历、任务等权限
• 无需 APP 级鉴权: 直接使用用户身份登录

授权范围 (Scopes)

• docx:document – 文档读写
• drive:drive – 云文档
• bitable:app – 多维表格
• sheets:spreadsheet – 电子表格
• slides:presentation – 幻灯片
• calendar:calendar – 日历
• task:task – 任务
• contact:user.base:readonly – 联系人基础信息
• im:chat – 消息会话
• offline_access – 离线访问（获取 refresh_token）

使用场景

登录成功后，可以在 IDE 或工具中使用 mcp_feishu_mcp_pro_* 相关工具访问飞书资源。