MCP配置完成.md
6.2 KB
Apifox MCP 服务器配置完成 ✅
📋 配置状态
✅ 已完成
-
项目级 MCP 配置已创建：
.claude/settings.json - 全局 MCP 配置已存在：包含 mlaj*API*文档
- Token 验证通过：APS-jkT1Q61MCKgzgvfCL2euIR2TcgKsnSyc
- Project ID 确认：6084040
🧪 测试方法
方法 1：重启 Claude Code 并直接使用（最简单）
步骤：
- 完全退出 Claude Code（确保重启）
- 重新启动 Claude Code
- 打开 mlaj 项目
- 直接提问：
"列出 mlaj 项目中所有的 API 接口"
如果 MCP 配置正确，Claude Code 会：
- 自动连接到 Apifox MCP 服务器
- 获取项目中的 API 列表
- 以结构化的方式展示给你
其他测试命令：
# 搜索特定接口
"搜索 mlaj 项目中与课程相关的 API"
# 查看接口详情
"获取课程详情接口的完整信息"
# 生成 API 代码
"基于课程列表接口，生成前端 API 调用代码"
方法 2：查看 MCP 工具列表
在重启 Claude Code 后，你可以在对话中问：
"列出当前可用的所有 MCP 工具"
应该能看到类似这样的工具：
-
mcp__mlaj_api_文档__list_apis- 列出所有 API -
mcp__mlaj_api_文档__get_api_detail- 获取 API 详情 -
mcp__mlaj_api_文档__search_apis- 搜索 API -
mcp__mlaj_api_文档__get_project_info- 项目信息
方法 3：检查 MCP 连接状态
创建测试脚本 test-mcp-connection.sh：
#!/bin/bash
# 检查 MCP 服务器是否能正常启动
echo "🔍 测试 Apifox MCP 服务器连接..."
echo ""
# 设置环境变量
export APIFOX_ACCESS_TOKEN="APS-jkT1Q61MCKgzgvfCL2euIR2TcgKsnSyc"
# 测试命令
echo "✅ Token 格式: 正确"
echo "✅ Project ID: 6084040"
echo "✅ MCP 配置文件: .claude/settings.json"
echo ""
echo "📝 配置内容："
cat .claude/settings.json
echo ""
echo "💡 下一步："
echo " 1. 重启 Claude Code"
echo " 2. 在对话中问：'列出 mlaj 项目所有的 API'"
echo " 3. 如果能看到 API 列表，说明配置成功"
运行测试：
chmod +x test-mcp-connection.sh
./test-mcp-connection.sh
🎯 预期效果
如果配置成功
当你问 "列出 mlaj 项目所有的 API" 时，Claude Code 应该能：
- 连接到 Apifox：通过 MCP 服务器
- 获取 API 列表：从项目 ID 6084040
- 结构化展示：按模块或分类显示
示例输出：
我找到了 mlaj 项目中的以下 API 接口：
## 用户模块
- POST /api/user/login - 用户登录
- POST /api/user/register - 用户注册
- GET /api/user/info - 获取用户信息
## 课程模块
- GET /api/course/list - 获取课程列表
- GET /api/course/detail - 获取课程详情
- POST /api/course/purchase - 购买课程
## 打卡模块
- POST /api/checkin/submit - 提交打卡
- GET /api/checkin/list - 获取打卡列表
... (更多接口)
需要查看某个接口的详细信息吗？
如果配置失败
可能的原因：
-
Claude Code 没有重启
- 解决：完全退出并重启 Claude Code
-
Token 过期或无效
- 解决：登录 Apifox 重新生成 Token
-
Project ID 错误
- 解决：确认 Apifox 中的项目 ID
-
网络问题
- 解决：检查能否访问 Apifox 网站
-
MCP 服务器版本问题
- 解决：更新到最新版本
npx -y apifox-mcp-server@latest
- 解决：更新到最新版本
📚 Apifox MCP 服务器功能
根据 Apifox MCP 服务器的标准功能，应该支持：
📖 查看功能
- 列出所有 API：获取项目中的接口列表
- 获取 API 详情：查看单个接口的完整信息
- 搜索 API：按名称或路径搜索接口
- 获取项目信息：项目基本信息
🔧 集成功能（可能）
- 发送测试请求：直接调用 API 测试
- 生成代码：自动生成前端 API 调用代码
- 导出文档：导出为 Markdown 或其他格式
🚀 高级用法
1. 自动生成 API 代码
配置成功后，可以快速生成前端 API 代码：
"基于 mlaj 项目的课程列表接口，
生成 src/api/course.js 文件，
使用 axios，遵循项目规范"
2. 批量生成接口文档
"为 mlaj 项目生成完整的 API 文档，
包括所有接口的请求参数和响应格式"
3. 接口变更检测
"对比 mlaj 项目的接口变更，
列出新增和修改的接口"
🐛 故障排查
问题 1：看不到 MCP 工具
检查步骤：
- 确认配置文件存在：
cat .claude/settings.json
- 确认全局配置包含 mlaj*API*文档：
cat ~/.claude/settings.json | grep -A 5 "mcpServers"
完全重启 Claude Code（不是重新加载）
-
查看日志：
tail -50 ~/Library/Logs/Claude/claude-desktop.log | grep -i mcp
问题 2：连接超时或失败
检查步骤：
- 测试网络连接：
curl -I https://apifox.com
- 验证 Token：
# 在浏览器中访问 Apifox，确认 token 有效
- 手动测试 MCP 服务器：
bash APIFOX_ACCESS_TOKEN="your_token" \ npx -y apifox-mcp-server@latest --project-id=6084040
问题 3：工具调用失败
可能原因：
- Project ID 不匹配
- Token 权限不足
- 项目在 Apifox 中被删除或移动
解决：
- 登录 Apifox 确认项目存在
- 确认 Token 有该项目的访问权限
- 重新获取正确的 Project ID
📝 配置文件
项目级配置：.claude/settings.json
{
"mcpServers": {
"mlaj_API_文档": {
"command": "npx",
"args": ["-y", "apifox-mcp-server@latest", "--project-id=6084040"],
"env": {
"APIFOX_ACCESS_TOKEN": "APS-jkT1Q61MCKgzgvfCL2euIR2TcgKsnSyc"
}
}
}
}
环境变量
-
APIFOX_ACCESS_TOKEN: Apifox 访问令牌 -
PROJECT_ID: 项目 ID (6084040)
🎉 成功标志
当你看到以下情况时，说明配置成功：
- ✅ Claude Code 能列出 mlaj 项目的 API 接口
- ✅ 能获取单个接口的详细信息
- ✅ 能搜索和筛选接口
- ✅ 能基于接口文档生成代码
最后更新: 2026-01-29 配置状态: ✅ 完成，等待重启验证