PocketBase Cloud

PocketBase Cloud MCP 服务

PocketBase Cloud 官方模型上下文协议（MCP）服务：一个托管桥接服务，让你的 AI 助手可以在 PocketBase Cloud 账户中操作项目、PocketBase 实例、前端和后端、部署和日志、自定义域名，以及每个实例中的集合和记录。

连接页面 · 工具 · 数据与安全 · PocketBase Cloud

---

PocketBase Cloud 托管 PocketBase 后端、前端和服务器应用。连接一次账户，然后用日常语言向你的 助手提出请求；它会选择并执行合适的操作。

使用 PocketBase Cloud MCP 服务，你的助手可以：

• 查看正在运行的内容： 项目、PocketBase 实例、前端和后端及其状态、最近的 部署，以及实例和后端的日志。
• 查明故障原因： 查看失败部署的构建日志并说明如何修复。
• 启动应用： 在你选择的区域创建项目和 PocketBase 实例。
• 发布： 添加并验证自定义域名、部署钩子和静态站点，并获取用于部署 源代码的准确 pbc 命令。
• 处理数据： 设计集合和 API 规则，并读取、创建、更新和删除记录。
• 加固实例： 检查 API 规则中的安全隐患、查找缓慢的请求，并在进行高风险 更改前备份。

重要

连接时由你选择访问权限： 读写或只读，以及所有项目或单个项目。 服务 URL 中的选项可以缩小连接范围，但不能扩大范围。删除操作需要你明确批准 具体变更。

一键设置

选择下方的 AI 客户端。每个按钮都使用客户端原生的安装链接，因此无需手动编辑任何 JSON 配置。

添加到 Cursor 在编辑器中基于 PocketBase 构建。

添加到 VS Code 通过 GitHub Copilot 使用。

添加到 Claude 将其添加为自定义连接器。

添加到 ChatGPT 将其添加为自定义 MCP 服务。

其他客户端使用的服务 URL：

https://mcp.pocketbasecloud.com/mcp

请原样粘贴：地址以 /mcp 结尾。

让你的 Agent 完成设置

大多数 AI 编码 Agent 都可以自行添加服务并开始登录。将以下内容粘贴到你的 Agent 中：

Add the PocketBase Cloud MCP server https://mcp.pocketbasecloud.com/mcp to this agent
(remote, Streamable HTTP, OAuth), following https://mcp.pocketbasecloud.com/.
Then start the authentication flow so I can sign in to PocketBase Cloud.

Claude 和 ChatGPT

Claude（claude.ai 和 Claude Desktop），使用插件。 付费套餐还可通过插件使用技能：

1. 选择 自定义 → 插件，然后选择 添加 → 添加市场，并输入 pocketbasecloud/mcp。
2. 安装 PocketBase Cloud。
3. 打开插件的 连接器 标签页，连接 pocketbasecloud：登录 PocketBase Cloud，然后选择访问权限和项目。仅安装插件并不会连接它。

添加到 Claude 账户的插件也会在你使用同一账户登录 Claude Code 时供其使用。

Claude（claude.ai 和 Claude Desktop），仅添加服务

1. 选择 自定义 → 连接器，然后选择 + 添加 → 添加自定义连接器。
2. 为其命名（例如 PocketBase Cloud），粘贴服务 URL 并继续。如果系统询问 Claude 如何标识自己，请选择 自动注册。点击 添加。
3. 点击 连接，登录 PocketBase Cloud，然后选择访问权限和项目。

对于 Team 或 Enterprise 套餐，组织所有者只需在 组织设置 → 连接器 → 添加 → 自定义 → Web 下添加一次；之后每位成员点击 连接 即可。

ChatGPT

1. 选择 插件 → + → 添加自定义 MCP 服务。
2. 为其命名，在 连接 下输入服务 URL，选择 OAuth 身份验证，接受有关自定义服务的警告，然后选择 创建为插件。
3. 安装插件，在 ChatGPT 提示时登录 PocketBase Cloud，然后在聊天中输入 @ 来使用它。

