告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 先把目标定清楚让 Cline 里的 Skill 去翻本地 docs这篇要干的事很具体在 Cline 里挂一个 MCP 文件检索 Skill让它去读本地docs目录把跟「API 鉴权」相关的段落捞出来生成一段摘要并且给出能点开的命中文件列表。整个过程控制在 10 分钟内跑完一次可验证的命中。适合谁如果你已经在用 Cline 写代码但每次问「鉴权逻辑在哪」都得手动翻目录那这套东西就是给你省时间的。MCP 在这里的角色相当于给 Cline 装了一个「本地文件搜索」的外挂工具Skill 则是告诉它「什么时候用这个工具、怎么用」。产物有三个缺一不可一份mcp.json配置、一段 Skill 调用日志、一份命中文件列表。这三个东西能同时拿出来才算这次跑通。我试过把检索范围放太大结果一次扫了整个仓库日志里全是噪音。所以下面会先把范围锁死在docs目录命中验证才干净。2. 操作步骤从建目录到跑出第一次命中2.1 准备一个可检索的 docs 目录先造一个最小可用的测试环境。假设你的工作目录是~/work/mcp-demo在里面建docs放两三个 Markdown 文件其中一个必须包含「API 鉴权」相关段落。mkdir -p ~/work/mcp-demo/docs cd ~/work/mcp-demo/docs cat auth.md EOF # API 鉴权说明 ## 鉴权方式 所有请求需要在 Header 中携带 Authorization 字段格式为 Bearer token。 ## Token 获取 登录后调用 /api/token 接口获取有效期 2 小时。 ## 常见错误 401 表示 Token 缺失或过期403 表示权限不足。 EOF cat quickstart.md EOF # 快速开始 安装依赖后运行 init 命令即可。 EOF这样docs里就有一个明确含「API 鉴权」段落的文件后面命中验证有据可查。2.2 安装并确认 Cline 可用在 VS Code 里装好 Cline 扩展打开~/work/mcp-demo作为工作区。Cline 的 MCP 配置入口在扩展设置里会读写一个mcp.json。不同版本路径略有差异通常在工作区级~/work/mcp-demo/.cline/mcp.json用户级VS Code 全局配置目录下的 Cline 配置我们统一用工作区级方便复现。先建目录mkdir -p ~/work/mcp-demo/.cline2.3 写 mcp.json挂一个文件检索 MCP Server这里用一个基于文件系统的检索服务。核心是让 MCP Server 暴露一个「按关键词搜文件」的工具Skill 再调用它。{ mcpServers: { docs-search: { command: npx, args: [ -y, modelcontextprotocol/server-filesystem, /Users/yourname/work/mcp-demo/docs ], env: { SEARCH_MODE: keyword } } } }把/Users/yourname/work/mcp-demo/docs换成你自己的绝对路径。server-filesystem会把该目录作为可访问根Cline 通过它读取和检索文件。注意路径必须是绝对路径相对路径在 MCP 启动时容易解析失败日志里会报 root not found。保存后重启 Cline在 MCP 面板里应该能看到docs-search处于 connected 状态。如果显示 failed先看 Cline 的输出日志多半是 npx 拉包超时或路径写错。2.4 定义 Skill检索 API 鉴权段落并生成摘要Skill 的本质是一段给模型的指令模板告诉它「用 docs-search 工具搜什么词输出什么格式」。在 Cline 的 Skill 配置里新增一个命名auth-doc-summary内容大致如下当用户询问 API 鉴权相关问题时 1. 调用 docs-search 工具关键词为 API 鉴权 和 Authorization。 2. 只保留 docs 目录下的 .md 文件命中结果。 3. 对每个命中文件摘出包含关键词的段落不超过 3 段。 4. 输出格式 - 命中文件列表带可点击路径 - 每个文件的鉴权摘要 - 若 0 命中明确说明未找到并列出已搜索的关键词这段指令决定了 Skill 的行为边界。关键词写死成两个是为了让命中结果可预期方便你验证。2.5 触发一次调用并抓日志在 Cline 对话框里输入用 auth-doc-summary 这个 Skill帮我找一下 docs 里 API 鉴权相关的段落生成摘要。Cline 会先调用docs-search拿到命中文件再按 Skill 模板生成摘要。调用日志在 Cline 的 MCP 输出面板里能看到形如[tool] docs-search.search [args] {keyword: API 鉴权, root: /Users/yourname/work/mcp-demo/docs} [result] matched: docs/auth.md [tool] docs-search.search [args] {keyword: Authorization, root: /Users/yourname/work/mcp-demo/docs} [result] matched: docs/auth.md日志里出现matched: docs/auth.md就说明检索链路通了。接下来是摘要生成这一步依赖模型所以要把供应商配好。3. TaoToken 接入与配置拿 Key 并设为默认供应商Cline 生成摘要需要调用模型。这里把 TaoToken 作为默认供应商接进来Base URL 填https://taotoken.net/api。第一步打开官网注册并创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册后在控制台创建 API Key复制出来。控制台入口https://taotoken.net/consoleKey 管理页在https://taotoken.net/api-keys第二步在 Cline 的模型设置里选 OpenAI Compatible 之类的自定义供应商填入Base URL: https://taotoken.net/api API Key: 你刚创建的 Key Model: 按官网当前可用列表选一个第三步保存后回到对话框重新触发一次 Skill。这次摘要会由模型生成日志里会多出模型调用记录。提示Base URL 结尾不要多加/v1或斜杠按https://taotoken.net/api原样填。填错最常见的表现是 404日志里能看到请求路径不对。如果你更习惯用命令行方式验证也可以直接用 curl 打一次curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_KEY \ -H Content-Type: application/json \ -d { model: 按官网可用列表填写, messages: [{role: user, content: 用一句话说明 API 鉴权里 401 和 403 的区别}] }返回正常就说明 Key 和 Base URL 都没问题再回到 Cline 里跑 Skill 就稳了。模型和价格以官网为准这里不写死具体型号。4. 可验证结果与失败分支4.1 三个产物对照检查跑通后你应该能同时拿到产物位置判定标准mcp.json~/work/mcp-demo/.cline/mcp.jsondocs-search状态 connectedSkill 调用日志Cline MCP 输出面板出现matched: docs/auth.md命中文件列表对话框输出列出docs/auth.md且路径可点开命中文件列表里点开docs/auth.md应该能看到「鉴权方式」「Token 获取」「常见错误」三段摘要。这就是一次可点开的命中验证。4.2 常见失败分支分支一MCP 显示 failed。多半是路径不是绝对路径或 npx 拉包失败。检查mcp.json里的路径手动跑一次npx -y modelcontextprotocol/server-filesystem 你的docs路径看能否启动。分支二日志里 0 命中。关键词和文件内容对不上。确认auth.md里确实有「API 鉴权」或「Authorization」字样大小写敏感的话换成小写再试。分支三检索命中但摘要为空。模型调用没通。回到第 3 节检查 Base URL 和 Key用 curl 单独验证一次。分支四401。Key 无效或没带上。检查 Cline 里 Key 是否粘贴完整有没有多余空格。分支五404。Base URL 写错常见是多了/v1或少了/api。按https://taotoken.net/api原样填。每个分支都能在日志里找到对应线索别急着改配置先看日志。5. 限制、成本与模型选择这套方案的边界要说清楚。MCP 文件检索只覆盖你授权的目录docs之外的文件它读不到这是安全设计不是 bug。检索基于关键词匹配语义相近但用词不同的段落可能漏掉需要你多设几个关键词。成本主要来自模型调用。检索本身是本地文件操作不产生费用摘要生成按 token 计费具体单价和可用模型以官网为准。如果 docs 很大建议先缩小检索范围再让模型摘要避免一次塞太多内容。模型选择上摘要任务对模型要求不高选一个响应快、价格合适的即可。Cline 里可以随时切换跑通后再按实际效果调整。长期高频使用的话可以看看 Coding Plan 这类方案https://taotoken.net/coding-plan接入文档和更多配置细节在https://taotoken.net/doc最后说个实用技巧把 Skill 的关键词做成可配置项而不是写死在模板里。这样换一个检索目标比如「数据库连接」或「部署流程」不用改 Skill 结构只改关键词就能复用。我踩过的坑就是一开始把关键词写死后来每换一个主题都得重写一遍 Skill白费不少时间。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度