@cloudgrid-io/ mcp (英语)
CloudGrid的MCP服务器. 它暴露出"CloudGrid"行动作为MCP工具.
它从一个密码基地分出两版
- 当地( stdio) 运行在您的机器上, 完整的工具箱, 包括 CLI 包装 工具。 这个读取器覆盖它。 Claude Code, Cursor, Claude Desktop (英语).
- 网络(托管的 HTTP) - 更轻的工具箱(17个直接API工具,无CLI) claude.ai等网络客户端的包装. 见 升级.md。 。 。 .
本地版本将 grid 用于认证操作的 CLI( CLI)
处理认证、网格上下文和错误格式),并直接调用 API
插件、登录和能见度工具.
CLI 兼容性
MCP仅在满足平台层时使用已安装的 CLI
(单位:千美元)MIN_CLI_VERSION,目前为0.15.26 — 与API的现场直播紧紧相接
cli_compat 地板,它拒绝使用HTTP 426的更古老的CLI)。 地板下面
跳过本地/ 全球 CLI 并懒取 @cloudgrid-io/cli@latest 通过
npx转而使用. A CI 漂流后卫(npm run test:drift-guard(a) 声称
包裹动词存在于 CLI 帮助中.
GRID_AUTH_STALE 超出范围
严格的OIDC( org- ownersed) 网格可以返回 GRID_AUTH_STALE 当召人的时候
会话在SSO政策变化之前。 MCP没有针对此类网格和
不处理此代码: 如果 GRID_AUTH_STALE 反应被看到,点
在 Console SSO 重新认证的用户 —— MCP 将不会默默地重试 .
先决条件
安装并登录到 CLI :
npm install -g @cloudgrid-io/cli
grid login
服务器没有直接读取证书 。 它运行 grid,使用自己的
证书存储于 ~/.cloudgrid/credentials。 。 。 .
运行
npx -y @cloudgrid-io/mcp
或者来自克隆人:
cd mcp
npm install
npm start
它说MCP比Studio强. 指向任何 MCP 客户端 cloudgrid-mcp 命令.
每个客户端有一个 CloudGrid 服务器
运行此本地( stdio) 服务器—— 独立或通过 Claude 代码
插件, 将它捆绑在一起 —— 或主机连接器 (mcp.cloudgrid.io(a) 内
给定客户端。 从来没有两者:每个 grid_*
工具出现两次,两个服务器分别持有登录状态(本地
版本共享 CLI 的 ~/.cloudgrid/credentials;连接符持有
他们可以不同意你是否在
然后,模型可以对最后回答的哪一个采取行动。 如何辨别: 重复
grid_* 客户端工具列表中的条目, 或客户端中的两个 CloudGrid 服务器
MCP/连接器设置. 要保存的 : 本地版, 无论您在哪里建立
文件夹中的运行时应用程序( 它有) path + CLI; 在
仅限聊天的客户端,用于发布单页.
QA 会话日志( 可选)
设定 CLOUDGRID_QA_SLACK_WEBHOOK 改为: 内部/私人 黑进网
URL 接收每个会话的 QA 日志(log-<Client>-<transport>-mcp.txt当a
本地( stdio) 会话启动、 失败或废弃 。 木头带着
用户的第一个消息(当主机转发它时)和身份细节,所以
目标频道必须是内部的。 主机版从不发布会话日志
完全可以(它的服务器不带网络hook); 主机 grid_note 已归档
CloudGrid API取而代之——见下文"隐私政策". 取消 —— 特性是完全黑暗的(没有捕获,没有)
(已公布). CLOUDGRID_QA_IDLE_MS 覆盖已放弃的窗口( 默认)
900 000 = 15分钟.
工具
登记了38个工具(两个版本共有15个工具,仅23个本地工具)。 无有堕取别名. MIN CLI VERSION:0.15.26 (英语).
直接API工具(两版)
| 工具 | 环绕 | 内容提要 |
|---|---|---|
grid_pickup | API 密码 | 捡起一个应用程序: 让你的 OWN COPY 从任何你能看到的应用程序中(像一分叉) 进入一个你可以构建的网格. |
grid_pull | API 密码 | 在 PLACE 中继续/编辑一个应用程序 git clone 中, 包含 :. |
grid_collab | API 密码 | 让PUSH Accesss进入别人拥有的同一实体——你成为该实体上的合作者,不... |
grid_create_grid | API 密码 | 为登录用户创建一个新的网格(工作空间)——它们成为其管理员. |
grid_note | API 密码 | 留下一个段落摘要,说明您创建了这个会话,以及为什么,对于本地版的可选QA会话日志... |
grid_plug | API 密码 | 将一个应用程序,网站,游戏,或HTML页面插入到CloudGrid在公共现场URL中. |
grid_get_app_source | API 密码 | 获取 CurRENT 已部署的 HTML 作为文本的灵感/放入线程, 这样您就可以编辑它并重新插入 SAME URL... |
grid_visibility | API 密码 | 改变谁可以看到 CloudGrid 灵感 OR 运行时的应用/代理 . |
grid_check_deploy | API 密码 | 请检查aync runtime-app构建(一个部署,这里指插件)是否完成,该应用是否为活化. |
grid_list_grids | API 密码 | 列出登录用户的网格,每个网格都包含有swit,名称,角色,以及提供状态. |
grid_start | API 密码 | 与 CloudGrid 一起构建的简短方向: 本次会话的帐号被签为及其活动网格, 如何... |
grid_get_template | 实体 | 装入特定的 CloudGrid 工作流程,模板,示例,规则,排除出故障的注释,或按名称引用 doc——readermi... |
grid_report | API 密码 | 向CloudGrid团队报告真正的CloudGrid失败——只有用户明确同意. |
grid_hello | API 密码 | 创建最低限度的问候页面并插入用户的网格,还原活的URL. |
grid_delete | grid delete entity | 存档 CloudGrid 灵感 . |
直接的API工具将平台称为没有CLI的平台,所以它们也在工作
网页版. grid_login 写同样 ~/.cloudgrid/credentials 页:1
CLI使用,所以两者共享一个身份.
CLI 包装工具(仅当地版)
| 工具 | 环绕 | 内容提要 |
|---|---|---|
grid_login | API 密码 | 启动无CLI"CloudGrid"登录. |
grid_login_status | API 密码 | 完成网格 login启动的登录 . |
grid_create_project | grid new | 脚手架新的 CloudGrid app或代理文件夹(cloudgrid.yaml + a web service),可选的预声明资源. |
grid_view_logs | grid logs | 一个实体的尾端日志 . |
grid_share | grid visibility set | 设置一个实体的能见度并打印其URL. |
grid_feedback | grid feedback list | 列出当前网格的最近反馈事件 . |
grid_whoami | grid whoami | 显示已签名的用户和活动的网格 . |
grid_switch_grid | grid use | 切换活动网格. |
grid_logout | grid logout | 签署并清除当地证书. |
grid_status | grid status | 网格仪表板 实体细节 或部署快照. |
grid_info | grid info | 显示 CloudGrid 实体的元数据 . |
grid_get | `网格得到 <网格' | 实体 |
grid_describe_grid | grid describe grid <slug> --json | 显示一个网格的细节:角色,成员,空格,分级,通配符-TLS状态. |
grid_edit_existing_app | grid pull | 继续/编辑本地的 EXISTING 实体: 下载其源代码 + yungrid. yaml 并链接文件夹, 所以您的下个 `grid... |
grid_rename | grid rename | 重命名 CloudGrid 实体的显示名( slug 不变) . |
grid_take_offline | grid unplug | 取一实体出网. |
grid_rollback_deploy | grid rollback | 回滚一个实体到上一个版本. |
grid_list_versions | grid versions | 为一个实体列出已出版的版本. |
grid_set_env | grid env | 管理一个实体的环境变量. |
grid_set_secret | grid secrets | 设置或列出实体的秘密名称. |
grid_scaffold | grid scaffold | Scaffold 服务文件夹在 yaml (idempotent) 中宣告. |
grid_diagnose | grid doctor | 运行 CloudGrid 本地环境诊断. |
grid_get_url | grid open --print | 为实体返回公共 URL . |
grid_share 财务报告和审定财务报表 grid_visibility 目的重叠 : grid_share
将 CLI 和默认值包成 link· ; grid_visibility 是直接API, 使用一个
明确范围,并默认其目标为会议最后的下降——这是其中之一
网络版得到.
所有工具都带有MCP说明(readOnlyHint, (中文(简体) ), destructiveHint, (中文(简体) ),
openWorldHint对支持他们的客户.
测试
烟雾测试让服务器有一个真正的 MCP 客户端, 列出工具,并呼叫
仅读 grid_feedback 工具结束到结束 :
cd mcp
npm install
npm run smoke
它需要一个登录的CLI $PATH。 。 。 .
现场烟雾剧本
又有3个剧本在索要时与活API相对抗. 他们不是中情局的成员. 新的插头需要签入,所以它们都没有产生匿名投放. 每一个 跳过一个步骤,并说为什么,当该步骤需要的变量缺失时. 托肯斯只来自环境,从未被印出.
| 脚本 | 没有秘密 | 带着秘密 |
|---|---|---|
npm run smoke:drop | 使用 anon: true 返回时 needs_auth 并发表什么. | CLOUDGRID_TOKEN (和 CLOUDGRID_SMOKE_GRID 如果账户有多个网格:一个已签名的创建者会发布一个自有的页面及其URL服务. |
npm run smoke:redrop | 同样的签出检查,通过网页版. | CLOUDGRID_SMOKE_REDROP_ENTITY_ID + 键 CLOUDGRID_SMOKE_REDROP_OWNER_TOKEN (或 CLOUDGRID_SMOKE_REDROP_OWNER_TOKEN_FILE) 对于已存在的匿名投放:编辑更新到位,没有签入. 每次编辑时都会重新考虑所有者代币;用新鲜的代币文件会重写. |
npm run smoke:claim | 跳过. | CLOUDGRID_TOKEN:一个签入的插头. 添加 CLOUDGRID_SMOKE_CLAIM_ENTITY_ID + 键 CLOUDGRID_SMOKE_CLAIM_TOKEN 用于当前匿名投放 : grid_pull 把它记入账户 一滴可以申请一次. |
任何发布请求在服务器内拒绝签名退出检查 所以随时可以安全运行.
设计
- 贝壳出来
execFile和各种争论,故无壳和无壳 注射表面. grid_view_logs从不使用--follow连线电话都回不来了.- 无国籍者。 每一次通话都是引用CLI的.
隐私政策
完全政策: https://cloudgrid.io/privacy (英语)
MCP 服务器对您的数据所做的
鉴定. grid_login 打开基于浏览器的 Google 登录流
CloudGrid的API (英语:/auth/login) (中文(简体) ). 返回的JWT存储于
~/.cloudgrid/credentials 与 0600 权限—— CLI 和 MCP 共享
设计一个证书文件( a)auth.js:7-8) (中文(简体) ). 网页版没有登录
工具: AI 工具与 OAuth 的连接符符号, 此服务器会自行发行
短暂的进入标志, 与 CloudGrid 会话封在里面, 所以
语句从未交给 AI 工具.
部署. grid_plug 上传您的应用文件( HTML, 源代码, 资产) 到
https://api.cloudgrid.io/api/v2/plug。上传前,内入源是
扫描已知的 API- key 模式( OpenRouter, Anthropic, OpenAI, Google,
GitHub, AWS, Slack, Strape; 一个匹配挡住部署. 这不是保证
——一个坚定的模型可以混淆扫描过后的一个密钥——但它阻止了
诚意的"嵌入它所以它的工作"路径。 认证信头(Bearer JWT,网格流)是
附以识别打电话者.
报告错误 . grid_report 发送错误报告到
https://api.cloudgrid.io/api/v2/errors。工具描述指示
模式仅在用户明确同意的情况下使用,并设置
CLOUDGRID_TELEMETRY=off 无条件禁用它,但不存在
在报告处理者本身进行方案同意检查。 有效载荷包括:
错误摘要、 诊断元数据( 平台、 节点版本、 传输), 一面旗帜
记录用户是否同意分享对话(deploy.js:544, (中文(简体) ),
(单位:千美元) context 模型供应——按其申报形状
(单位:千美元)register.js:964-975)可以携带失败的输入(例如 HTML 或
args)和原始请求. 笔录本身不是由这个工具发送的.
报告擦洗是 双层价值和 message 字段扫描
用于已知的秘密形状( API 密钥前缀, 如 sk-ant-, (中文(简体) ), sk-proj-, (中文(简体) ),
AKIA…; JWTs; PEM 私有密钥块; 熊熊符; 基本- 自动 URL
证书)和相匹配物替换为 [REDACTED]任意或
未知形状的秘密, 与已知模式不符
无所修行. 客户端的刷新( U)scrubReportContext + 键 scrubSecretValues
在 POST 中运行; 服务器端点应用服务器侧
顶上键名过滤器。 瞒秨厨秈ㄓ
页:1 message 或者说 context 您发送或设置 CLOUDGRID_TELEMETRY=off 改为
完全禁用报告 .
版本检查. 启动时, 本地版会请求
https://registry.npmjs.org/@cloudgrid-io/mcp/latest 以检测 stale .mcpb
安装,从不自动更新。 它不发送账户数据和用户内容.
主机版不这样做.
QA会话日志. 何时 CLOUDGRID_QA_SLACK_WEBHOOK 设置(默认取消,
否则,本地(stdio)服务器会将每个会话的QA日志发布到一个
内部Slack频道关于部署,出错,闲置超时,或处理关闭. 这个
日志包括:会话元数据(用户名、电子邮件、网格流、客户名)
用户的第一个消息( 被擦去, 上限为 2 000 个字符), 每个工具调用线索
仅使用允许列表的参数键,并通过 grid_note 或者说
grid_plug是因为 session_note (封顶为4000个字符). 第一个信息是
抓获的 CLOUDGRID_USER_REQUEST 环境变量(由
Claude代码)或 grid_plug是因为 user_request 参数(仅本地版).
主机版没有自己寄出去页:1 grid_plug 没有
user_request 或者说 session_note,则没有插件、闲置或
关闭。 一个主机是 grid_note,用户要求的:
给 CloudGrid API 的注释/api/v2/feedback在用户自己的登录下,
有网格流和客户名——没有电子邮件地址,没有工具调用线索,
谈话没别的了,签了就回来了 needs_auth 财务报告和审定财务报表
发送什么. grid_report (两版) 向
CloudGrid API 仅在用户同意后:消息和上下文模式
传出加客户名和平台, 谈话时才进行
明确同意这一点。 文本值
(第一个消息、叙述、工具参数和错误消息)通过
通过一个洗涤器,将 JWTs, PEM 键, 熊鼠标志, 和已知的
提供 API- key 格式。 身份字段( E)_keyResult 值和页眉
block)和结构化结果数据绕过文本洗涤器.
此服务器没有收集其他数据 . 服务器不跟踪使用情况
分析或传输超出上述流量和经认证的数据
CloudGrid API 调用单个工具制作(例如. /grids, (中文(简体) ),
/pickup, (中文(简体) ), /deploys, (中文(简体) ), /inspirations/{id}/source. CLI 包装工具外壳
到云纹去 grid CLI, 共同拥有
~/.cloudgrid/credentials 文件,不通过
此服务器 。 他们更喜欢把CLI捆在 .mcpb 或兼容 grid
已经在你身上 PATH;如果两者均不在场或不够新,它们就会回到
npx -y @cloudgrid-io/cli@latest (单位:千美元)cli.js:411-424页:1 下载和运行
npm 登记册中的CLI (单位:千美元)registry.npmjs.org——软件
安装,以及能够到达 npm 的第二流(启动版本检查)
以上为第一个)。 平台层面的数据处理由链接覆盖
隐私政策.