其他客户端

客户端	命令或配置
Claude Code	claude mcp add --transport http pocketbasecloud https://mcp.pocketbasecloud.com/mcp，然后在会话中运行 /mcp 以登录
Claude Code（插件，含技能）	/plugin marketplace add pocketbasecloud/mcp，然后运行 /plugin install pocketbase-cloud@pocketbase-cloud
Cline	MCP Servers → Remote Servers → Edit Configuration，然后在 mcpServers 下添加 "pocketbasecloud": { "type": "streamableHttp", "url": "https://mcp.pocketbasecloud.com/mcp" }。Cline 打开浏览器后登录。参见 llms-install.md
Codex	codex mcp add pocketbasecloud --url https://mcp.pocketbasecloud.com/mcp，然后运行 codex mcp login pocketbasecloud
Cursor	使用上方的 Add to Cursor 按钮，或在 .cursor/mcp.json 的 mcpServers 下添加 "pocketbasecloud": { "url": "https://mcp.pocketbasecloud.com/mcp" }
Cursor（插件，含技能）	在 Cursor Marketplace 上架后，安装其中的 PocketBase Cloud。上架之前，将此仓库复制（请复制，不要使用符号链接）到 ~/.cursor/plugins/local/pocketbase-cloud，然后重新加载 Cursor。只保留一个 PocketBase Cloud 服务：如果已添加，请移除 .cursor/mcp.json 中的配置
VS Code / GitHub Copilot	使用上方的 Add to VS Code 按钮，或在 .vscode/mcp.json 的 servers 下添加 "pocketbasecloud": { "type": "http", "url": "https://mcp.pocketbasecloud.com/mcp" }
Devin Desktop（原名 Windsurf）	在 Cascade 面板中选择 … → Open MCP config file，然后在 mcpServers 下添加 "pocketbasecloud": { "url": "https://mcp.pocketbasecloud.com/mcp" }。对于 Devin Agent：运行 devin mcp add pocketbasecloud https://mcp.pocketbasecloud.com/mcp，然后运行 devin mcp login pocketbasecloud
Gemini CLI	gemini extensions install https://github.com/pocketbasecloud/mcp，然后运行 /mcp auth pocketbasecloud
其他任何 MCP 客户端	服务 URL，使用 Streamable HTTP 传输方式和 OAuth

**脚本和 CI：**无需登录，只需将 PocketBase Cloud CLI 访问令牌（portal → Account → CLI access token）作为 Authorization: Bearer <token> 发送。参见工作原理。

目录

• 一键设置
• 插件打包与兼容性
• 工具
• 选项
• 开始之前
• 数据与安全
• 工作原理
• 提示词示例
• 技能
• 故障排除
• 安全
• 支持与反馈
• 免责声明

---

插件打包与兼容性

此仓库以多种软件包格式发布相同的 MCP 服务和技能，让每个客户端都能使用其原生的发现和安装流程：

格式	清单和配置	共享组件
Agent Plugins v1	plugin.json 和 mcp.json	skills/
Claude 插件（Claude Code、claude.ai、Claude Desktop）	.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json	.mcp.json 和 skills/
Cursor 插件	.cursor-plugin/plugin.json	.mcp.json 和 skills/
Gemini CLI 扩展	gemini-extension.json	嵌入清单中的 MCP 服务配置，以及 Gemini CLI 从扩展中加载的 skills/
MCP Registry	server.json	远程服务元数据

mcp.json 和 .mcp.json 都是有意保留的：Agent Plugins 要求使用根目录下的 mcp.json 及其可移植的传输术语（streamable-http），而 Claude 和 Cursor 使用 .mcp.json 及其术语（http）。Gemini CLI 将 Streamable HTTP 端点命名为 httpUrl。请确保它们的端点相同；npm run validate 会检查这一点。

工具

