MCP 飞书集成

🎯 什么是 MCP 飞书集成？

Model Context Protocol (MCP) 是 Anthropic 提出的开放标准，用于统一 AI 模型与外部工具的交互方式。MCP 飞书集成就是把飞书的能力"翻译"成 MCP 语言：

🔧 MCP 工具分类

🚀 实战示例

示例1：自动创建会议

# Agent 自动创建飞书会议

# 用户消息：帮我安排明天下午3点的团队会议

# Agent 调用链：
1. feishu_calendar_calendar(action="primary")  # 获取主日历
2. feishu_calendar_event(action="create",       # 创建日程
    summary="团队周会",
    start_time="2026-06-06T15:00:00+08:00",
    end_time="2026-06-06T16:00:00+08:00",
    attendees=[{"type": "user", "id": "ou_xxx"}],
    vchat={"vc_type": "vc"})  # 自动创建视频会议

# 结果：日程创建成功，参会人收到通知

示例2：自动读写多维表格

# Agent 操作多维表格

# 查询销售数据
feishu_bitable_app_table_record(
    action="list",
    app_token="xxx",
    table_id="tblxxx",
    filter={
        "conjunction": "and",
        "conditions": [{
            "field_name": "状态",
            "operator": "is",
            "value": ["已完成"]
        }]
    },
    sort=[{"field_name": "金额", "desc": True}]
)

# 写入新记录
feishu_bitable_app_table_record(
    action="create",
    app_token="xxx",
    table_id="tblxxx",
    fields={
        "客户名称": "ABC公司",
        "金额": 50000,
        "状态": "进行中",
        "负责人": [{"id": "ou_xxx"}]
    }
)

示例3：自动管理任务

# Agent 创建并分配任务

# 创建任务清单
feishu_task_tasklist(action="create", name="Q2营销计划")

# 创建任务
feishu_task_task(action="create",
    summary="完成竞品分析报告",
    description="分析5家主要竞品的产品特点和市场策略",
    due={"timestamp": "2026-06-10T18:00:00+08:00"},
    members=[{"id": "ou_xxx", "type": "user", "role": "assignee"}]
)

# 添加子任务
feishu_task_subtask(action="create",
    task_guid="xxx",
    summary="收集竞品数据"
)

# 添加评论
feishu_task_comment(action="create",
    task_guid="xxx",
    content="已收集3家竞品数据，剩余2家明天完成"
)

⚙️ MCP 配置方式

// OpenClaw 配置文件中的 MCP 设置
{
  "mcp": {
    "feishu": {
      "enabled": true,
      "transport": "http",
      "endpoint": "https://open.feishu.cn/mcp/v1",
      "auth": {
        "type": "oauth",
        "appId": "cli_xxx",
        "appSecret": "xxx"
      },
      "scopes": [
        "bitable:app",
        "calendar:calendar",
        "drive:drive",
        "im:message",
        "task:task"
      ]
    }
  }
}

💡 最佳实践

📚 相关术语