Neon MCP リモートMCPサーバー – 公式URL・MCP接続設定・ツール一覧
Neon MCP は Neon が提供するリモートMCPサーバー(公式運営、カテゴリ:データベース・BaaS)です。エンドポイント https://mcp.neon.tech/mcp を通じて、AIエージェントが直接呼び出せる 23 個の構造化ツールを提供します。
このページでは、公式リモートエンドポイント、トランスポート、認証方式、全ツールスキーマ、リアルタイムの死活監視・セキュリティ監査結果を掲載し、Cursor・Claude Code・VS Code・ChatGPT など 10 のクライアントへのMCP接続手順を解説します。
- 提供元
- Neon ↗
- カテゴリ
- 🗄️ データベース・BaaS
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"neon": {
"url": "https://mcp.neon.tech/mcp"
}
}
}claude mcp add --transport http neon https://mcp.neon.tech/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"neon": {
"type": "http",
"url": "https://mcp.neon.tech/mcp"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.neon.tech/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.neon.tech/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"neon": {
"serverUrl": "https://mcp.neon.tech/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"neon": {
"url": "https://mcp.neon.tech/mcp"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.neon] url = "https://mcp.neon.tech/mcp"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"neon": {
"type": "streamableHttp",
"url": "https://mcp.neon.tech/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"neon": {
"httpUrl": "https://mcp.neon.tech/mcp"
}
}
}🧰 Neon のMCPツールとスキーマ(23)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| list_projects ~27 tok | 🟢 Read | List Neon projects. | — |
| list_shared_projects ~32 tok | 🟢 Read | List projects shared with you. | — |
| create_project ~28 tok | 🟠 Write | Create a Neon project. | — |
| delete_project ~28 tok | 🔴 Destructive | Delete a Neon project. | — |
| describe_project ~29 tok | 🟢 Read | Describe a Neon project. | — |
| get_connection_string ~33 tok | 🟢 Read | Get a Postgres connection string. | — |
| run_sql ~31 tok | 🟠 Write | Run a SQL statement in a Neon database. | — |
| run_sql_transaction ~36 tok | 🟠 Write | Run multiple SQL statements in one transaction. | — |
| describe_table_schema ~31 tok | 🟢 Read | Describe a table's schema. | — |
| get_database_tables ~32 tok | 🟢 Read | List tables in a Neon database. | — |
| create_branch ~28 tok | 🟠 Write | Create a Neon branch. | — |
| describe_branch ~29 tok | 🟢 Read | Describe a Neon branch. | — |
| delete_branch ~28 tok | 🔴 Destructive | Delete a Neon branch. | — |
| prepare_database_migration ~36 tok | 🟠 Write | Prepare a schema migration on a branch. | — |
| complete_database_migration ~34 tok | 🔴 Destructive | Complete a prepared migration. | — |
| explain_sql_statement ~35 tok | 🟢 Read | Get the execution plan of a SQL statement. | — |
| prepare_query_tuning ~34 tok | 🟢 Read | Prepare query tuning recommendations. | — |
| complete_query_tuning ~32 tok | 🟠 Write | Apply prepared query tuning. | — |
| list_slow_queries ~31 tok | 🟢 Read | List slow queries in a project. | — |
| provision_neon_auth ~33 tok | 🟠 Write | Provision Neon Auth for a project. | — |
| get_project_id_from_uri ~34 tok | 🟢 Read | Resolve a project ID from a Neon URI. | — |
| list_organizations ~30 tok | 🟢 Read | List Neon organizations. | — |
| list_branch_computes ~31 tok | 🟢 Read | List computes of a branch. | — |
🛡️ セキュリティ評価・品質・コンテキスト監査
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- OAuth 2.1 with PKCE S256 enforced
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
🔐 OAuth 2.1 とセキュリティ
- 認証方式
- OAuth 2.1
- 動的クライアント登録(DCR)
- ✅ 対応
- PKCE S256
- ✅ 対応
- 保護リソースメタデータ
- https://mcp.neon.tech/.well-known/oauth-protected-resource
📡 公式リモートエンドポイントとトランスポート
リモートエンドポイント https://mcp.neon.tech/mcp は Streamable HTTP(2025-03-26 仕様) を採用。Streamable HTTP は単一の POST エンドポイントで JSON-RPC の双方向通信を完結する現行推奨トランスポートで、npx mcp-remote ブリッジなしに Claude・Cursor・VS Code などへ URL だけでMCP接続できます。
接続前にエンドポイントを オンライン MCP Inspector に貼り付けて initialize / tools/list のハンドシェイクを確認することを推奨します。
🔐 認証・権限フロー
認証方式は OAuth 2.1 です。初回接続時にクライアントが 401 チャレンジを受け取り、WWW-Authenticate ヘッダーから RFC 9728 の保護リソースメタデータを解決。続けて認可サーバー発見(RFC 8414)、動的クライアント登録(DCR)、PKCE S256 によるブラウザ認可が自動で行われます。ブラウザで一度承認するだけで、キーの手動貼り付けは不要です。
🛡️ コンテキスト消費とセキュリティ監査
このサーバーには現在 23 個のツールが登録されており、定義の合計は約 742 トークン。リクエストごとにモデルのシステムプロンプトへ注入されます。セキュリティ評価は A+(公式運営ソース)。ツール名とスキーマが簡潔なほどコンテキストウィンドウへの「税」は低くなります。feecalculator.app で呼び出しあたりのコストも試算できます。
🧩 主要クライアントへのMCP接続
Neon MCP について、Cursor / Claude Code / VS Code / ChatGPT / Windsurf / Kiro / Codex / Cline / Gemini など 10 クライアント向けの設定を自動生成しています。ワンクリック deeplink、claude mcp add コマンド、JSON / TOML スニペットから選べます。代表的なツール:list_projects、list_shared_projects、create_project、delete_project、describe_project など。
📖 Neon の詳細
Neon MCP — Remote MCP Server
Neon's remote MCP is the hosted twin of the open-source mcp-server-neon: list projects, create database branches, describe schemas and run SQL — all authorized through Neon OAuth over Streamable HTTP. Neon's branching model makes it friendly to agents: have them create a branch, run migrations there, and merge when green.
Official Neon MCP Endpoint & Transport Architecture
- Endpoint URL:
https://mcp.neon.tech/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Neon MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Neon MCP uses OAuth 2.1 — the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow — PKCE and Dynamic Client Registration, so no manual client setup is needed — and simply open a browser consent screen.
Of the 4 cataloged tools, 2 are read-only and 2 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.
Common Troubleshooting & Connection Tips
- 401 Unauthorized on connect — that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact
WWW-Authenticatechallenge. - "Session expired" / stale
Mcp-Session-Id— just re-sendinitialize; stateless clients can ignore session headers entirely. - Streamable HTTP endpoint at mcp.neon.tech/mcp — use
--transport httpin Claude Code. - run_sql executes real statements — point agents at branches rather than production.
🚀 Neon MCP リモートMCPへの接続方法
- リモートエンドポイントを取得 — 公式エンドポイント https://mcp.neon.tech/mcp をコピーします。
- クライアント設定に追加 — Cursor の mcp.json / Claude Code CLI / 各クライアントに URLを追加します(下記クライアント別ガイド参照)。
- 認可して検証 — ブラウザで OAuth 認可を完了後、当サイトの Inspector で initialize と tools/list を実行して接続を確認します。
🔌 Neon × クライアント別MCP接続ガイド
❓ よくある質問
Neon MCP のリモートMCPサーバーは公式ですか?
このエントリは「公式運営」と表示されています。エンドポイントは Neon 公式が運営しています。掲載エンドポイントはすべて実際の MCP initialize ハンドシェイクで検証済みです。
Claude / Cursor で Neon MCP にMCP接続するには?
リモートエンドポイント https://mcp.neon.tech/mcp をコピーします。Claude Code では claude mcp add --transport http neon https://mcp.neon.tech/mcp を実行。Cursor ではワンクリック deeplink か ~/.cursor/mcp.json に { "mcpServers": { "neon": { "url": "https://mcp.neon.tech/mcp" } } } を追加します。初回呼び出し時に OAuth 2.1 の認可画面が自動で開きます。
接続時に 401 が返る/キーを要求される場合は?
401 は OAuth 2.1 による正常なチャレンジです。クライアントが RFC 9728 メタデータに従って自動的に認可を行います。認可が途中で止まる場合は OAuth 2.1 Debugger で PRM / DCR / CORS の設定を確認してください。
ローカル stdio MCP とリモート MCP の違いは?
ローカル MCP は npx / uvx で起動する stdio 子プロセスで、ローカルランタイムが必要で API キーを平文で設定ファイルに書きます。リモート MCP は Neon がホストする HTTPS エンドポイントで、インストール不要・OAuth 2.1 対応・同一 URL をデスクトップとモバイルで共用できます。詳しくは ローカル vs リモート MCP 比較 をご覧ください。