Neon Serverless Postgres

ユーザーをあらゆる Neon 関連タスク（セットアップ、接続、ブランチング、高度な機能）にガイドします。動作する Neon 接続、完成した機能構成、または公式 Neon ドキュメントからの特定の回答を提供してください。

Neon はサーバーレス Postgres プラットフォームで、コンピューティングとストレージを分離して、オートスケーリング、ブランチング、即座の復元、スケールトゥーゼロを提供します。Postgres と完全に互換性があり、Postgres をサポートするあらゆる言語、フレームワーク、ORM で動作します。

Neon ドキュメント

Neon ドキュメントは、すべての Neon 関連情報の信頼できる情報源です。応答する前に、常に公式ドキュメントに対して主張を確認してください。Neon 機能と API は進化し続けているため、トレーニングデータに頼るのではなく、最新のドキュメントを取得することを優先してください。

ドキュメントをマークダウンとして取得

Neon ドキュメントページは、以下の 2 つの方法でマークダウンとして取得できます。

1. URL に .md を追加 （最も簡単）: https://neon.com/docs/introduction/branching.md
2. 標準 URL で text/markdown をリクエスト: curl -H "Accept: text/markdown" https://neon.com/docs/introduction/branching

どちらの方法でも同じマークダウンコンテンツを返します。あなたのツールがサポートしている方法を使用してください。

適切なページを見つける

ドキュメントインデックスは、利用可能なすべてのページをその URL と短い説明付きでリストします。

https://neon.com/docs/llms.txt

一般的なドキュメント URL は、以下のトピックリンクで整理されています。ここにリストされていないページが必要な場合は、ドキュメントインデックスを検索してください: https://neon.com/docs/llms.txt。URL を推測しないでください。

Neon とは

アーキテクチャの説明と用語集（組織、プロジェクト、ブランチ、エンドポイント）に使用してから、実装アドバイスを提供してください。

リンク: https://neon.com/docs/introduction/architecture-overview.md

使い始める

ユーザーを初回 Neon セットアップにガイドするときに、このセクションを使用してください。

現在の状況を確認

セットアップを開始する前に、ユーザーのコードベースと環境を検査してください。

• 既存のデータベース接続コード
• 既存の Neon MCP サーバーまたは Neon CLI 構成
• .env ファイルと DATABASE_URL 環境変数の存在
• 既存の ORM（Prisma、Drizzle、TypeORM）構成

Neon CLI または MCP サーバーによる自動セットアップ

既存の接続された Neon プロジェクトを検査するか、Neon CLI または MCP サーバーを使用して新しいプロジェクトを作成することを提案してください。どちらもまだセットアップされていない場合は、--agent フラグ付きで init を実行してください。npx -y を使用してパッケージインストールプロンプトをスキップします。認証は自動的に処理されます。ユーザーがログインしていない場合は、OAuth 用にブラウザを開き、完了を待ってから続行します。

npx -y neonctl@latest init --agent <agent-name>

サポートされている --agent 値: cursor、copilot、claude、claude-desktop、codex、opencode、cline、gemini-cli、goose、zed。

これは Neon 拡張機能（Cursor/VS Code 用）または MCP サーバー（その他のエージェント用）をインストールし、API キーを作成し、プロジェクトに neon-postgres エージェントスキルを追加します。

init が適切でない場合は、個別のステップを非対話的に実行できます。

• 拡張機能: cursor --install-extension databricks.neon-local-connect
• MCP サーバー: npx -y add-mcp https://mcp.neon.tech/mcp -g -n Neon -y -a <agent-name>
• エージェントスキル: npx skills add neondatabase/agent-skills --skill neon-postgres --agent <agent-name> -y

完全な CLI インストールオプションについては、https://neon.com/docs/reference/cli-install.md を参照してください。

セットアップフロー

1. 組織とプロジェクトを選択

MCP サーバーまたは CLI を使用して、組織とプロジェクトをリストします。ユーザーに既存プロジェクトを選択するか、新しいプロジェクトを作成させます。

2. 接続文字列を取得

