Cline

Cline 是 VSCode 上的开源 AI 编程插件。它支持 MCP 作为外部工具源。

前置条件

• Sigil 已安装 并启动
• VSCode + Cline 插件 v3.0+

第一步：在 Sigil 生成 Token

打开 Sigil → 左侧 MCP → 客户端管理 → 新增客户端：

• 名称：cline
• 范围：推荐"仅只读能力"（Cline 在写代码时调用频繁，限制范围降低风险）
• 过期：可设 30 天

复制 sk_sigil_xxxxxxxxxx。

第二步：在 Cline 添加 MCP Server

打开 VSCode → 点击侧边栏 Cline 图标 → 打开 Cline 面板。

点击右上角的设置图标 → MCP Servers。

点击 "Edit MCP Settings"，编辑器会打开类似：

{
  "mcpServers": {
    "sigil": {
      "transport": "http",
      "url": "http://127.0.0.1:8421/mcp",
      "headers": {
        "Authorization": "Bearer sk_sigil_xxxxxxxxxx"
      }
    }
  }
}

TIP

不同版本的 Cline 字段名略有差异——核心是 url + headers。如果你看到 command: "..." 字段，说明它用的是 stdio 配置示例，不适用于 Sigil。

保存。

第三步：验证连接

回到 Cline 面板，等几秒，MCP Servers 列表里应该出现 sigil，状态 Connected，下方列出可用工具。

试一次

在 Cline 对话框：

帮我查一下当前项目的 git status

Cline 会用 Sigil 暴露的 git_query 能力（如果你注册了对应的 Git 工作区）。

Cline 的特点：循环执行

Cline 与 Claude Code / Cursor 的不同是——它会自主循环执行多步操作："读文件 → 改代码 → 跑测试 → 再读 → 再改"，过程中可能频繁调用 MCP 工具。

这意味着：

• ✅ 高效完成多步任务（适合复杂重构、迁移）
• ⚠️ 工具调用次数远高于交互式客户端
• ⚠️ 中途出错可能连续触发多次（审计日志会快速增长）

针对 Cline 的推荐设置：

设置	推荐值	理由
Sigil 客户端 Token 范围	只读 + 受信 HTTP 模板	限制循环执行的写操作
凭据 Scope Policy	严格白名单	避免误用凭据
审计保留	至少 7 天	排查问题需要
Cline 自身的"是否允许执行命令"	谨慎 / 每次确认	Cline 配置项

多工作区切换

Cline 跟着 VSCode 的当前工作区走。如果你在 VSCode 里切到了 acme-backend 项目：

• Cline 看到的"当前路径"是 acme-backend
• 你说"帮我查最近提交"，Cline 调用 git_query.acme-backend（前提：你在 Sigil 注册过这个工作区）

Sigil 的工作区命名空间和 VSCode 的并不强绑定——同名工作区会自动联动，但你可以在 Sigil 里独立维护一份列表（如 acme-backend-prod / acme-backend-staging 同源仓库不同凭据）。

故障排查

Cline 显示 sigil 状态为 "Failed"

• 确认 Sigil 进程在跑
• 确认 Sigil → MCP 监听地址是 127.0.0.1:8421（如果端口变了，相应改 mcpServers 配置）
• Bearer Token 复制完整？没多/少空格？

Cline 不调用 Sigil 工具

Cline 的工具调用决策依赖系统 Prompt。可以在对话开头给提示：

请优先使用 sigil 提供的工具完成本次任务，特别是涉及 git/db/ssh 操作时。

或者在 Cline 的"Custom Instructions"里写上类似规则。

调用频率过高，审计被刷满

• 在 Sigil → 客户端管理 → cline → 设置调用频率限制（每分钟 N 次）
• 在 Cline 端开启"每次工具调用都确认"，降低频率

下一步

• 看通用 MCP 客户端：通用 MCP 客户端 →
• 看 Scope Policy 怎么细化：凭据金库 →
• 看审计日志怎么查：审计日志 →