Next TokenParallel World

← ラボ / Claude Code ガイド / 連携台帳

PlanetScale, Inc.・データベース・海外　公式サイト
PostgresおよびVitess（MySQL互換）のマネージドデータベース。公式CLI pscale とAPIを持ち、公式のホスト型MCPがある。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり
MCP: OAuth接続時にデータベースの権限を「no access / read-only / full access」から選べる。組織管理者は Settings の「MCP query access」を「No query access / Read-only queries / Read and write queries」に設定でき、既定は「Read and write queries」。この設定は新しい認可にだけ適用され、認可済みのクライアントは取り消されるまで従来の権限を保つ、と公式に記載。Insights専用URL（https://mcp.pscale.dev/mcp/planetscale-insights-only）は読み書きクエリのツールを持たない。https://planetscale.com/docs/connect/mcp
権限（スコープ）を選べるか あり
MCP: OAuthで「organization or per-database level」に権限を付けられ、サーバーが見える組織・データベース・ブランチを絞れる。支払い方法は no access / read-only / full access から選ぶ（カード更新は full access が必要）。サービストークン: 組織レベル（read_databases, create_databases, delete_databases, read_invoices, delete_service_tokens など）とデータベース単位（read_database, delete_database, create_branch, delete_branch, delete_production_branch, restore_backup など）を個別に付与でき、自分が許可されている権限しか付けられない（https://planetscale.com/docs/api/reference/service-tokens）。
危険な操作の既定
MCP: WHEREなしの UPDATE / DELETE と TRUNCATE はブロック。DDL（CREATE, DROP, ALTER など）は「prompt the LLM to request human confirmation」と記載（確認の実装はクライアント側）。組織の既定は読み書き可。支払い方法の更新はStripe Checkoutを開く流れ。
削除ができるか できる
MCPの26ツールにデータベース・ブランチの削除ツールはない。execute_write_query の DELETE（WHERE付き）と DDL（DROP等）は実行できる。CLI: pscale database delete <DATABASE_NAME>（--force は「Skip confirmation for destructive actions」）、pscale branch delete（--delete-descendants で子孫ブランチも削除。--force は説明なし）。pscale branch update の --deletion-protected でブランチを削除から保護できる。API: サービストークンの delete_databases / delete_database / delete_branch / delete_production_branch などの権限。削除後の復元可否は公式ページに記載なし。
取り消し方（キー・接続）
MCP: 認可済みクライアントは取り消されるまで権限を保つと記載があるが、取り消しの手順は記載なし。サービストークン: 作成は Settings > Service tokens > New service token。削除・失効の手順は記載なしで、delete_service_tokens という権限の存在のみ確認。

根拠のページ

つなぎ方（公式の資料にある範囲）

公式MCP あり

ホスト型MCPサーバー。組織・データベース・ブランチ・スキーマ・Insightsデータ・組織の支払い方法にアクセスできる。26ツール（planetscale_ 接頭辞）: 一覧・取得（organizations, databases, branches, branch_schema）、execute_read_query（SELECT/SHOW/DESCRIBE/EXPLAIN）、execute_write_query（INSERT/UPDATE/DELETE/DDL）、get_insights、リージョン・クラスターサイズ一覧、請求（list_invoices, get_invoice_line_items, get_organization_billing_payment_method, update_payment_method, get_payment_method_setup）、docs検索、スキーマ推奨、エラー・ログ・クエリタグ・メトリクス。Insights専用URLでは読み書きのクエリツールが除かれる。OAuthの権限は組織またはデータベース単位で no access / read-only / full access から選べ、サーバーが見える組織・データベース・ブランチは権限で絞られる。

つなぎ方（公式の記載）
公式ページの例: claude mcp add --transport http "planetscale" https://mcp.pscale.dev/mcp/planetscale 。または /plugin marketplace add planetscale/claude-plugin のあと /plugin install planetscale@planetscale 。/mcp で planetscale を選びブラウザで認証。

根拠のページ

公式CLI あり

pscale CLI。Vitess・Neki・Postgresのデータベースとブランチの作成・削除・一覧、非対話SQL、シェル、デプロイリクエストの管理。database（create, delete, list, show, dump, restore-dump, update）、branch（create, delete, list, show, diff, promote, switch, schema）、sql、backup、service-token など。エージェント自動化には pscale 0.292.0 以上が必要と記載。

根拠のページ

公式API あり

PlanetScale API。ベースURL https://api.planetscale.com/v1（例: /v1/organizations）。サービストークン（ID:トークンをAuthorizationヘッダー）で認証。一部の組織向けエンドポイントはOAuthも必要。

根拠のページ

第三者製MCP（公式ではない） 見つからず

見つかっていません。

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所（4件）

できる操作

