MCP:连接外部工具和资料

MCP 适合把 Claude Code 连接到外部上下文,比如文档、设计稿、数据库、工单系统和内部工具。

什么时候需要 MCP

MCP 可以理解成给 CC 接外部上下文和工具的标准接口。它不是新手第一天就要装的东西,而是在“仓库里的信息不够用”时才上。

什么时候不需要 MCP

常见 MCP 场景

第一次配置 MCP,默认只读。不要一上来给写权限、生产权限、删除权限。

MCP 不是万能上下文

MCP 适合稳定连接外部资料,但不适合把所有信息都塞进去:

情况建议
仓库里已有说明优先让 CC 读仓库
一次性背景直接贴脱敏摘要
长期项目事实写 CLAUDE.md
重复工作流程做 Skill
外部系统资料再考虑 MCP

先问“仓库里有没有”,再问“要不要 MCP”。这能避免把简单问题复杂化。

配置前先问 CC

请判断这个场景是否需要 MCP。

场景:
【描述需要连接的资料或工具】

请回答:
1. 不用 MCP 能不能完成。
2. 如果需要 MCP,需要连接什么。
3. 这个 MCP 应该只读还是可写。
4. 会不会涉及隐私、密钥或生产数据。
5. 第一次验证应该怎么做。

MCP 最小权限表

MCP 类型第一次建议权限高风险权限
文档只读指定空间或目录全公司文档读取
设计只读指定项目或页面修改设计稿
工单只读需求和验收标准自动改状态、自动关单
数据库只读 schema 或测试库生产写入、删除
日志只读脱敏摘要原始日志、隐私字段

任何 MCP 只要涉及真实用户、生产数据或写权限,都要单独人工确认。

MCP 权限怎么定

请帮我设计这个 MCP 的权限边界。

场景:
【写要连接的工具或资料】

请输出:
1. 这个 MCP 是否真的必要。
2. 最小权限应该是什么。
3. 是否只读就够。
4. 哪些数据不能暴露给 CC。
5. 第一次验证应该读取什么。
6. 什么情况下必须人工确认。

使用 MCP 时让 CC 标来源

MCP 引入外部资料后,最怕事实来源混在一起。可以要求 CC 标明信息来源:

使用 MCP 时,请标明信息来源。

请区分:
1. 来自当前仓库的事实。
2. 来自 MCP 的外部资料。
3. 来自用户描述的信息。
4. 你的推测。

如果来源冲突,请不要直接下结论,先说明冲突点。

第一次验证模板

请只读验证这个 MCP 是否可用。

要求:
1. 不要写入、删除或修改外部系统。
2. 只读取一个低风险测试资料。
3. 说明读取到了什么。
4. 说明哪些信息来自 MCP,哪些来自当前项目。
5. 如果权限过大或数据敏感,请提醒我收窄。

不要这样用 MCP

MCP 和 CLAUDE.md、Skills 的区别

如果只是告诉 CC “这个项目怎么跑”,写 CLAUDE.md;如果是“每次上线前怎么检查”,做 Skill;如果要“读取内部接口文档”,再考虑 MCP。

MCP 出问题怎么排查

MCP 似乎不可用,请先排查,不要修改项目代码。

请判断:
1. 是连接失败、权限不足、数据不存在,还是返回内容不符合预期。
2. 是否只影响 MCP,不影响当前项目。
3. 需要人工检查哪些配置。
4. 有没有不使用 MCP 的临时替代方案。
5. 不要要求我提供真实密钥。

验收结果