PocketBase Cloud

PocketBase Cloud MCP サーバー

PocketBase Cloud 公式の Model Context Protocol（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 です。

エージェントにセットアップを任せる

ほとんどの AI コーディングエージェントは、サーバーの追加やサインインを自分で行えます。次の内容をエージェントに貼り付けてください。

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. Customize → Plugins を開き、Add → Add marketplace を選択して、pocketbasecloud/mcp を入力します。
2. PocketBase Cloud をインストールします。
3. プラグインの Connectors タブを開いて pocketbasecloud に接続します。PocketBase Cloud にサインインし、アクセス権とプロジェクトを選択します。インストールしただけでは接続されません。

ここで追加したプラグインは Claude アカウントに保存されるため、同じアカウントでサインインすれば Claude Code でも利用できます。

サーバーのみを使う場合の Claude（claude.ai と Claude Desktop）

1. Customize → Connectors を開き、+ Add → Add custom connector を選択します。
2. 名前（例：PocketBase Cloud）を付け、サーバー URL を貼り付けて続行します。Claude が自分自身をどのように識別するか尋ねられた場合は、Register automatically を選択します。Add をクリックします。
3. Connect をクリックし、PocketBase Cloud にサインインしてから、アクセス権とプロジェクトを選択します。

Team または Enterprise プランの場合、オーナーが Organization settings → Connectors → Add → Custom → Web から一度追加すると、各メンバーは Connect をクリックするだけで接続できます。

ChatGPT

1. Plugins → + → Add custom MCP server.
2. 名前を付け、Connection の下にサーバー URL を入力し、認証方式に OAuth を選択します。カスタムサーバーに関する警告に同意してから、Create as a plugin を選択します。
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サーバーは1つだけにしてください。追加済みの場合は、.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エージェントの場合は、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アクセストークン（ポータル → 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 はそれぞれ独自の用語（http）を使う .mcp.json を読み込みます。Gemini CLI では Streamable HTTP エンドポイントを httpUrl と呼びます。すべてのファイルでエンドポイントを同じにしてください。npm run validate で確認できます。

ツール

サーバーのツールはグループに分かれています。オプトインと記されたグループは、features オプションで追加できます。すべてのツールを含む最新の一覧は、接続ページをご覧ください。

グループ	デフォルト	対応内容
account	✅	アカウント、プラン、無料トライアル、プロジェクト、リージョンの概要、およびプロジェクトの作成。
resources	✅	PocketBase インスタンス、フロントエンド、バックエンド：一覧表示、詳細確認、インスタンスの作成、ランタイム設定、継続的なバックアップ。
deploy	✅	デプロイとそのビルドログ、ランタイムログ、ワンコール診断、フック、静的サイト、およびソースコードをデプロイする pbc コマンド。
domains	✅	カスタムドメインの追加、確認、状態チェック、削除。
docs	✅	エージェント向けの PocketBase および PocketBase Cloud ガイドを検索。
database	✅	インスタンス内のコレクション、API ルール、レコード、リクエストログ、バックアップ、cron、セキュリティとパフォーマンスのチェック、TypeScript 型。
env	オプトイン	リソースの環境変数（フロントエンドの場合はビルド時の変数）。値が読み戻されることはありません。
database_admin	オプトイン	一括削除と復元：コレクションの切り詰めまたは削除、フィールドの削除、バックアップの復元または削除。

意図的に利用できない操作：プロジェクトやリソースの削除（ポータルまたは pbc を使用してください）、およびサーバー上でのソースコードのビルド（ビルドはお使いのマシンで実行され、サーバーから pbc コマンドが提供されます）。

オプション

サーバー URL のクエリ文字列に追加してください。サインイン時に承認した範囲を狭めることはできますが、広げることはできません。

オプション	デフォルト	効果
read_only	false	読み取りを行うツールのみを使用します。
project_ref	なし	すべてのツールを 1 つのプロジェクトに制限します。
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 ポータルでサインインします。
• 作成やデプロイが可能な範囲はプランによって異なります。新しいアカウントには無料トライアルが適用されます。
• ソースコードのデプロイには、マシンに PocketBase Cloud CLI の pbc も必要です。実行する正確なコマンドはサーバーから通知されます。
• リモートサーバー（Streamable HTTP）と OAuth に対応した MCP クライアントが必要です。Claude でカスタムコネクターを追加するには、それを許可するプランが必要です。

データとセキュリティ

• PocketBase Cloud のセッションはサーバーに保管されます。 サインインすると、承認した接続が保存され、その中で PocketBase Cloud のセッションが暗号化されます。アシスタントには独自のトークンが発行され、有効期限は1時間で、自動的に更新されます。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 ポータルが開き、通常どおりサインインして、アクセス権（読み取りと書き込み、または読み取り専用）とプロジェクト（すべて、または1つ）を選択します。トークンが更新されるたびに接続も更新されるため、使用中は有効な状態が維持されます。

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 では、支払い済み、保留中、返金済みの注文はそれぞれ何件ありますか？その後、最新の5件を表示してください。」
• 「各ユーザーが自分の注文だけを閲覧できるように、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 により、接続が読み取り専用になっています。再接続し、読み取りと書き込みを選択してください。
プロジェクトが1つしか表示されない	接続が1つのプロジェクトに制限されています。再接続してすべてのプロジェクトを選択するか、project_ref を削除してください。
データベースツールが表示されない	データベースツールは、デフォルトで有効な database グループに含まれています。URL の features に引き続き含まれていることを確認してください。
再度サインインするよう求められる	30日間使用されなかった接続は終了します。再度サインインしてください。
Cursor のサインインで「Invalid redirect URI」と表示される	Cursor を更新してください。現在のバージョンでは http://localhost 経由でサインインします。古いバージョンでは cursor:// コールバックを使用していましたが、サーバーでは受け付けられません。
Claude が自分自身の識別方法を尋ねる	自動登録を選択してください。

セキュリティ

セキュリティ上の問題を見つけましたか？公開の Issue は作成せず、SECURITY.md をご覧ください。

サポートとフィードバック

• バグやアイデア： Issue を作成してください。
• アカウント、請求、プラットフォームに関する質問： PocketBase Cloudをご覧ください。
• コントリビューション： CONTRIBUTING.mdをご覧ください。

免責事項

PocketBase Cloud は、オープンソースプロジェクトである PocketBase とは独立しています。サーバーは mcp.pocketbasecloud.com でホストされるサービスです。このリポジトリにはドキュメント、クライアントマニフェスト、MCP Registry のエントリー、スキルが含まれており、サーバーのコードは含まれていません。サービスの進化に伴い、ツール名や動作が変更される場合があります。最新の一覧は接続ページをご覧ください。