使用说明
同步调试MCP服务器
无同步,编码代理通常会猜测并仅修复症状,因此您可能需要多次提示代理以修复根本原因。
同步,代理商可以一次性解决根本原因。同步捕获 运行时事实 (堆栈跟踪、日志、请求/响应、函数参数和关键变量值),并使其可由AI代理通过以下方式查询 主控程序--因此,代理使用证据而不是猜测进行调试。
与以下内容一起使用:
安装
[!注意] 推荐API密钥:在获取免费API密钥 syn-cause.com/dashboard 对于更高的速率限制。
通用MCP配置适用于大多数工具:
{
"mcpServers": {
"syncause-debug-mcp": {
"command": "npx",
"args": ["-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" }
}
}
}
在客户端中配置
Install in Cursor
编辑 .cursor/mcp.json (项目)或 ~/.cursor/mcp.json (全球):
{
"mcpServers": {
"syncause-debug-mcp": {
"command": "npx",
"args": ["-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" }
}
}
}
Install in VS Code
编辑 .vscode/settings.json:
{
"mcp.servers": {
"syncause-debug-mcp": {
"command": "npx",
"args": ["-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" }
}
}
}
Install in Antigravity
编辑 ~/.gemini/antigravity/mcp_config.json (全球):
{
"mcp.servers": {
"syncause-debug-mcp": {
"command": "npx",
"args": ["-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" }
}
}
}
Install in Claude Code
运行此命令(本地stdio服务器):
API_KEY=YOUR_API_KEY claude mcp add syncause-debug-mcp -- npx -y @syncause/debug-mcp@latest
Install in OpenAI Codex (CLI)
API_KEY=YOUR_API_KEY codex mcp add syncause-debug-mcp --command "npx -y @syncause/debug-mcp@latest"
Install in Gemini CLI
API_KEY=YOUR_API_KEY gemini mcp add syncause-debug-mcp -- npx -y @syncause/debug-mcp@latest
Install in Windsurf
编辑 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"syncause-debug-mcp": {
"command": "npx",
"args": ["-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" }
}
}
}
Install in Goose
编辑 ~/.config/goose/config.yaml:
extensions:
syncause-debug-mcp:
type: stdio
name: Syncause Debug MCP
enabled: true
timeout: 300
cmd: npx
args: ["-y", "@syncause/debug-mcp@latest"]
envs:
API_KEY: "YOUR_API_KEY"
Install in Opencode
将此添加到您的Opencode配置中:
{
"mcp": {
"syncause-debug-mcp": {
"type": "local",
"command": ["npx", "-y", "@syncause/debug-mcp@latest"],
"env": { "API_KEY": "YOUR_API_KEY" },
"enabled": true
}
}
}
故障排除
npx: command not found→ 安装Node.js(或确保你的shell可以找到它)。- 服务器无法在客户端启动 → 首先尝试在终端中直接运行MCP服务器:
npx -y @syncause/debug-mcp@latest - Env未应用 → 许多客户端在配置更改后需要重新启动。
安全说明
- 你的
API_KEY是敏感的。避免将MCP配置文件提交到Git。 - 仅当需要每个仓库隔离时,才首选项目级配置。
