Claude Code 指南第 7 章进阶

MCP 与工具把数据库、浏览器和内部系统接进来

默认它只会读写文件、跑命令。MCP 让它直接查数据库、操作浏览器、调用内部接口,而不是让你当中间人复制粘贴。接什么、怎么接、接多了会怎样。

更新于 2026年10月17日 · 依据 Claude Code 2.1.301 官方文档核对 · AGI Dawn 编辑部 · 审定 kk

全部章节
本页

先说结论

  • 只接你每天都要用的两三个:数据库、浏览器、团队的工单或知识库。接得越多,工具说明占的上下文越多。
  • 优先用官方或维护活跃的 MCP 服务器;没有合适的,自己写一个也不难,一个 Python 文件就能把内部接口包成工具。
  • 凭据不要写进会提交的配置文件,用环境变量引用。

它默认能做什么

Claude Code 自带的工具可以读写文件、搜索、跑 shell 命令、抓网页。凡是命令行能完成的事它都能做,比如用 psql 查库、用 curl 调接口,这已经覆盖了大部分需求。

MCP(Model Context Protocol)补的是剩下的部分:把一个系统的能力以「工具」的形式描述给它,告诉它有哪些操作、参数是什么、返回什么。比起让它拼 curl 命令,MCP 工具更稳定;权限也收在服务器那一端,更安全;还省上下文,不用每次把接口文档贴进对话。

怎么接

通用写法是告诉 Claude Code 怎么启动这个服务器:

bash
claude mcp add --transport stdio <名字> -- <启动命令>

以微软维护的浏览器服务器为例:

bash
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

也可以写在项目根目录的 .mcp.json 里,这个文件可以提交,团队共用:

json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "ops": {
      "command": "python",
      "args": ["tools/ops_server.py"],
      "env": { "OPS_TOKEN": "${OPS_TOKEN}" }
    }
  }
}

${OPS_TOKEN} 从你的环境变量读取,凭据不落在仓库里。远程服务器(HTTP 传输)用 claude mcp add --transport http <名字> <地址>,需要登录的会弹出授权流程。会话里输入 /mcp 可以查看已接入的服务器和状态。

值得接的三类

数据库:接上之后可以直接问「昨天注册但没充值的用户有多少」,它会写查询、执行、解释结果。数据库厂商和社区都有对应的 MCP 服务器;挑选时看它最近是否还在更新、npm 或 PyPI 上有没有标记弃用。务必用只读账号连接,要改数据时让它生成 SQL,由你执行。

浏览器:Playwright 的服务器让它能打开页面、点击、截图、读取内容。复现前端 bug、验证改动效果、走一遍登录流程,都比你用文字描述「按钮点了没反应」高效得多。

团队系统:GitHub、Linear、Notion、飞书等都有现成的服务器。接上之后,「把这个 issue 做了,做完在 issue 里留言」一句话就能完成。

接多了会怎样

每个工具都有一段说明要让模型知道。通过 ANTHROPIC_BASE_URL 接入(包括本站)时,Claude Code 默认不启用按需检索(tool search),所有工具说明每一轮都会带上:接得越多,响应越慢、费用越高,还可能误用无关的工具。两个办法:按项目接而不是全局接(.mcp.json 只在该项目生效);暂时不用的在 /mcp 里关掉。另外,任务进行中接入或移除服务器会让缓存失效,最好在会话开始前配好。

自己写一个

内部系统没有现成的服务器,用官方 SDK 包一层就行。先安装依赖:

bash
pip install "mcp[cli]" httpx

Python 版十几行:

python
from mcp.server.fastmcp import FastMCP
import httpx, os

mcp = FastMCP("ops")

@mcp.tool()
def order_status(order_id: str) -> str:
    """查询订单状态。参数:订单号。返回状态与最近一次更新时间。"""
    r = httpx.get(
        f"https://ops.internal/orders/{order_id}",
        headers={"Authorization": f"Bearer {os.environ['OPS_TOKEN']}"},
        timeout=10,
    )
    return r.text

if __name__ == "__main__":
    mcp.run()

函数的 docstring 就是模型看到的工具说明,要写清楚什么时候用、参数含义、返回什么。保存为 tools/ops_server.py,按上面的 .mcp.json 接入即可。鉴权、限流、只读保护都放在这个文件里,模型一侧不接触凭据。

安全上要注意的

  • MCP 工具返回的内容会进入上下文,和抓取的网页一样,可能夹带诱导性的文字。外部来的数据只当数据,不当指令。
  • 写操作(改库、发消息、下单)在服务器端加确认,或只开放给测试环境;配合 权限模式 的规则和 Hooks。
  • 第三方服务器和任何依赖一样,先看来源与维护状况,优先用官方仓库。

常见问题

和 Hooks 有什么区别?

Hooks 是在它调用工具前后插入你的检查;MCP 是给它新的工具。一个管过程,一个管能力。

接入后它不用怎么办?

在任务里点名:「用 ops 工具查」;或者在 CLAUDE.md 里写清什么情况下用哪个工具。

远程 MCP 安全吗?

走 HTTPS 加授权,和调用任何第三方 API 一样;不要把内部服务直接暴露到公网。