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

Neon(公式トップに「Neon is a complete backend from Databricks, built on Lakebase Postgres」と記載。運営法人名はページから確認できない)・データベース・海外 公式サイト
サーバーレスのPostgresサービス。プロジェクト・ブランチ・コンピュートを持ち、無操作時はコンピュートが停止(scale-to-zero)する。公式MCPは『Neonのプロジェクトに対してAIアシスタントが代わりに操作する』ものと説明されている。

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

読み取り専用で渡せるか あり
MCP: URLに ?readonly=true を付ける(「restrict the server to read operations」)。OAuthなら認可画面で Allow writes のチェックを外す/読み取り専用スコープを選ぶ。APIキー方式では ?readonly=true か、ヘッダー x-read-only(GitHub README)で指定する。https://neon.com/docs/ai/neon-mcp-server と https://github.com/neondatabase/mcp-server-neon に記載。読み取り専用のAPIキー自体の種類は公式ページに記載なし。接続手順ページ(https://neon.com/docs/ai/connect-mcp-clients-to-neon)には読み取り専用モードの記載はない。
権限(スコープ)を選べるか あり
MCP: ?projectId=<id> で全操作を1プロジェクトに限定(プロジェクト横断の検索は無効、delete_project は非表示)。組織のAPIキーを渡すとその組織のプロジェクトに限られる。?category= でツールのカテゴリを限定(projects, branches, endpoints, snapshots, schema, querying, neon_auth, data_api, observability, docs, functions, storage の12種)。APIキーは個人/組織/プロジェクト限定の3種。プロジェクト限定キーは組織レベルの操作・プロジェクト作成ができず、プロジェクト自体を削除できない(https://neon.com/docs/manage/api-keys)。
危険な操作の既定
実行前の確認の仕組みは公式に具体記載なし。公式は「Always review and authorize actions requested by the LLM before execution」と記載。MCPは「development and testing only」「Never connect MCP agents to production databases」と記載。READMEは「intended for local development and IDE integrations only」。
削除ができるか できる
MCP(READMEのツール名): delete_project、delete_branch、delete_snapshot、delete_postgres_endpoint、delete_data_api、delete_function、delete_trigger、delete_storage_bucket、delete_storage_object、delete_storage_objects_by_prefix、delete_auth_user など。ほかに reset_from_parent、restore_snapshot、revoke_credential、disable_auth。CLI: neon projects delete / neon branches delete。削除したプロジェクトは7日以内なら復元でき(neon projects recover、API POST /projects/{project_id}/recover)、復元期間中は保管料・復元料はかからない。復元で戻らないもの: Data API、GitHub連携、Neon-Managed Vercel連携、Vercel-Managed Neon連携、Datadog/OpenTelemetry連携(手動で再設定)。有料プランは全プロジェクトを削除しても課金は止まらず、Freeへのダウングレードが必要(https://neon.com/docs/manage/projects)。
取り消し方(キー・接続)
APIキーの失効は即時で、以後そのキーを使うものは動かなくなる(CLI: neon api-keys revoke <key-id>、コンソール Account settings > API keys、API: DELETE /api/v2/api_keys/{key_id})。OAuth連携の取り消しは公式の記載なし。接続手順ページに、ローカルのキャッシュ ~/.mcp-auth を削除して再認証する手順があるが、取り消しとしては書かれていない。

根拠のページ

つなぎ方(公式の資料にある範囲)

公式MCP あり

公式リモートMCP(https://mcp.neon.tech/mcp、Streamable HTTP)。ツールは12カテゴリ(projects, branches, endpoints, snapshots, schema, querying, neon_auth, data_api, observability, docs, functions, storage)。うち projects(プロジェクトの一覧・作成・説明・削除、組織一覧)、branches(ブランチの作成・リセット・削除、ロール・データベース管理)、querying(クエリ・トランザクション実行、一時ブランチ上のスキーマ変更)。GitHubのREADMEには create_project / delete_project / delete_branch / run_sql / run_sql_transaction / reset_from_parent / get_connection_string / prepare_database_migration / complete_database_migration などが載っている。

つなぎ方(公式の記載)
Claude Code向けの手順は接続手順ページ https://neon.com/docs/ai/connect-mcp-clients-to-neon にある。OAuth: npx add-mcp https://mcp.neon.tech/mcp -a claude-code 。APIキー: claude mcp add --transport http neon https://mcp.neon.tech/mcp --header "Authorization: Bearer <YOUR_NEON_API_KEY>" 。MCPページ(https://neon.com/docs/ai/neon-mcp-server)は npx neon@latest plugins(Claude Codeを含むプラグイン対応エージェント向け)、npx neon@latest mcp / init を案内。READMEにはリモートOAuthの例 npx add-mcp "https://mcp.neon.tech/mcp?..." と、APIキー方式(Authorization: Bearer <NEON_API_KEY>)がある。Claude Code向けガイド https://neon.com/guides/claude-code-mcp-neon がREADMEにリンクされている(未読)。

根拠のページ

公式CLI あり

Neon CLI。公式ドキュメントでは導入は npm i -g neon、呼び出しコマンドは neon で、neonctl は neon の別名と記載(Homebrewの記載はこのページになし)。旧リポジトリ https://github.com/neondatabase/neonctl は archived で「The Neon CLI has moved」(neondatabase/neon-pkgs の packages/cli へ)と表示され、そこには npm i -g neonctl / brew install neonctl の表記が残る(archived リポジトリの記載)。プロジェクト、ブランチ、データベース、ロール、接続文字列などを管理。neon projects delete <id>、neon projects recover <id>、neon branches delete、neon api-keys revoke <id> などがある。認証は --api-key → NEON_API_KEY 環境変数 → neon login の認証情報 → ブラウザ認証の順。

根拠のページ

公式API あり

Neon API。参照ページ https://neon.com/docs/reference/api に、ベースURL https://console.neon.tech/api/v2、認証 Authorization: Bearer $NEON_API_KEY、OpenAPI仕様 https://neon.com/api_spec/release/v2.json と記載。レート制限はそのページに記載なし。APIキー管理は DELETE /api/v2/api_keys/{key_id}、削除済みプロジェクトの一覧は GET /projects?recoverable=true、復元は POST /projects/{project_id}/recover。

根拠のページ

第三者製MCP(公式ではない) 2件

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

探した場所(5件)

できる操作

読み取りでできる操作

  • 【MCP】プロジェクト・組織・ブランチの一覧・説明、SELECTやスキーマ確認(run_sql、get_database_tables など。?readonly=true でも使える)
  • 【CLI】プロジェクト・ブランチ等の一覧(neon projects list --recoverable-only で復元可能な削除済みプロジェクトも)

書き込みでできる操作

  • 【MCP】create_project、create_branch、run_sql(書き込み含む)、run_sql_transaction、マイグレーション用ツール(prepare/complete_database_migration)。readonly では使えない
  • 【CLI】ブランチ・データベース・ロールなどの管理(公式ページに列挙)

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

  • 【MCP】delete_project(プロジェクト削除。projectId で絞ると非表示)、delete_branch、reset_from_parent。GitHub READMEのツール名にはほかに delete_snapshot, delete_postgres_endpoint, delete_data_api, delete_function, delete_trigger, delete_functions_custom_domain, delete_storage_bucket, delete_storage_object, delete_storage_objects_by_prefix, delete_auth_user, delete_auth_oauth_provider, delete_auth_trusted_domain、restore_snapshot, revoke_credential, disable_auth がある(READMEの一覧が完全列挙とは限らない)。readonly では作成・削除系ツールは使えない
  • 【CLI】neon projects delete / neon projects recover / neon branches delete / neon api-keys revoke / neon claim delete(未クレームのプロジェクトを完全削除)
  • 【API】APIキーの失効(DELETE /api/v2/api_keys/{key_id})、削除済みプロジェクトの復元(POST /projects/{project_id}/recover)

制限

  • MCPは『開発・テスト用のみ。本番環境は非推奨』と公式に記載
  • OAuth利用時は既定で個人アカウントを対象にする。組織のプロジェクトには org_id か project_id をプロンプトに含める(README)
  • プロジェクト限定APIキーは組織レベルの操作・新規プロジェクト作成ができない
  • Freeプランは5分で停止(scale-to-zero)で無効化不可(料金ページ)
注意
  • プロジェクト削除後の復元期間は7日。期間後は恒久削除。復元でブランチ・エンドポイント・スナップショット・設定・接続文字列は戻るが、Data API、GitHub連携、Vercel連携、Datadog/OpenTelemetry連携は手動で再設定が必要と公式に記載。
  • 有料プランでは、全プロジェクトを削除しても課金は止まらず、Freeプランへのダウングレードも必要と公式に記載。
  • MCPは『広範なデータベース管理能力を与える』と公式に記載。認証時にアカウント名とメールを含む識別イベントが送信される(NEON_MCP_DISABLE_ANALYTICS=1 で分析は無効化、Sentryは無効化されない)とREADMEに記載。
  • neon projects delete などCLIの確認プロンプトや --force の有無は公式ページに記載なし。

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

認証方式
【MCP】OAuth(認可画面で『Allow writes』を外す/読み取り専用スコープを選べる)またはAPIキー(Authorization: Bearer)。【CLI/API】APIキー(個人/組織/プロジェクト限定)、neon login。
公表されている料金(2026年10月16日確認)
公表価格($表記、通貨コードは明記なし、2026-10-16確認): Free $0/月(プロジェクトあたり100 CU時間・1GB)、Launch 従量課金(コンピュート $0.106/CU時間、ストレージ $0.35/GB月)、Scale 従量課金($0.222/CU時間、$0.35/GB月)。追加ブランチ $1.50/ブランチ月。Business・Enterprise はこのページに価格の記載なし。 料金ページ
日本語対応
未確認。公式ドキュメントと管理画面の日本語有無は確かめていない(取得ページに言語の記載なし)。neon.com/docs/introduction と neon.com にも言語切替・日本語の記載はなかったが、「なし」とは言えない。
Claude Code実機検証
未検証(この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます)
確認できていない点(9件)
  • 日本語対応(ドキュメント・管理画面)
  • Neon APIのレート制限(参照ページ https://neon.com/docs/reference/api に記載なし)
  • CLIの削除系コマンドの確認プロンプト・--force の有無
  • MCPページ側のツール個別名(ドキュメント側はカテゴリ記載のみ。ツール名はGitHub READMEの記載)。接続手順ページに読み取り専用モードの記載はない
  • 第三者製MCP: MCPレジストリ検索のみ実施(Neon DB向けは見当たらず)。GitHub検索・modelcontextprotocol/servers一覧は未実施
  • Business・Enterpriseプランの価格(料金ページに無し)
  • 運営法人名(公式トップに Databricks の製品と読める記載があるが、法人名はページから確認できない)
  • 2026-10-17再確認で残った点: ja:検索で日本語対応の記載のあるNeon公式ページを見つけられなかった
  • 2026-10-17再確認で残った点: 公式MCPレジストリは開けず
出典(12件)

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

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