読み取りでできる操作

  • 【MCP】組織・データベース・ブランチ・スキーマの取得、execute_read_query、Insights、メトリクス、ログ、請求書・支払い方法の参照
  • 【CLI】データベース・ブランチの一覧・表示、sql（非対話）、dump
  • 【API】サービストークンの権限に応じた参照（read_databases, read_branch, read_invoices 等）

書き込みでできる操作

  • 【MCP】execute_write_query（INSERT/UPDATE/DELETE/DDL）
  • 【CLI】database create/update、branch create/promote、deploy-request、restore-dump
  • 【API】権限に応じて作成・更新（create_databases, create_branch, create_deploy_request 等）

管理者操作（削除・課金・設定変更など）

  • 【MCP】planetscale_update_payment_method（Stripe Checkout を開始してカードを追加・置換。Payment method full access が必要）。データベース・ブランチ・組織の削除ツールは公式一覧に無い（SQLの DROP は DDL として確認つきで実行可能）
  • 【CLI】pscale database delete <DATABASE_NAME>（--force は「Skip confirmation for destructive actions」）、pscale branch delete（--delete-descendants で子ブランチも削除。--force は説明なし）、pscale branch update --deletion-protected（削除保護）、service-token の管理
  • 【API】サービストークンの権限に delete_databases、delete_database、delete_branch、delete_production_branch、delete_production_branch_password、delete_backups、restore_backup などがある。トークン自体の作成・削除は write_service_tokens / delete_service_tokens

制限

  • pscale のエージェント自動化機能は 0.292.0 以上
  • サービストークンでは auth login/logout、shell/connect、org show などが設計上失敗する（CLIページ）
  • MCPクエリ権限の既定は『読み書き』（組織管理者の設定で変更可。新しい認可にだけ適用され、認可済みクライアントは取り消されるまで従来の権限を保つ）
注意
  • MCPは読み取り専用ではない。既定の組織設定では書き込みクエリも許可される、と公式に記載。管理者の「MCP query access」は新しい認可にだけ適用され、認可済みクライアントは取り消されるまで従来の権限を保つ。
  • DDL（DROP含む）は確認をLLMに要求するだけで、確認の実装はクライアント側に依存する可能性がある（公式ページは仕組みの詳細を記載せず）。
  • pscale database delete の --force は「Skip confirmation for destructive actions」と説明されているが、確認が既定で出るとはページに明記なし。pscale branch delete の --force は説明なし。本番ブランチ削除のブロックは記載なし。--deletion-protected でブランチを削除から保護できる。
  • ブランチやデータベースの削除を取り消せるか（ごみ箱・復元）は取得ページに記載なし。バックアップ復元(restore_backup)の権限は存在する。

認証・料金・日本語・実機検証

認証方式
【MCP】OAuth（接続時にPlanetScaleでサインインして許可。組織またはデータベース単位で『アクセスなし／読み取り専用／フルアクセス』を選べる）。CI・ヘッドレス向けにサービストークンも可。【CLI】pscale auth login、またはサービストークン（PLANETSCALE_SERVICE_TOKEN_ID / PLANETSCALE_SERVICE_TOKEN）。【API】サービストークン。
公表されている料金（2026年10月16日確認）
公表価格（$表記、通貨コードは明記なし、2026-10-16確認）: PlanetScale Postgres の Single node は月$5〜、Metal は月$50〜。High Availability・Vitess・Neki は価格の記載なし（クラスターサイズ等で変動）。Enterpriseは要問い合わせ。無料プランはこのページに記載なし。 料金ページ
日本語対応
未確認。公式ドキュメントと管理画面の日本語有無は確かめていない（取得ページは英語のみで、日本語版への言及なし）。planetscale.com/docs/cli にも日本語の記載はなかったが、「なし」とは言えない。
Claude Code実機検証
未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）
確認できていない点（8件）
  • 日本語対応（ドキュメント・管理画面）
  • CLIの導入コマンド（セットアップページ /docs/cli/planetscale-environment-setup は未読）
  • pscale database delete の確認が既定で出るか（--force の説明のみで、ページに明記なし）、本番ブランチ削除のブロックの有無（記載なし）
  • サービストークンの取り消し・削除の具体手順、MCP OAuth連携の取り消し
  • 削除したデータベース・ブランチの復元可否
  • Vitess・Neki・High Availability の価格（料金ページに数値なし。SQL版・pricing.mdは未読）
  • 第三者製MCP: MCPレジストリ検索のみ実施。GitHub検索・modelcontextprotocol/servers一覧は未実施
  • 2026-10-17再確認で残った点: ja：公式MCPページ（planetscale.com/docs/connect/mcp）に言語選択・翻訳の記載なし。管理画面の言語も未確認
出典（8件）

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。