跳到主要内容

MCP31 篇实战文章

Model Context Protocol(MCP)的配置与开发实战:Server 搭建、工具接入、鉴权与调试的一线踩坑。

一键三连一键三连

Agent 重试三次,客户收了三封日报

我那个跑日报的 agent,一个 workflow 平均要调四十来次工具,里面大概两次会走重试路径。上周它给同一个客户发了三封内容一模一样的日报。日志拉出来,三次调用全是 200。 改法一句话:给工具加一个由调用方传进来的 effectid,让它自己记账。 坑是这么来的。

Agent 重试三次,客户收了三封日报
阿简阿简

本周小抄:agent 记性差,多半坏在写入那一头

agent 答错的时候,第一反应总是模型不行。 这周收的几条材料给的是另一个答案:它该知道的东西散在别处,模型压根不知道那些东西存在。 散在哪?文档里、工具返回里、聊天记录里、issue 评论里、AGENTS.md 里、本地文件里、几个 API 的响应里。都在,就是不在它眼前。 dev.to 八月下旬那篇拆得最清楚。

本周小抄:agent 记性差,多半坏在写入那一头
书签客书签客

这篇讲 AI 记忆的,评论比正文更值得读

八月底 Marcos Somma 在 dev.to 发的那篇讲 AI 记忆的,我上周翻到,读完正文又翻完 45 条评论,今天才写。值得推的原因不是骨架新。MemGPT 的分层记忆、Letta 的有状态 agent、官方 MCP 示例里的知识图谱记忆服务器,作者自己在文里都列了,没装新架构。

这篇讲 AI 记忆的,评论比正文更值得读

还没跑起来,先学会了怕

那个数字我盯了很久:三周,20 万个 GitHub 星。一个开源的 agent harness,2026 年 8 月从零涨到这么多。同一段时间里,它的插件生态冲过了一万三千个仓库。 我当时没什么羡慕感,就一个念头:这背后有多少人,已经说不清自己机器上住过多少个 AI 插件了? 我就是那个人。

还没跑起来,先学会了怕
阿舟阿舟

少写一个注解,审批门等于不存在

先说那个让我反复确认了好一会儿的洞。 这个 agent 项目的架构我是认同的——判断力下放给 AI,执行权焊死在一个绕不开的卡口上,所有可能改动生产的行为最后都得过一道人类审批门。门由 harness 强制执行,不由 agent 自己决定"我觉得可以先斩后奏"。先跑通护栏,再谈自动化。

少写一个注解,审批门等于不存在
一键三连一键三连

MCP 工具清单不该住在你的上下文里

换过新会话的人应该都有这个体感:开完一个 Claude Code 会话,工具刚加载完,上下文的预算已经没了一大截。回头翻第一屏,全是 mcpservernametoolname 的函数签名——一个工具挨着一个工具,密密麻麻躺在那儿,像收租的。你真正想写的需求还没开始写,房租先交了一轮。

MCP 工具清单不该住在你的上下文里
画唠画唠

画开看看:MCP 的箭头我一直画反了

前几个月翻到一篇 Google Developer Experts 系列的文章,讲跨区域 agent 架构。看着看着我愣住了——不是学到了新东西那种愣,是发现自己之前画 MCP 的图一直画错了的那种。我一直把它画成“能力扩展”,它其实是“数据出口”。这两个画法差得不是一点半点。 先看我第一版的图。

画开看看:MCP 的箭头我一直画反了
号手号手

铸读:给分析类 MCP 定个形制

我把它叫做:铸读。先记着这两个字。 InsightsTrack 是个自托管分析项目,写着“隐私优先的 Google Analytics 替代品”。往下翻完功能列表我才看出来,它的野心不是换掉 GA——是把整套分析能力铸成 17 个只读 MCP 工具。

铸读:给分析类 MCP 定个形制
阿舟阿舟

差的不在协议,在上下文

我干过最蠢的事,是坐在那儿看 Claude Code 排查一个 Kubernetes 问题。它一遍又一遍地重复同样的三板斧:kubectl get、describe、logs——每一轮都把大段原始输出读进 context window,然后像个刚入职的实习生一样,从零开始拼凑“这个集群大概长什么样”。

差的不在协议,在上下文
一键三连一键三连

MCP 的依赖没上锁

你每天让 agent 读多少次 tool description?每个会话还没开口,它就把能调的工具描述扫一遍,按描述决定调谁不调谁。而你——可能和我一样——从来没校验过那句描述还是不是你上次看过的。 MCP server 本质上就是没上锁的依赖。

MCP 的依赖没上锁