关于 ThoughtSpot MCP Server
ThoughtSpot MCP Server 将 ThoughtSpot Spotter 接入 MCP 客户端,为其提供查询和检索 ThoughtSpot 实例数据的工具。它处理身份验证,并返回来自实例数据的实时答案。
主要功能
- 01查询和检索 ThoughtSpot 数据
- 02连接 ThoughtSpot 实例并处理身份验证
- 03支持手动注册 OAuth 客户端
- 04可为主机限制允许访问的实例
适用场景
- 01在 MCP 客户端中查询 ThoughtSpot 数据
- 02检索实例中的相关数据
- 03为不支持动态注册的客户端配置 OAuth
- 04按主机限制可授权的实例
MCP 相关
该 MCP 服务向客户端提供查询和检索 ThoughtSpot 数据的工具。支持在客户端中配置 OAuth 客户端信息。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://agent.thoughtspot.app/mcpclaude mcp add --transport http thoughtspot https://agent.thoughtspot.app/mcp{"mcpServers":{"thoughtspot":{"type":"http","url":"https://agent.thoughtspot.app/mcp"}}}在 Cursor 中打开{"servers":{"thoughtspot":{"type":"http","url":"https://agent.thoughtspot.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"thoughtspot":{"type":"http","url":"https://agent.thoughtspot.app/mcp"}}}{"mcpServers":{"thoughtspot":{"serverUrl":"https://agent.thoughtspot.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://agent.thoughtspot.app/mcphttps://agent.thoughtspot.app/ssehttps://agent.thoughtspot.app/bearer/mcp需要授权https://agent.thoughtspot.app/bearer/sse需要授权工具
详细介绍
ThoughtSpot MCP Server
ThoughtSpot Spotter MCP 服务提供一组工具,用于从您的 ThoughtSpot 实例查询和检索相关数据。Spotter 连接到您的 ThoughtSpot 实例,安全地处理身份验证,并返回来自您自有数据的实时答案。
目录
手动注册客户端
对于尚不支持动态客户端注册,或要求静态添加 OAuth 客户端 ID 等信息的 MCP 主机,请访问此页面注册新客户端并复制相关信息。最重要的值是 Oauth Client Id 和 Oauth Client Secret,添加 ThoughtSpot 作为 MCP 客户端(ChatGPT/Claude 等)中的 MCP 连接器时,应填写这两个值。生成的客户端信息仅在生成时可用,之后将无法查阅。
关联 ThoughtSpot 实例
手动注册客户端还可以关联特定的 ThoughtSpot 实例,这样用户在授权流程中就不必输入 ThoughtSpot 实例 URL。注册 OAuth 客户端时,请在相应字段中填写 ThoughtSpot URL。
按域名限制实例
当 Worker 为多个自定义域名提供服务时,可以使用 INSTANCE_ALLOWLIST_BY_HOST 环境变量,限制每个域名可接受的 ThoughtSpot 实例。其值为一个 JSON 对象,将主机名映射到允许的实例 URL:
{"mcp.example.com": ["https://instance-a.thoughtspot.cloud", "https://instance-b.thoughtspot.cloud"]}
对于列入清单的主机名:
- 授权页面会显示允许的实例下拉菜单,而不是自由文本字段。
POST /authorize会拒绝任何其他实例,并返回 400。- 对于任何其他实例的 MCP 请求(
/mcp、/sse、/token/*、/bearer/*),都会返回 403。
未列入清单的主机名行为与之前相同。如果值不是有效的 JSON,服务器会返回 500 并拒绝请求,而不会解除限制。
参与贡献
本地开发
- 安装依赖项:
npm install - 设置环境变量:
- 复制
.dev.vars,并填写您的 ThoughtSpot 实例 URL 和访问令牌。
- 复制
- 启动开发服务器:
npm run dev
添加新工具
向服务器添加新的 MCP 工具时:
- 在
src/servers/tool-definitions.ts中定义架构和工具 - 在
src/servers/mcp-server.ts中实现处理程序 - 在
src/servers/version-registry.ts中更新版本注册表:- 将新工具添加到
VERSION_REGISTRY中相应的版本 - 对于新的稳定功能,更新
DEFAULT_VERSION - 对于 beta 功能,将其添加到
beta版本条目中
- 将新工具添加到
- 为新工具和版本配置添加测试
- 更新 README.md 中的文档
重要: 版本注册表决定了各个 API 版本中可用的工具。请确保将新工具添加到正确的版本配置中,以便用户能够使用它们。
MCP Server,© ThoughtSpot, Inc. 2026
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。