mcp

MCP（Model Context Protocol）

是什么

MCP 是连接 Agent 与外部系统的开放协议：以标准方式暴露 Tools、Resources、Prompts，由不同 Server 实现（GitHub、Linear、数据库、浏览器等）。

在 Harness 中，MCP 是「可插拔的能力模块」，避免为每个集成写一次性胶水代码。

在 Harness 中的位置

Model ──tool_call──► Harness MCP Client ──► MCP Server ──► 外部系统

核心概念

概念	说明
Server	提供能力的一方进程
Tool	可调用函数（带 JSON schema）
Resource	只读 URI 资源（文档、配置）
Prompt	服务端预置提示模板

设计要点

1. 先读 schema：调用前必须理解参数，减少无效调用。
2. 最小权限：Server 仅暴露任务所需工具。
3. 认证：OAuth/API key 由 Harness 管理，不进入 Model 权重。
4. 错误契约：结构化错误码便于 Model 重试或求助用户。

与内置 Tools

IDE 内置（读写文件、终端）通常不走 MCP；跨产品、跨团队复用的集成优先 MCP。

本目录文档

• mcp-integration.md — 集成与排错

---

← 返回知识体系