RudderStack

RudderStack MCP

通过托管的 Model Context Protocol (MCP) 服务，将 AI 助手和开发者工具连接到你的 RudderStack 工作区。

重要

此公开仓库包含注册表元数据、设置示例和托管 RudderStack MCP 服务的文档。它不包含服务实现的源代码，其 MIT 许可证仅适用于此仓库的内容。

• 端点： https://mcp.rudderstack.com/mcp
• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.0，通过浏览器登录 RudderStack 并授权
• 权威设置指南： RudderStack MCP 文档
• 工具参考： 读取和写入功能

连接

原生远程 MCP 客户端可以直接连接到：

https://mcp.rudderstack.com/mcp

首次连接时，客户端会打开浏览器，供你登录 RudderStack 并授权访问。这些配置文件中不应包含令牌或客户端密钥。

Claude Code

claude mcp add --transport http --scope user rudderstack https://mcp.rudderstack.com/mcp

然后在 Claude Code 中运行 /mcp，选择 rudderstack，选择 Authenticate，并在浏览器中登录 RudderStack。

Claude

在 设置 → 连接器 中，选择 添加自定义连接器，将其命名为 RudderStack，并输入 https://mcp.rudderstack.com/mcp。

对于需要本地 stdio 命令的客户端，请使用：

npx -y mcp-remote https://mcp.rudderstack.com/mcp

相应的 JSON 配置请参阅 examples/.mcp.json。

ChatGPT

在 RudderStack 出现在 ChatGPT 应用目录之前，请将其添加为自定义 MCP 服务：打开 插件，选择 +，选择 添加自定义 MCP 服务，将其命名为 RudderStack，输入 https://mcp.rudderstack.com/mcp，选择 OAuth，然后登录 RudderStack。如果没有此选项，请在 设置 → 安全和登录 下启用 开发者模式，或请工作区管理员允许自定义 MCP 服务。请参阅 OpenAI 的指南：在 ChatGPT 中连接自定义 MCP 服务。

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.rudderstack]
url = "https://mcp.rudderstack.com/mcp"

然后运行 codex mcp login rudderstack，并在浏览器中登录 RudderStack。

VS Code

在工作区中创建 .vscode/mcp.json，使用 examples/.vscode/mcp.json，然后通过 VS Code 的 MCP 控制项启动 rudderstack 服务。

Cursor

将 examples/.cursor/mcp.json 复制到 .cursor/mcp.json，然后在 设置 → 工具与集成 → MCP 工具 中启用 rudderstack。

Cline

在 Cline 中，打开 MCP 服务 → 远程服务，添加一个名为 rudderstack 的服务，URL 为 https://mcp.rudderstack.com/mcp，传输方式选择 Streamable HTTP，然后在浏览器提示时登录 RudderStack。

Gemini CLI

从此仓库安装扩展：

gemini extensions install https://github.com/rudderlabs/rudderstack-mcp

然后在 Gemini CLI 中运行 /mcp auth rudderstack，在浏览器中登录 RudderStack，并批准访问。扩展清单文件为 gemini-extension.json。

Pi

pi mcp add rudderstack --url https://mcp.rudderstack.com/mcp
pi mcp login rudderstack

登录时会打开浏览器，供你登录 RudderStack。

Windsurf 和其他客户端

添加自定义 MCP 服务，命令设为 npx，参数设为 -y、mcp-remote 和 https://mcp.rudderstack.com/mcp。原生支持 Streamable HTTP 的客户端可以直接使用该端点。

身份验证和权限

RudderStack 使用 OAuth 2.0 和 PKCE，并支持客户端 ID 元数据文档以及动态客户端注册。兼容的客户端会发现授权元数据，在浏览器中打开 RudderStack 登录页面，并根据该客户端的安全模型存储生成的凭据。

工具以你授权的 RudderStack 用户和工作区的权限运行。批准工具调用前请先检查，尤其是写入操作。工作区工具每次调用都需要提供 user_details 中的 workspace_id（或 workspaceId）；该端点为无状态端点。

工具访问

大多数工具用于检查工作区设置、管道、架构、指标、用户档案、受众、文档和服务状态。部分工具会更改控制平面，或触发同步，包括：

• 创建或更新受众；
• 将受众连接到目标位置；
• 创建 rETL 受众激活；
• 触发受众激活同步；
• 创建或更新转换；以及
• 将转换连接到目标位置。

转换测试、受众预览、Reverse ETL 失败记录读取和受众激活规划不会持久化控制平面配置，但可能会执行代码或提交临时数据仓库任务。请参阅 docs/tools.md，了解托管 /mcp 端点公开的所有工具、工具分类以及按条件提供的工具。

安全与支持

• 按照 SECURITY.md 中的说明，私下报告疑似漏洞。
• 如需反馈产品问题，请使用问题报告表单。
• 如需请求工具，请使用工具请求表单。
• 切勿在公开问题中发布访问令牌、工作区 ID、事件负载、客户数据或凭据。

资源

• RudderStack MCP 设置指南
• RudderStack 文档
• Model Context Protocol
• Official MCP Registry

许可证

本仓库中的文档、示例和元数据均根据 MIT License 提供。本许可证不适用于托管服务的私有实现。