---
id: "8824c79c7a16ad21204f"
url: "https://www.xmcsl.cn/project/feishu-cli-embed/05-mcp-guide/03-%E8%BF%9C%E7%A8%8B%20MCP%20%E6%94%AF%E6%8C%81%E7%9A%84%E5%B7%A5%E5%85%B7%E5%88%97%E8%A1%A8.html"
source_url: "https://open.feishu.cn/document/mcp_open_tools/supported-tools"
source_date: null
checked_at: "2026-11-05T04:21:48.909937+00:00"
status: "ready"
check_scope: "structure_only; not a factual or human review"
body_sha256: "a6f01fe551fd875c4348d349479778a88b47c5665af3a4dbfcae991e16decf24"
---

# 远程 MCP 支持的工具列表 · 飞书 Agent 接入知识库

目前仅支持云文档场景，工具正在不断扩展中，敬请期待。

 

## 通用工具

 

<a href="https://open.feishu.cn/document/mcp_open_tools/end-user-call-remote-mcp-server#ec2bbb8a">配置远程 MCP 服务</a>时，平台会自动为您开通以下通用的基础工具能力。

 

<table>&#10;<thead>&#10;<tr>&#10;<th>工具名称</th>&#10;<th>功能描述</th>&#10;<th>功能限制</th>&#10;<th>典型场景</th>&#10;<th>提示词样例</th>&#10;</tr>&#10;</thead>&#10;<tbody>&#10;<tr>&#10;<td><code>search-user</code></td>&#10;<td>根据关键词搜索企业内的用户，可获取用户的 ID、姓名、头像。<br><strong>注意事项</strong>：如有同名用户，则按照亲密度返回，与你更亲密的用户排序靠前。</td>&#10;<td>- 仅支持通过用户身份（user&#95;access&#95;token）调用该接口。<br>- 无法搜索到外部企业或已离职的用户。</td>&#10;<td>- 在不知道准确 ID 的情况下，通过姓名或邮箱快速查找同事。<br>- 需要联系某人或分配任务，但只记得对方名字的一部分，用于定位具体人员。</td>&#10;<td>- "帮我找一下公司里叫‘张三’的人"<br>- "搜索邮箱包含 'product&#95;team' 的相关用户。 "</td>&#10;</tr>&#10;<tr>&#10;<td><code>get-user</code></td>&#10;<td>获取用户本人的个人信息，也可通过用户 ID 获取其他用户的姓名、头像。</td>&#10;<td>- 用户信息仅包含：用户头像、名称、open id<br>- 仅可查询你在通讯录中可见的用户范围，详见管理员设置 &#91;组织架构可见性&#93;(https://www.feishu.cn/hc/zh-CN/articles/360049067480-%E7%AE%A1%E7%90%86%E5%91%98%E7%AE%A1%E7%90%86%E7%BB%84%E7%BB%87%E6%9E%B6%E6%9E%84%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4&#35;tabs0</td>&#10;<td>lineguid-Gu5cE)。</td>&#10;<td>- 查询当前登录用户的个人信息（如确认自己的 open id）。<br>- 在已知用户 ID 的情况下（例如从搜索结果中获得），获取该员工的头像和名称。</td>&#10;</tr>&#10;<tr>&#10;<td><code>fetch-file</code></td>&#10;<td>获取文件内容。根据文件 ID (file&#95;token)，获取文档中指定资源（文件或图片）的二进制内容。</td>&#10;<td>- 文件大小限制在 <strong>5 MB</strong> 以内<br>- 需要有素材的下载权限，即文档「<strong>权限设置</strong>」中，当前用户拥有下载权限，如下图：<br><img alt="image.png" src="https://www.xmcsl.cn/project/feishu-cli-embed/images/3696741c4537.png"></td>&#10;<td>- 读取云文档中嵌入的图片、图表或附件。<br>- 在自动化流程中，获取文档内特定资源的原始二进制数据以供后续处理。</td>&#10;<td>- "读取这篇文档里的架构图（图片）。 "<br>- "提取文档中那个名为‘Q4预算表.xlsx’的附件内容。 "</td>&#10;</tr>&#10;</tbody>&#10;</table>

 

