问题描述
在 Claude Code 中配置 Notion MCP 服务器时遇到连接失败的问题：
问题分析
通过诊断发现问题的根本原因：
- Notion API Token 有效：通过直接测试 Notion API 确认 token 可以正常工作
- 包安装问题：使用 npx -y @notionhq/notion-mcp-server 命令时存在初始化或兼容性问题
- 路径解析问题：npx 动态下载的包可能在 MCP 连接时出现路径或权限问题
解决方案
方法一：全局安装 + 完整路径（推荐）
- 全局安装 notion-mcp-server 包
- 查找可执行文件路径
- 移除现有的错误配置
- 使用完整路径重新配置
- 验证连接
成功标志
配置成功后，运行 claude mcp list 应该显示：
关键要点
- 使用全局安装避免 npx 动态下载权限问题
- 使用完整的可执行文件路径确保稳定连接
- 确保 Notion integration 有足够权限访问目标页面