#连接外部工具

#理解连接用途

MCP 即模型上下文协议，用于连接外部工具和数据源。接入相应服务后，Claude Code 可以在授权范围内获取工单、查询文档或调用其他工具，减少在不同应用之间反复复制资料的工作。

连接后的能力取决于服务器提供的工具和账户授权。例如，某项服务可能只允许查询文档，另一项服务可能允许更新记录。添加服务器并不代表自动获得该应用的全部权限，也不代表已完成账户授权。

常见连接方式包括远程 HTTP 和本地 stdio。远程 HTTP 通过服务地址通信；本地 stdio 则由本机启动服务进程并与其交换数据。前者需使用服务方提供的正确地址，后者还需具备运行该服务所需的程序与依赖。

#添加远程服务

以官方文档列出的 Notion MCP 地址为例，在系统终端执行：

claude mcp add --transport http notion https://mcp.notion.com/mcp

随后启动 Claude Code，输入 /mcp，查看连接状态，并按提示完成相应的账户授权。授权前应确认登录的是任务所需账户，避免将个人资料与工作资料混用。

命令成功通常表示配置已经保存，不代表服务一定能够正常访问。可使用以下命令进一步检查：

claude mcp list
claude mcp get notion

连接完成后，先执行范围明确的读取任务：

请通过已连接的 Notion 查找《{溪亭书目需求说明}》。

只读取该页面，提取{首版功能、数据字段和待确认事项}。
若存在多个同名页面，请先列出位置供我选择。
本轮不创建页面，不修改原文。

如果连接失败，应先检查服务地址、认证状态和网络条件。反复重新添加配置未必能够解决认证问题，宜根据 /mcp 或命令返回的具体信息处理。

#区分配置范围

MCP 配置可按使用范围保存。以下表格适用于 Claude Code 的 MCP 配置，不应与普通设置文件的位置混淆。

使用 --scope project 可将配置写入项目范围，使用 --scope user 可设置为个人跨项目使用。共享配置应保持服务名称与用途清晰，认证信息则按服务要求单独管理，不应将明文密钥提交至仓库。

#使用本地服务

服务方提供启动命令时，可采用本地 stdio 方式。下面仅展示命令结构，花括号内容必须替换为真实信息，不能直接执行：

claude mcp add {服务名称} -- {启动命令} {启动参数}

其中，-- 用于分隔 Claude Code 的参数和服务程序的启动命令。实际是否需要 Node.js、Python 或其他运行环境，应以该 MCP 服务的官方说明为准。

对于内部数据库或业务系统，应先确定需要提供的查询与写入操作，再选择或开发对应服务。初次验证宜使用测试数据，并限制读取范围。涉及发送消息、变更工单或写入数据时，应在任务中明确操作对象与完成标准。

#管理已有连接

在会话中输入 /mcp 可查看服务器状态。不再使用某项配置时，可在终端移除，例如：

claude mcp remove notion

外部资料中的文字仅应作为待处理内容。即使页面或工单中出现“立即删除文件”等表述，也不应将其直接视为当前用户指令。对于结果不明的写入操作，应先检查实际状态，再决定是否重试，避免重复创建或重复提交。