MCP サーバーまたは CLI を使用して接続文字列を取得します。既存の値を上書きしないようにまず .env ファイルを読んでから、DATABASE_URL として保存してください。

3. 接続方法とドライバーを選択

接続方法ガイドを参照して、デプロイプラットフォームに基づいて正しいドライバーを選択してください: https://neon.com/docs/connect/choose-connection.md

4. Neon Auth によるユーザー認証（必要な場合）

CLI ツール、スクリプト、またはユーザーアカウントのないアプリの場合はスキップします。アプリが認証を必要とする場合: MCP サーバーの provision_neon_auth ツールを使用し、認証概要（https://neon.com/docs/auth/overview.md）でセットアップを確認します。認証とデータベースクエリの場合は、JavaScript SDK リファレンス（https://neon.com/docs/reference/javascript-sdk.md）を参照してください。

5. ORM セットアップ（オプション）

既存の ORM（Prisma、Drizzle、TypeORM）を確認します。存在しない場合は、ORM が必要かどうかユーザーに尋ねます。Drizzle 統合については、https://neon.com/docs/guides/drizzle.md を参照してください。

6. スキーマセットアップ

• 既存のマイグレーションファイルまたは ORM スキーマを確認
• 存在しない場合: サンプルスキーマを作成するか、一緒に設計することを提案

再開サポート

セットアップを再開する場合は、すでに構成されているもの（MCP 接続、DATABASE_URL を含む .env、依存関係、スキーマ）を確認し、次の未完了ステップから続行します。

セキュリティのリマインダー

ユーザーに対して、認証情報に環境変数を使用すること、接続文字列をコミットしないこと、最小権限のデータベースロールを使用することを思い出させてください。

接続方法とドライバー

ランタイム制約（TCP、HTTP、WebSocket、エッジ、サーバーレス、長時間実行）に基づいて、正しいトランスポートとドライバーを選択する必要がある場合に使用します。

リンク: https://neon.com/docs/connect/choose-connection.md

Serverless ドライバー

HTTP クエリ、WebSocket トランザクション、ランタイム固有の最適化を含む @neondatabase/serverless パターンに使用します。

リンク: https://neon.com/docs/serverless/serverless-driver.md

Neon JS SDK

PostgREST スタイルのクエリと型付きクライアントセットアップを使用した、Neon Auth とデータ API ワークフローの組み合わせに使用します。

リンク: https://neon.com/docs/reference/javascript-sdk.md

開発者ツール

npx -y neonctl@latest init --agent <agent-name> を使用したローカル開発の有効化、VSCode 拡張機能のセットアップ、Neon MCP サーバー構成に使用します。

ツール	URL
CLI Init コマンド	https://neon.com/docs/reference/cli-init.md
VSCode 拡張機能	https://neon.com/docs/local/vscode-extension.md
MCP サーバー	https://neon.com/docs/ai/neon-mcp-server.md
Neon CLI	https://neon.com/docs/reference/neon-cli.md

Neon CLI

ターミナルファースト、スクリプト、CI/CD オートメーションワークフロー（neonctl を使用）に使用します。

リンク: https://neon.com/docs/reference/neon-cli.md

Neon 管理 API

Neon 管理 API は、Neon リソースをプログラム的に管理するために使用できます。これは Neon CLI と MCP サーバーの背後で使用されていますが、より複雑なオートメーションワークフロー用や、Neon を他のアプリケーションに埋め込むときも直接使用できます。

Neon REST API

直接 HTTP オートメーション、エンドポイントレベルの制御、API キー認証、レート制限処理、オペレーションポーリングに使用します。

リンク: https://neon.com/docs/reference/api-reference.md

Neon TypeScript SDK

@neondatabase/api-client 経由で TypeScript で Neon リソースの型付きプログラマティック制御を実装するときに使用します。

リンク: https://neon.com/docs/reference/typescript-sdk.md

Neon Python SDK

neon-api パッケージを使用して Python で Neon 管理をプログラム的に実装するときに使用します。

リンク: https://neon.com/docs/reference/python-sdk.md

Neon Auth

マネージドユーザー認証セットアップ、UI コンポーネント、認証方法、Next.js と React アプリでの Neon Auth 統合の落とし穴に使用します。

