←AI 实践笔记

Lesson 05 · s19 MCP

同一个 MCP,
两种用法

MCP 本身很小:外部服务用统一格式回答两个问题。有意思的是同一个钉钉 MCP, 在 Claude Code 里和在你分身里,接法完全相反——而且两边都对。

MCP 只做两件事

它规定的服务端要答什么对应第 1 课的哪一步
tools/list「我有这些工具」——每个工具一份声明:名字、描述、参数 schema发说明书那一步,只是说明书从外面来
tools/call「你调的这个,结果是……」你的代码执行那一步,只是执行发生在别的进程里

传输是 JSON-RPC,走子进程的 stdin/stdout 或者 HTTP。仅此而已。 它没有规定谁来选工具、谁能看到工具——那是接入方的事。这一课讲的就是这个空白怎么填。

用法一:Claude Code——发现了就进工具池

s19 的 assemble_tool_pool():连上一个 server,把 tools/list 回来的声明直接并进模型的工具列表, 名字前面加 mcp__{server}__ 防撞名。之后对模型来说,它和 Bash 没区别——都是一份声明,它读描述、填表。

证据就在我这次会话的工具列表里,原样:

mcp__dingtalk-doc__get_document_content
mcp__dingtalk-doc__create_document
mcp__dingtalk-doc__delete_document
mcp__dingtalk-doc__add_permission
mcp__yunxiao__search_workitems
mcp__drawio__create_new_diagram
…

注意钉钉那几个:读、建、删、授权,全在里面。谁选?我选。在第 3 课的表里,这一格归「模型 + 文字」。

用法二:你的分身——模型一个也看不到

ADR-0044 三个「不」,原文:

群消息与模型都不能提交任意 server、tool name 或参数,也不能动态发现后直接调用。……模型和群消息都不参与选择优先级。

mcp_gateway.py 里是这么落的:

s19 的做法你的做法
运行时 connect_mcp,动态发现启动时代码里注册,DINGTALK_ALLOWED_TOOLS = ("get_document_info", "get_document_content")
发现的工具进模型工具池DeepSeek 的工具列表里没有任何 MCP 工具,只有 get_weather
模型选调哪个代码按链接 host 确定性路由:钉钉域名 → 固定调那两个读工具
读写都暴露,靠标注区分写能力一律不开,「今后若需要必须重新设计和决策」
进程内 SDK受限 Python 3.11 子进程(主服务在 3.9,SDK 要 3.10+)

所以在第 3 课的表里,你的 MCP 整个在「代码」格。模型连 MCP 存在都不知道。 它只知道「有人分享了一个链接,正文是这段」——正文是 LinkMaterialReader 拿回来塞进文字的。

为什么反着用是对的

同一个钉钉 MCP server:在 Claude Code 里,给我开了建、删、授权;在分身里,只开两个读。 差别不在协议,在谁坐在模型那个位置、出了事谁兜底:

MCP 是传输,不是权限。把一个 server 接进来,等于拿到它的全部工具;开多少给模型,是接入方的决定。 你的 ADR-0044 把这个决定写得很硬,硬得对。

和「群里接 BRD」的关系

两条直接推论:

  1. wanghuo-dingtalk-prd-attachment-uploader 要写钉钉。分身的 MCP 网关不开写,这是 ADR-0044 的硬约束,不是保守——所以第 4 课说「上传留给人」。
  2. 如果走子进程路径,子进程里的 Claude Code 用的是它自己的 MCP 配置,那里面有写工具。子进程的 MCP 权限 ≠ 分身的 MCP 权限。这条边界要在动代码前先划——ADR-0042 讲的「钉钉链接继承 MCP 身份权限」是相关的,但我没逐行核它覆不覆盖子进程这条。

回想一下

MCP 让外部服务用统一格式回答的两个问题是什么?

tools/list 和 tools/call。前者送回一批声明(第 1 课的说明书),后者替你执行。谁能看到这些声明、谁来选,协议不管。

在你的分身里,DeepSeek 能看到几个钉钉 MCP 的工具?

它的工具列表里只有 get_weather。钉钉读取由 McpGateway 在代码里按 host 路由,模型拿到的是读回来的正文,不是工具。ADR-0044:「模型和群消息都不参与选择」。

mcp__dingtalk-doc__get_document_content 这个前缀是为了什么?

两个 server 都有 search 怎么办?加 mcp__{server}__ 前缀,再把非法字符换成下划线(s19 的 normalize_mcp_name)。只读/破坏性是另一套标注,不靠名字。

下一步

读这一份: MCP 官方 · Introduction。 看完 tools 那一段就够。你会发现它讲的东西比这一课少——因为协议本身就只有那么多,剩下的全是接入方的选择。