最新

Claude 怎么用 MCP 接上本地工具

让 Claude 读本地文件、查数据库,靠的是 MCP。这篇讲配置怎么写、服务怎么先跑通、权限给多大、报错从哪看。

聊天框里的 Claude 只能看见你粘进去的东西。MCP 是一套让模型调用外部工具的标准:本地起一个小服务,把读文件、查数据库、调接口这些能力暴露出去,Claude 通过它执行操作。配好之后,问一句这个目录里有哪些日志,它自己去列,不用你复制粘贴。

入口在哪

  • 桌面客户端通过一个 JSON 配置文件登记服务,文件在用户配置目录下,名字里带 config。
  • 网页版走连接器目录,添加现成的第三方服务,不用自己写配置。
  • 不同客户端版本的入口名称略有差别,先确认自己的版本支持 MCP,再找配置文件或连接器页面。
  • 有的版本把连接器放在设置里的功能开关后面,要先打开开关才出现,装完看不到入口时先翻一遍设置。

具体步骤

  1. 确认运行环境。多数本地服务用 Node 或 Python 启动,先装好运行时,确认命令行能跑。
  2. 先在终端里手动跑一次服务命令,能正常启动、不报缺包,再去写配置。
  3. 在配置里登记服务:给个短名字,写清启动命令、参数和环境变量,路径一律写绝对路径。
  4. 需要密钥的服务把密钥放进环境变量,不要写进会提交到代码仓库的文件。
  5. 完全退出客户端再重开,配置文件是启动时读的,热改不生效。
  6. 重开后看工具列表里有没有新服务,先用只读操作试,比如列目录、查一条记录。

几个坑

  • 用相对路径启动。客户端的工作目录和你终端里不一样,服务直接起不来。
  • 权限给太大。能删文件、能执行任意命令的服务,先只给读权限,确认行为再加写。
  • Windows 上命令名要写全。脚本类命令常需要带扩展名,只写名字会提示找不到。
  • 配置文件少一个逗号就整体失效。改完用能校验 JSON 的编辑器看一眼再重启。

怎么验证

先看客户端里的工具是否出现,出现说明启动成功。再让它做一个只读动作,比如列出某个目录的文件名,结果和你在终端里看到的一致才算通。最后看客户端日志,服务崩溃时会写在那里,报错一般集中在找不到命令、缺模块、路径不存在这三类。

常见问题

配好了但对话里看不到工具

先确认客户端是完整退出后重启的,再看配置文件路径对不对。路径对了还不显示,多半是服务启动即退出,去日志里找原因。

能不能同时接多个服务

可以,在配置里并列登记多个即可。服务多了上下文会变长,也会增加误调用的概率,常用的留两三个就够。

让模型执行写操作安全吗

取决于你给服务的权限。稳妥做法是先用只读服务跑一段时间,确认它调用的时机和参数合理,再换可写版本,并且只指向测试目录。

一句话总结:MCP 的关键是先把服务在终端里跑通,再写绝对路径的配置,权限从只读给起,出问题先看日志。