此服务将工具分组。标记为 可选启用 的分组通过 features 选项添加。包含所有工具的实时列表请见连接页面。

分组	默认启用	涵盖内容
account	✅	账户概览、套餐和 Free 试用、项目、区域；创建项目。
resources	✅	PocketBase 实例、前端和后端：列出、检查、创建实例、运行时设置、持续备份。
deploy	✅	部署及其构建日志、运行时日志、一键诊断、钩子、静态网站，以及用于部署源代码的 pbc 命令。
domains	✅	添加、验证、检查和移除自定义域名。
docs	✅	为 Agent 搜索 PocketBase 和 PocketBase Cloud 指南。
database	✅	在实例内管理：集合、API 规则、记录、请求日志、备份、定时任务、安全和性能检查、TypeScript 类型。
env	可选启用	资源的环境变量（前端的构建时变量）；不会读取变量值。
database_admin	可选启用	批量删除和恢复：清空或删除集合、移除字段、恢复或删除备份。

有意不提供的功能：删除项目或资源（请使用门户或 pbc），以及在服务端构建源代码（构建在你的机器上运行；服务会提供 pbc 命令）。

选项

将这些选项添加到服务 URL 的查询字符串中。它们可以缩小你登录时批准的范围，但不会扩大范围。

选项	默认值	效果
read_only	false	仅提供读取工具。
project_ref	无	将所有工具限制在一个项目内。
features	account,resources,deploy,domains,database,docs	工具分组。添加 env 可启用环境变量；添加 database_admin 可启用批量删除和恢复。

例如：https://mcp.pocketbasecloud.com/mcp?read_only=true&project_ref=<project id>。

开始之前

先决条件

• 一个 PocketBase Cloud 账户。连接时，你需要在 PocketBase Cloud 门户登录。
• 你可以创建和部署的内容取决于你的 套餐；新账户会获得 Free 试用。
• 部署 源代码 还需要在你的机器上安装 PocketBase Cloud CLI pbc；服务会告知你要运行的确切命令。
• 一个支持远程服务（Streamable HTTP）和 OAuth 的 MCP 客户端。对于 Claude，添加自定义连接器需要使用支持此功能的套餐。

数据与安全

• 您的 PocketBase Cloud 会话保留在服务器上。 登录后，服务器会保存您授权的连接，其中的 PocketBase Cloud 会话经过加密。您的助手会获得自己的令牌，有效期为一小时，并会自动续期；它永远无法看到您的 PocketBase Cloud 凭据。
• 闲置时连接会终止。 在您的助手中移除该应用即可断开连接；连接闲置 30 天后会被删除。
• 不复制您的数据。 服务器不会存储您实例中的记录、文件或日志；它会将这些内容传递给您的助手，然后立即忘掉。
• 尽量减少遥测数据。 为保证可靠性，服务器会使用假名 ID 记录每次工具调用（工具、目标、结果、简短错误信息和耗时），并在 90 天后删除这些记录。服务器绝不会记录您的提问内容。
• 变更设有防护措施。 删除或恢复工具需要明确确认（confirm: true）；删除集合也需要再次输入集合名称；批量删除和恢复操作会先备份实例，并返回备份名称。恢复备份会还原记录，但不会还原已删除的集合或字段：实例重启时会重放该变更，因此请改为将备份恢复到新实例。系统会拒绝更改现有字段的类型。
• 绝不保留实例凭据。 数据库工具通过 PocketBase Cloud 访问实例，且仅允许这些工具执行调用：不能访问实例设置、下载备份，也不能写入 _superusers 等系统集合。
• 不可信内容会被隔离。 返回的记录和日志会放在 <untrusted-data-…> 标签内，让模型将其视为数据，而非指令。

请参阅隐私政策和条款。

工作原理

Your AI client ──Streamable HTTP──▶ mcp.pocketbasecloud.com/mcp ──▶ PocketBase Cloud API
                                                                 └─▶ your PocketBase instances (through PocketBase Cloud)

登录（OAuth 2.1）

