CloudSprite

CloudSprite 插件

面向 CloudSprite 的公开插件。一个仓库、一个插件标识（cloudsprite），适用于 Claude Code、Grok Build 和 Agent Plugins 客户端（Cursor、GitHub Copilot、VS Code、Codex 等）。

该插件通过远程 MCP 与 CloudSprite 生产环境通信。此仓库中没有 API 密钥、GitLab 令牌、Linear 令牌或其他机密信息。OAuth 令牌保留在客户端中。

插件的 name 为 cloudsprite，一旦某个市场收录了它，就不可更改。由于 GitHub 上的 cloudsprite 已被占用，因此 GitHub 组织名为 cloudsprite-io。

将 AI 连接到 CloudSprite

各客户端的完整操作步骤：将 AI 连接到 CloudSprite。

此仓库中没有 API 密钥，聊天中也没有。请使用你在浏览器中使用的同一 CloudSprite 账号登录。

项目	值
MCP URL	https://api.cloudsprite.io/mcp
传输方式	Streamable HTTP
OAuth 发现地址	https://api.cloudsprite.io/.well-known/oauth-authorization-server
插件标识	cloudsprite（固定）

如何将 Claude Code 连接到 CloudSprite？

/plugin marketplace add cloudsprite-io/cloudsprite-plugin
/plugin install cloudsprite@cloudsprite

如果尚未启用 cloudsprite 插件，请先启用。首次使用工具时，请完成浏览器登录。

如何将 Cursor、GitHub Copilot、VS Code 或 Codex 连接到 CloudSprite？

此仓库是一个 Agent Plugins 1.0 软件包：包含根目录下的 plugin.json、mcp.json 和 skills/。

1. 克隆此仓库（或者，如果客户端接受 git URL，可将 cloudsprite-io/cloudsprite-plugin 添加为插件源）。
2. 将其作为 Agent Plugin 加载。在 Cursor 中，将本地检出放在 ~/.cursor/plugins/local/cloudsprite 下即可。
3. 启用插件，并在客户端提示时完成 OAuth 授权。

如果客户端无法加载 Agent Plugins，请改为添加远程 MCP 服务（URL 和 OAuth 设置与任何 MCP 客户端相同）。

如何将 Grok 连接到 CloudSprite？

grok plugin marketplace add cloudsprite-io/cloudsprite-plugin
grok plugin install cloudsprite --trust

在 xAI 市场中的官方收录是独立事项，并非安装所必需。维护者目录说明：DIRECTORY.md。

如何将任何 MCP 客户端连接到 CloudSprite？

设置	值
服务 URL	https://api.cloudsprite.io/mcp
传输方式	Streamable HTTP
OAuth 发现地址	https://api.cloudsprite.io/.well-known/oauth-authorization-server

客户端必须从该元数据中发现授权、令牌和 JWKS URL。不要对这些主机进行硬编码，也不要在配置中填写客户端密钥或 API 密钥。

{
  "mcpServers": {
    "cloudsprite": {
      "type": "streamable-http",
      "url": "https://api.cloudsprite.io/mcp"
    }
  }
}

有些客户端会使用 "type": "http" 或单独的 "url" 字段来配置同一远程服务。

如何将 ChatGPT 连接到 CloudSprite？

ChatGPT 连接器即将推出。目前不要将 CloudSprite 添加为 ChatGPT 自定义连接器——尚未注册相应的 OAuth 重定向地址。当前可使用 Claude Code、Cursor、Copilot、Codex、Grok 或通用 MCP 客户端。

功能

登录并设置范围后，模型可以：

• 读取组织 / 团队 / 项目上下文（whoami / get_scope、list_orgs、list_teams、list_projects、set_scope）
• 搜索数据集、跟踪记录（仅摘要）、笔记本和脚本
• 搜索 CloudSprite 产品文档和 SDK 目录（search_knowledge、search_sdk）
• 提交错误报告或功能请求（/feedback → MCP submit_feedback）

此版本为只读，但支持反馈。它不会修改数据集、标签、笔记本或脚本。

MCP URL

生产环境（客户唯一使用的 URL）：

https://api.cloudsprite.io/mcp

传输方式：MCP Streamable HTTP。插件中不会存储 Authorization 标头。客户端会从 MCP 源站发现 OAuth，并持有令牌。插件 UI 中没有环境选择器。

OAuth 尚未启用时，/mcp 返回 401 属于预期情况。插件应显示明确的身份验证错误，而不是一直等待。

如果客户端进程设置了 CLOUDSPRITE_MCP_URL，Claude Code 会遵循该变量（.mcp.json 中的 ${CLOUDSPRITE_MCP_URL:-https://api.cloudsprite.io/mcp}）。GUI 应用会读取 ~/.claude/settings.json 中的 "env"，而不是你的 shell 配置文件。可移植的 mcp.json 使用生产环境 URL 字面值（不做插值）。不要在此处提交 .env。

技能

| 技能 | 斜杠命令 | 用途 | |-|-| | feedback | /feedback | 确认文本，然后调用 MCP submit_feedback | | platform-howtos | /platform-howtos | 在助手中登录、选择范围以及使用 CloudSprite | | datasets | /datasets | 查找数据集、参数、标签和笔记本（读取） | | mixed-mode-analysis | /mixed-mode-analysis | 根据 2 端口对计算差模／共模 S 参数 | | waveform-correlation | /waveform-correlation | 对重复轨迹进行两两 Pearson 质量检查 |

网络端点

插件包本身不会打开套接字。加载该插件的客户端会访问：

URL	用途
https://api.cloudsprite.io/mcp	MCP Streamable HTTP（工具）
https://api.cloudsprite.io/.well-known/oauth-authorization-server	OAuth 2.1 授权服务器元数据
https://api.cloudsprite.io/.well-known/oauth-protected-resource	OAuth 受保护资源元数据（若已公布）
该元数据中的授权、令牌、撤销和 JWKS URL	Cognito Hosted UI PKCE。此处不会将主机硬编码；它们来自发现流程。

安装插件时，也会克隆此 GitHub 仓库（https://github.com/cloudsprite-io/cloudsprite-plugin）。带标签的发行版采用与 plugin.json 中 version 相匹配的 vMAJOR.MINOR.PATCH 格式。

插件不会调用 GitLab、Linear、HubSpot 或任何问题跟踪器。反馈由 CloudSprite API 在调用 submit_feedback 后提交。

如果设置了 CLOUDSPRITE_MCP_URL，发现流程和令牌端点会使用该主机，而不是 api.cloudsprite.io。

支持

• 产品：https://cloudsprite.io
• 文档：https://docs.cloudsprite.io
• 电子邮件：[email protected]
• 隐私：[email protected]

发行版

Git 标签为 v 加上 plugin.json 中的 version（当前为 0.1.3）。维护者会在 scripts/audit.sh 通过后，使用 scripts/publish.sh 发布。如果 HEAD 仍然匹配，重新发布相同标签不会产生任何操作；同一版本对应不同的代码树时则会失败。

许可证

MIT。版权所有 © 2026 Brushfield Ventures LLC，商号为 CloudSprite。

CloudSprite 的产品使用仍受 CloudSprite 服务条款和隐私政策约束。