Neon
Claude Codeに渡せる権限の範囲と、つなぎ方を、公式の資料から読み取れる範囲でまとめました。
← ラボ / 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件
- peterkyle01/neon-context-server(作者: peterkyle01(個人)・最終更新: 2026-06-15(最終push))
書き込み・削除: 未確認
READMEの記載:Zedエディタ向けのNeonコンテキストサーバーで、「データベースのクエリ、スキーマの確認、プロジェクトとブランチの一覧」ができる。書き込み・削除の可否はREADMEに記載なし。Neon APIキーを環境変数で渡す。
https://github.com/peterkyle01/neon-context-server - jordan-jakisa/mcp-server-neon(作者: jordan-jakisa(個人)・最終更新: 2026-05-28(最終push))
書き込み・削除: True
READMEの記載:Neon公式の @neondatabase/mcp-server-neon をZedの拡張から使えるようにするもの。プロジェクト・ブランチ・データベースの作成・変更・削除ができる旨の警告がある。開発用リソースだけに絞ったAPIキーを使うよう書かれている。
https://github.com/jordan-jakisa/mcp-server-neon
第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。
探した場所(5件)
- https://registry.modelcontextprotocol.io/v0/servers?search=neon&limit=20(Neon DB向けの第三者製は見当たらず。GitHub検索は未実施)
- https://api.github.com/search/repositories?q=neon+postgres+mcp+server&sort=stars&per_page=8
- WebSearch『Neon Postgres MCP server github community』
- https://github.com/peterkyle01/neon-context-server
- https://github.com/jordan-jakisa/mcp-server-neon
できる操作
読み取りでできる操作
- 【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件)
- Neon MCP Server(Neon docs)(確認日 2026-10-16)
- mcp-server-neon README(GitHub neondatabase)(確認日 2026-10-16)
- Neon CLI リファレンス(Neon docs)(確認日 2026-10-16)
- Manage API keys(Neon docs)(確認日 2026-10-16)
- Manage projects(Neon docs)(確認日 2026-10-16)
- Pricing(Neon)(確認日 2026-10-16)
- MCPレジストリ検索 neon(Model Context Protocol)(確認日 2026-10-16)
- Connect MCP clients to Neon(Neon docs)(確認日 2026-10-16)
- neonctl(GitHub neondatabase、archived)(確認日 2026-10-16)
- Neon API リファレンス(Neon docs)(確認日 2026-10-16)
- peterkyle01/neon-context-server README(GitHub)(確認日 2026-10-17)
- jordan-jakisa/mcp-server-neon README(GitHub)(確認日 2026-10-17)
この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。
ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。