整合MCP服务器
一 MCP（模型上下文协议） 服务器，让克劳德直接访问您的 合并 数据管道。让克劳德调查故障，检查节点，并用简单的英语理解你的管道——不要离开你的聊天室。
它做什么
故障调查 --主要用例。问克劳德：
- *“为什么95011失败了？”*
- *“最后一个小时失败了什么？”*
- *“显示故障节点的错误和SQL”*
克劳德会打电话的 investigate_failure，在一个响应中显示确切的错误消息、失败的SQL以及哪些下游节点被阻止。
节点检查 --浏览并阅读您的工作空间：
- *“显示节点X的列和变换”*
- *“这个临时工作台是什么样子的？”*
节点编辑 --以编程方式修改工作区节点（禁用 COALESCE_READONLY_MODE=true):
- *“更新此节点上的SQL”*
- *“创建新阶段节点”*
- *“将TRY_AST修复程序应用于故障列”*
快速开始
1.安装
# Recommended
uvx --from coalesce-mcp coalesce-mcp-server
# Or install globally
uv tool install coalesce-mcp2.获取您的API代币
- 登录Coalesce
- 首选 设置 → API令牌
- 创建一个令牌并复制它
3.配置克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"coalesce": {
"command": "uvx",
"args": ["--from", "coalesce-mcp", "coalesce-mcp-server"],
"env": {
"COALESCE_API_TOKEN": "your-token-here"
}
}
}
}重新启动克劳德桌面。你完了。
工具
故障调查
| 工具 | 说明 |
|---|---|
investigate_failure | 最佳起点。 在一次调用中运行元数据+失败节点（带有错误消息和SQL）+下游阻塞节点。 |
list_failed_runs | 列出最近失败的运行。使用此功能查找 run_id 调查。 |
list_job_runs | 列出所有最近运行的可选筛选器（状态、环境、限制）。 |
get_run_results | 运行的节点级结果——仅失败和阻塞节点，成功节点省略。 |
get_run | 特定运行的完整元数据。 |
get_run_status | 通过调度程序端点查看实时状态。 |
get_job_details | 运行元数据+提取的错误组合。 |
节点管理
| 工具 | 说明 |
|---|---|
list_workspace_nodes | 列出工作区中的所有节点。 |
list_environment_nodes | 列出环境中所有已部署的节点。 |
get_workspace_node | 完整节点配置——列、转换、源映射、SQL。 |
get_environment_node | 与上述部署（生产）节点相同。 |
create_workspace_node | 使用默认值创建新节点。 |
set_node | 现有节点的完全替换更新。 先读，再写。 |
patch_node_field | 手术单场更新（例如修复一列变换）。内部处理获取、修改、替换。 |
推荐的调查工作流程
1. list_failed_runs → find a run_id
2. investigate_failure → root cause + downstream impact
3. get_workspace_node → inspect the failing node's SQL and transforms
4. patch_node_field → apply the fix (with your approval)配置
| 变量 | 默认值 | 描述 |
|---|---|---|
COALESCE_API_TOKEN | 必需 | 来自Coalesce设置的承载令牌→ API令牌 |
COALESCE_BASE_URL | https://app.coalescesoftware.io/api/ | 覆盖本地部署 |
COALESCE_READONLY_MODE | false | 设置 true 隐藏 create_workspace_node, set_node，以及 patch_node_field |
在联合账户之间切换
切换帐户最简单的方法是更新 COALESCE_API_TOKEN 在你的 .env 文件。
复制 .env.example 到 .env 并填写您的令牌：
cp .env.example .env
# Edit .env and set COALESCE_API_TOKEN to your token要连接到其他帐户，请替换中的令牌值 .env 使用新帐户的令牌，然后重新启动MCP主机（Claude Desktop或Cortex CLI）。
# .env
COALESCE_API_TOKEN=your-new-account-token-here永不承诺.env到git。 它列在.gitignore.使用.env.example作为参考模板。
雪花皮CLI
将此添加到 ~/.snowflake/cortex/mcp.json，直接粘贴您的令牌：
{
"mcpServers": {
"coalesce": {
"command": "/path/to/coalesce-mcp-server",
"env": {
"COALESCE_API_TOKEN": "your-token-here",
"COALESCE_READONLY_MODE": "true"
}
}
}
}注： Cortex CLI不扩展shell变量——直接粘贴令牌值，而不是使用 ${COALESCE_API_TOKEN}.集 COALESCE_READONLY_MODE=true 如果您的代理角色是只读的。
发展
git clone https://github.com/JarredR092699/coalesce-mcp.git
cd coalesce-mcp
# Install with dev dependencies
uv sync
# Run tests
uv run pytest
# Install locally
uv tool install . --force需求
- Python 3.10+
- 具有API访问权限的联合帐户
许可证
麻省理工学院——见 许可证