Claude Code / 第 05 课
通过 MCP 连接 Claude Code 与外部服务
添加真正的 MCP 端点，完成认证并验证只读工具。
先阅读所用服务的 MCP 文档，普通 REST 地址不能直接当 MCP 服务器。本例使用 Claude Code 官方文档中的 Notion 端点，需要你自己的 Notion 账户及内容权限。
1. 注册服务器
在目标项目中执行以下命令，默认建立仅用于此项目的本地配置。只有希望将经审阅的 .mcp.json 与仓库共享时才使用 --scope project，不把令牌提交进配置。
shell
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp list
claude2. 认证并查看工具
在 Claude Code 会话中运行 /mcp，需要认证时按服务登录流程操作，阅读请求权限并确认连接状态。“Added”只代表配置已保存，不代表认证成功。
text
/mcp3. 验证小范围只读请求
选择有权访问的页面，请它读取标题、摘要和来源链接，核对工具名称与实际返回内容。读取权限不等于创建或编辑权限，不用破坏性操作测试连接。
text
Use the connected Notion tool to read the page I specify.
Return its title, three factual bullets, and its URL.
Do not create, edit, or delete anything.4. 排障或移除连接
401 通常对应认证，403 对应访问权限或策略；没有工具可能是端点错误或集成被禁用。先检查 /mcp、服务日志及服务文档。不再使用时按添加时相同作用域移除。
shell
claude mcp get notion
claude mcp remove notion练习与自检
YOUR TURN / 动手练习
连接一个服务，将只读结果与原页面核对，并找到断开方法。
完成后，花一点时间检查：
阅读官方原始资料
CLI 操作已对照官方文档核查；API 示例通过模拟响应测试。未登录产品账户进行完整实机演示。