MCP Gateway 和工具连接排查
Rshift MCP Gateway 让工作区可以通过统一入口使用已授权营销、内容、监控和分析工具。
你需要准备什么
一个已开通 MCP 能力的 Rshift 工作区。
工作区 AI 页面里的 MCP URL，格式通常是
https://mcp.rshift.com/<workspace>/。工作区 MCP 密钥。新生成或重新生成后会显示完整值，请立即放到目标客户端配置里。
支持 HTTP MCP server 和
Authorizationheader 的客户端。
不同客户端的配置格式不一样。Rshift 页面里的 JSON 适合 Cursor 这类使用 mcpServers 的客户端；VS Code 使用 servers，Codex 使用 config.toml。
按客户端查看详细接入方式
Claude Code：使用
claude mcp add --transport http ... --header ...添加 Rshift MCP server。Cursor：在 Tools & MCP 中编辑
mcp.json，使用mcpServers配置。VS Code：通过 MCP: Add Server 或
mcp.json添加 HTTP server，配置顶层是servers。Codex：在
config.toml的[mcp_servers.rshift]中添加 remote MCP server。ChatGPT：当前不要直接接入通用 Rshift MCP Gateway；需要 ChatGPT 专用 app / OAuth / 工具范围控制。
常见问题
当前套餐不包含私有 MCP catalog。
工作区没有启用 MCP Gateway。
MCP API key 过期或被重置。
工具没有被当前 workspace 授权。
工具调用需要平台接入先完成。
客户端不支持自定义
Authorizationheader。把一个客户端的配置格式直接粘贴到另一个客户端，例如把 Cursor 的
mcpServersJSON 粘贴给 VS Code 或 Codex。
你可以检查
工作区套餐和 MCP 权限。
MCP Gateway 是否启用。
目标工具是否在 catalog 中。
相关平台账号是否已连接。
客户端是否使用最新的 gateway endpoint。
URL、header 名称和值是否和 Rshift 页面一致。
配置格式是否符合当前客户端要求。
密钥说明
MCP 密钥是工作区级密钥。它不是你的登录密码，也不是平台账号 token。旧密钥如果只保存了 hash，Rshift 不能反查明文；需要查看完整值时，请重新生成密钥并更新客户端配置。
支持边界
Rshift 支持可以解释 gateway 状态、工具可用性和错误分类。不要在 Intercom 里发送 MCP API key、工具输入输出、客户数据或私有工具代码。