MCP 与工具把数据库、浏览器和内部系统接进来
默认它只会读写文件、跑命令。MCP 让它直接查数据库、操作浏览器、调用内部接口,而不是让你当中间人复制粘贴。接什么、怎么接、接多了会怎样。
全部章节
本页
先说结论
- 只接你每天都要用的两三个:数据库、浏览器、团队的工单或知识库。接得越多,工具说明占的上下文越多。
- 优先用官方或维护活跃的 MCP 服务器;没有合适的,自己写一个也不难,一个 Python 文件就能把内部接口包成工具。
- 凭据不要写进会提交的配置文件,用环境变量引用。
它默认能做什么
Claude Code 自带的工具可以读写文件、搜索、跑 shell 命令、抓网页。凡是命令行能完成的事它都能做,比如用 psql 查库、用 curl 调接口,这已经覆盖了大部分需求。
MCP(Model Context Protocol)补的是剩下的部分:把一个系统的能力以「工具」的形式描述给它,告诉它有哪些操作、参数是什么、返回什么。比起让它拼 curl 命令,MCP 工具更稳定;权限也收在服务器那一端,更安全;还省上下文,不用每次把接口文档贴进对话。
怎么接
通用写法是告诉 Claude Code 怎么启动这个服务器:
claude mcp add --transport stdio <名字> -- <启动命令>以微软维护的浏览器服务器为例:
claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest也可以写在项目根目录的 .mcp.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 包一层就行。先安装依赖:
pip install "mcp[cli]" httpxPython 版十几行:
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 一样;不要把内部服务直接暴露到公网。