## 云文档

 

<table>&#10;<thead>&#10;<tr>&#10;<th>工具名称</th>&#10;<th>功能描述</th>&#10;<th>功能限制</th>&#10;<th>典型场景</th>&#10;<th>提示词样例</th>&#10;</tr>&#10;</thead>&#10;<tbody>&#10;<tr>&#10;<td><code>search-doc</code></td>&#10;<td>搜索云文档。根据关键词、创建者等条件，在你的飞书云文档中进行精确或模糊搜索。</td>&#10;<td>- 仅可搜索 doc、docx 文档类型</td>&#10;<td>- 快速查找遗忘在海量文档中的关键信息。为撰写报告或方案时，收集内部相关资料。<br>- 回顾特定时期或特定成员的工作产出。</td>&#10;<td>- "帮我找一下上周由李明写的关于“Q4 规划”的文档。 "<br>- "搜索一下所有包含“AI Agent”和“RAG 优化”这两个关键词的文档。 "<br>- "查找我最近一个月内创建的所有周报。 "</td>&#10;</tr>&#10;<tr>&#10;<td><code>create-doc</code></td>&#10;<td>创建云文档。可在“我的文档库”或指定知识空间节点下创建一个新的云文档。<br><strong>注意事项</strong>：对于超长文档内容，超过客户端输入长度上限后，模型可调用更新文档内容（update-doc），续写内容。</td>&#10;<td>- 暂不支持插入已有的多维表格、电子表格、OKR、任务、日程、飞书项目等内容<br>- 无法创建文档小组件、同步块、旧版流程图、旧版思维笔记</td>&#10;<td>- 将与 AI 的对话内容、灵感或分析结果，快速沉淀为正式的飞书云文档。<br>- 自动生成格式化的报告、会议纪要或任务清单。</td>&#10;<td>- "帮我创建一个会议纪要，标题是“今天下午的产品评审会”，把它放在“项目A/会议记录”文件夹里。 "<br>- "根据我们刚才的讨论，生成一份“新功能需求文档”，内容包括：用户登录流程优化、增加第三方支付渠道、以及后台数据看板。 "</td>&#10;</tr>&#10;<tr>&#10;<td><code>fetch-doc</code></td>&#10;<td>查看云文档。根据文档链接，获取文档内的完整内容。<br><strong>注意事项</strong>：对于超长文档内容，AI 可分段读取。</td>&#10;<td>- 暂不支持多维表格、电子表格、OKR、任务、群名片、日程、飞书项目中的内容<br>- 无法读取旧版流程图、旧版思维笔记</td>&#10;<td>- 让 AI 阅读一篇指定的文档，并基于其内容进行总结、翻译、问答或二次创作。<br>- 在跨文档信息整合时，作为获取源内容的基础操作。</td>&#10;<td>- "阅读这篇文档 &#91;粘贴文档链接&#93;，然后帮我总结出三个核心要点。 "<br>- "分析一下这篇技术方案，看看其中提到的架构设计有哪些潜在风险。 "</td>&#10;</tr>&#10;<tr>&#10;<td><code>update-doc</code></td>&#10;<td>更新云文档。可在文档指定位置增加内容，也可完善或替换指定内容。</td>&#10;<td>&#42; 暂不支持通过链接锚点定位</td>&#10;<td>&#42; <strong>长文本续写</strong>：当生成内容较长时，通过在文档末尾分批追加内容，突破单次输出限制。<br><em> </em><em>内容修正与润色</em><em>：全量覆盖或局部修改指定内容，对已有初稿进行优化。<br></em> <strong>结构化插入</strong>：在特定章节（如“业务目标”）后精准插入补充信息（如“技术方案”）。<br><em> </em><em>文档动态维护</em>&#42;：根据最新进展，在指定层级或位置更新项目状态、会议结论等。</td>&#10;<td>&#42; "在文档 &#91;链接&#93; 的末尾追加一段关于‘竞品分析’的总结。" <br><em> "在这篇周报的末尾，帮我追加一段“下周计划”：1. 完成用户调研报告；2. 跟进设计稿进度。" <br></em> "把文档中‘项目背景’这一段的内容替换成我刚才发给你的最新版本。" <br>&#42; "在‘产品功能’标题后面，插入一段关于‘移动端适配’的具体描述。"</td>&#10;</tr>&#10;<tr>&#10;<td><code>list-docs</code></td>&#10;<td>获取指定知识空间节点下的云文档列表。支持分页。</td>&#10;<td>&#42; 知识空间节点下的子知识空间，需要 AI 自行遍历获取。</td>&#10;<td>&#42; <strong>目录浏览</strong>：快速了解某个项目文件夹或知识库节点下包含哪些文档。<br><em> </em><em>批量处理准备</em>&#42;：在对某组文档进行批量总结或分析前，先获取文档清单。</td>&#10;<td>&#42; "分析 &#91;wiki 链接&#93; 下的所有文档，归纳其中最常见的技术问题。" <br>&#42; "列出我的文档库下的所有文档"</td>&#10;</tr>&#10;<tr>&#10;<td><code>get-comments</code></td>&#10;<td>查看指定云文档中的全文评论和划词评论。</td>&#10;<td>&#42; 仅支持 emoji、文字、文档类型的评论 <br>&#42; 暂不支持获取评论中的图片</td>&#10;<td>&#42; <strong>反馈收集</strong>：无需打开文档，直接获取同事在文档中留下的修改意见或疑问。<br><em> </em><em>待办整理</em>&#42;：将文档中的评论提取出来，转化为下一步的工作计划或待办事项。</td>&#10;<td>&#42; "帮我提取这篇文档 &#91;链接&#93; 里的所有评论，看看大家都有什么修改意见。" <br>&#42; "阅读这篇方案的所有评论，总结三条大家最关注的问题。"</td>&#10;</tr>&#10;<tr>&#10;<td><code>add-comments</code></td>&#10;<td>添加全文评论。在指定云文档中添加文档评论。</td>&#10;<td>&#42; 仅支持添加全文评论，暂不支持划词评论。<br>&#42; 暂不支持上传图片到评论中</td>&#10;<td>&#42; <strong>快速互动</strong>：在阅读完 AI 总结的文档内容后，直接通过对话发表评价或反馈。<br><em> </em><em>审核记录</em>&#42;：在协作文档中快速记录审阅意见，提醒文档作者关注。</td>&#10;<td>&#42; "在这篇文档 &#91;链接&#93; 下面评论一句：‘方案整体可行，建议细化一下第三部分的预算。’" <br>&#42; "帮我根据文档审核要求评审下文档内容，并将评审建议添加到全文评论。"</td>&#10;</tr>&#10;</tbody>&#10;</table>

 

## 更新日志

 

### 2025.12.29

 

<ul>&#10;<li><strong>新增</strong>：云文档工具 <code>update-doc</code>（更新云文档）、<code>list-docs</code>（获取知识空间节点下的文档列表）、<code>get-comments</code>（查看全文评论与划词评论）、<code>add-comments</code>（添加全文评论）</li>&#10;<li><strong>更新</strong> ：<ul>&#10;<li><code>fetch-doc</code>(查看云文档)：支持分页读取，传入需要获取多少内容，避免单次获取的内容超过了客户端输出长度的限制。</li>&#10;<li><code>create-doc</code>（创建云文档）：对于超长文档内容，超过客户端输入长度上限后，模型可调用更新文档内容（<code>update-doc</code>），续写内容。</li>&#10;</ul>&#10;</li>&#10;</ul>

 

### 2025.12.19

 

<ul>&#10;<li>飞书「云文档」、「基础工具」工具集首次全量发布，支持云文档读写搜场景。</li>&#10;</ul>