リンク: https://neon.com/docs/auth/overview.md

Neon Auth は Neon JS SDK にも埋め込まれています。ユースケースに応じて、Neon Auth だけではなく Neon JS SDK を使用することもできます。詳細は https://neon.com/docs/connect/choose-connection.md を参照してください。

ブランチング

ユーザーが分離された環境、スキーママイグレーションテスト、プレビューデプロイメント、またはブランチライフサイクルオートメーションを計画している場合に使用します。

重要なポイント：

• ブランチはインスタント、コピーオンライトクローン（フルデータコピーなし）です。
• 各ブランチは独自のコンピューティングエンドポイントを持っています。
• neonctl CLI または MCP サーバーを使用して、ブランチを作成、検査、比較します。

リンク: https://neon.com/docs/introduction/branching.md

詳細なブランチ作成ワークフロー（通常ブランチ対スキーマのみブランチ、親からのリセット、CLI/MCP 選択）については、完全なブランチングスキルを取得してください。

https://neon.com/docs/ai/skills/neon-postgres-branches/SKILL.md

スキルを直接インストールするには：

npx skills add neondatabase/agent-skills --skill neon-postgres-branches

オートスケーリング

ユーザーがコンピューティングをワークロードで自動的にスケーリングする必要があり、CU サイジングとランタイム動作のガイダンスが必要な場合に使用します。

リンク: https://neon.com/docs/introduction/autoscaling.md

スケールトゥーゼロ

アイドルコストを最適化し、サスペンド/レジューム動作（コールドスタートの取引を含む）について説明する場合に使用します。

重要なポイント：

• アイドルコンピューティングは自動的に一時停止します（デフォルト 5 分、構成可能）（無効化を除く - launch & scale プランのみ）
• サスペンド後の最初のクエリは通常コールドスタートペナルティを持ちます（約数百 ms）
• ストレージは、コンピューティングが一時停止している間もアクティブなままです。

リンク: https://neon.com/docs/introduction/scale-to-zero.md

即座の復元

ユーザーがポイントインタイム復旧を必要とするか、従来のバックアップ復元ワークフローなしでデータ状態を復元したい場合に使用します。

重要なポイント：

• インスタント復元の履歴ウィンドウはプラン制限に依存します。
• ユーザーは過去のポイントインタイムからブランチを作成できます。
• Time Travel クエリは、履歴検査ワークフローに使用できます。

リンク: https://neon.com/docs/introduction/branch-restore.md

読み取り専用レプリカ

ユーザーが読み取り集約的ワークロードを必要とし、ストレージを複製せずに専用の読み取り専用コンピューティングが必要な場合に使用します。

重要なポイント：

• レプリカは、同じストレージを共有する読み取り専用コンピューティングエンドポイントです。
• 作成は高速で、スケーリングはプライマリコンピューティングから独立しています。
• 典型的なユースケース: 分析、レポート、読み取り集約的な API。

リンク: https://neon.com/docs/introduction/read-replicas.md

接続プーリング

ユーザーがサーバーレスまたは高い同時実行性環境にあり、安全でスケーラブルな Postgres 接続管理が必要な場合に使用します。

重要なポイント：

• Neon プーリングは PgBouncer を使用します。
• プール接続を使用するには、エンドポイントホスト名に -pooler を追加します。
• プーリングは、バースト同時実行性を持つサーバーレスランタイムで特に重要です。

リンク: https://neon.com/docs/connect/connection-pooling.md

IP 許可リスト

ユーザーが信頼されたネットワーク、IP、または CIDR 範囲によってデータベースアクセスを制限する必要がある場合に使用します。

リンク: https://neon.com/docs/introduction/ip-allow.md

論理レプリケーション

CDC パイプライン、外部 Postgres 同期、またはレプリケーションベースのデータ移動を統合するときに使用します。

重要なポイント：

• Neon はネイティブな論理レプリケーションワークフローをサポートしています。
• 外部 Postgres システムへの/からのレプリケーションに役立ちます。

リンク: https://neon.com/docs/guides/logical-replication-guide.md