服务器支持 OAuth 2.1 和动态客户端注册。客户端连接时，会打开 PocketBase Cloud 门户，您可以像往常一样登录，并选择访问权限（读写或只读）和项目范围（全部项目或单个项目）。每次令牌续期都会续展连接，因此只要您在使用，连接就会保持有效。

CLI 令牌（脚本和 CI）

如需自动化，可直接发送 PocketBase Cloud CLI 访问令牌：

claude mcp add --transport http pocketbasecloud \
  "https://mcp.pocketbasecloud.com/mcp?project_ref=<project id>&read_only=true" \
  --header "Authorization: Bearer <token>"

这会将您的令牌原样转发给 PocketBase Cloud（令牌透传）；交互式客户端应使用 OAuth。

示例提示词

• “我现在的 PocketBase Cloud 账户中运行着什么？”
• “我的前端上一次部署为什么失败了？”
• “在我的 Demo shop 项目中创建一个名为 shop-db 的新 PocketBase 实例。”
• “将域名 api.example.com 添加到我的后端，并告诉我需要创建哪条 DNS 记录。”
• “给我部署此文件夹作为新后端的命令。”
• “检查 shop-db 的 API 规则，找出安全问题。”
• “shop-db 中有多少订单已付款、待处理和已退款？然后显示最新的五笔订单。”
• “在 shop-db 中设置用户账户，让每位用户只能看到自己的订单。”

技能

skills/ 存放本仓库中的每个插件都会安装的工作流：

技能	用途
getting-started	创建第一个项目和 PocketBase 实例。
debug-deploy	排查部署失败的原因，并获取再次部署的命令。
review-security	检查过于宽松的 API 规则，并在获得你批准后修复。
setup-user-accounts	设置用户、每位用户各自的集合和安全规则。
design-collections	设计应用的集合、关系、索引和规则。
change-schema	修改已有数据的字段，同时避免丢失记录。
investigate-errors	排查应用出错或列表为空的原因，并修复问题。
launch-checklist	上线前进行只读检查并评分。
write-hooks	编写 pb_hooks 中的服务端代码；先阅读，再经批准后部署。
ship-app	将 pb_public 中的网站或前端整体上线。
import-data	检查 CSV 或 JSON 中的行，并在获得批准后导入。

若使用普通 MCP 设置（没有插件），请将技能文件夹复制到客户端的技能目录，或让助手阅读 SKILL.md。

故障排查

问题	处理方法
“连接时出现问题”	检查 URL 是否以 /mcp 结尾：https://mcp.pocketbasecloud.com/mcp。
没有显示工具	完成 PocketBase Cloud 登录，并为聊天启用连接器。如有需要，请移除后重新添加。
只显示读取工具	连接为只读，可能是由登录时的选择或 read_only=true 导致。请重新连接并选择读写。
只显示一个项目	连接仅限于一个项目。请重新连接并选择所有项目，或移除 project_ref。
缺少数据库工具	数据库工具由 database 组提供，该组默认启用；请检查 URL 中的 features 是否仍包含它。
再次要求登录	连接在闲置 30 天后会失效；请重新登录。
Cursor 登录因“Invalid redirect URI”而失败	请更新 Cursor。当前版本通过 http://localhost 登录；旧版本使用 cursor:// 回调，服务器不接受这种回调。
Claude 询问如何标识自身	选择 自动注册。

安全

发现安全问题？请不要公开提交问题；请参阅 SECURITY.md。

支持与反馈

• 错误和想法：提交问题。
• 账户、账单和平台问题：PocketBase Cloud。
• **参与贡献：**请参阅 CONTRIBUTING.md。

免责声明

PocketBase Cloud 独立于 PocketBase 开源项目。该服务托管于 mcp.pocketbasecloud.com；本仓库包含其文档、客户端清单、MCP Registry 条目和技能，不包含服务端代码。随着服务不断演进，工具名称和行为可能会发生变化；实时列表请见连接页面。