Xata MCP server

公式

Xata MCPサーバーを使用すると、AIアシスタントやエージェントがXataの組織、プロジェクト、Postgresデータベースブランチと対話できます。

xata.io で表示

Xata MCPで何ができますか？

API 操作を検索 — ブランチの一覧表示やメンバーの招待など、目的に応じて Xata REST API の操作をアシスタントに探させます。
操作スキーマを確認 — 特定の Xata API 操作を呼び出す前に、そのパラメータとリクエスト/レスポンスのスキーマを取得します。
読み取り専用の API 呼び出しを実行 — ブランチの一覧表示など、読み取り専用の Xata REST API 操作をアシスタント経由で呼び出します。
SQL でブランチをクエリ — ブランチに対して SQL を実行します。デフォルトでは読み取り専用で、書き込みには明示的な確認が必要です。
ブランチスキーマを探索 — ブランチのテーブルとカラムを一覧表示して、その構造を把握します。
Xata ドキュメントを検索 — Xata のドキュメントを検索したり、パスを指定して特定のドキュメントページを読み取ります。

ドキュメント

MCPサーバー

Cursor、Claude、VS Code、その他のMCPクライアントをXataに接続します

Xata MCPサーバーを使用すると、AIアシスタントやエージェントがModel Context Protocol（MCP）を通じて、Xataの組織、プロジェクト、ブランチとやり取りできます。

Xata MCPサーバーとは？

Xata APIと並行して動作するホスト型MCPサーバーです。ローカルにインストールしたり実行したりする必要はありません。
ブラウザでのOAuth、またはヘッドレス環境向けのXata APIキーで認証します。
Streamable HTTP経由でリモートサーバーをサポートする任意のMCPクライアントからアクセスできます。

サーバーURL:

https://api.xata.tech/mcp

このサーバーはStreamable HTTPトランスポートを使用します。SSEエンドポイントやローカル（npm）版のサーバーはありません。

認証

MCPサーバーは2つの認証方法をサポートしています：

方法	使用する場面	クライアントの要件
OAuth	エディタ/チャットでの対話的な使用	MCP OAuth（動的クライアント登録）のサポート
APIキー	自動化、CI、ヘッドレスエージェント	カスタムHTTPヘッダーのサポート

OAuth

OAuth対応クライアントでは、サーバーURLのみが必要です。クライアントが初めて接続すると、Xataに自身を登録し、ブラウザウィンドウを開いて、Xataアカウントへのサインインとアクセスの承認を求めます。トークンは短命で、MCPサーバーにスコープが限定されます。

APIキー

カスタムヘッダーをサポートするクライアントは、代わりにXata APIキーで認証できます：

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

MCPアクセス用には、既存のキーを再利用するのではなく専用のAPIキーを作成してください。環境変数またはクライアントのシークレットストレージに保存し、ソース管理にコミットしないでください。

MCPクライアントのセットアップ

Cursor

[!TIP]

CursorはOAuthをすばやくセットアップするためのディープリンクを提供しています：

Add to Cursor

または、手動で追加することもできます：

コマンドパレットを開き、「Cursor Settings」を検索します。
Tools & MCPで、New MCP Serverをクリックします。
開いた設定ファイルにXataサーバーを追加します：

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

ファイルを保存します。Cursorが認証を促すので、ブラウザのフローに従ってXataアカウントへのアクセスを承認します。

Claude Code

ターミナルからサーバーを追加します：

claude mcp add --transport http xata https://api.xata.tech/mcp

次にClaude Codeを起動し、/mcpスラッシュコマンドを実行します。xataサーバーを選択し、ブラウザの指示に従って認証します。

OAuthの代わりにAPIキーを使用する場合（たとえばCIで）：

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

VS CodeのMCPサーバーには、GitHub CopilotおよびGitHub Copilot Chat拡張機能が必要です。

コマンドパレットを開きます（Cmd+Shift+P / Ctrl+Shift+P）。
MCP: Add Serverを実行し、HTTPを選択します。
URLとしてhttps://api.xata.tech/mcpを、名前としてxataを入力します。

または、設定に手動で追加することもできます：

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

MCP: List Serversからサーバーを起動し、プロンプトが表示されたら認証を許可します。

Claude（Webおよびデスクトップ）

[!TIP]

Xataの詳細が事前入力されたClaudeのカスタムコネクタダイアログを開きます：

Connect Xata to Claude

Claudeでコネクタを確認して確定し、Xataで認証します。

または、Xataをカスタムコネクタとして手動で追加することもできます：

Settings → Connectorsに移動します。
Add custom connectorをクリックします。
サーバーURLとしてhttps://api.xata.tech/mcpを入力し、Addをクリックします。
プロンプトに従ってXataアカウントでサインインします。

[!NOTE]

リモートMCPを使用するカスタムコネクタは、すべてのClaudeプランで利用できるわけではなく、チームプランでは組織のオーナーが追加する必要がある場合があります。詳細はClaudeのドキュメントを参照してください。

ChatGPT

カスタムコネクタを使用してChatGPTをXataに接続します：

ChatGPTで、Settings → Connectors → Advanced settingsに移動し、Developer modeを有効にします。
Connectorsタブで、サーバーURLを指定して新しいコネクタを作成します：

https://api.xata.tech/mcp

認証方法としてOAuthを選択し、プロンプトが表示されたら認可フローを完了します。
Xataを使用したい各チャットで、**+**ボタンをクリックし、Add sourcesの下でXataコネクタを有効にします。

Codex CLI

Xataサーバーを追加します：

codex mcp add xata --url https://api.xata.tech/mcp

[!NOTE]

addコマンドはブラウザを開き、OAuthエラーを報告する場合があります。その場合は、以下のログインコマンドを続行してください。xataサーバーエントリはすでに保存されています。

明示的なOAuthスコープを使用してXataで認証します：

codex mcp login xata --scopes mcp-client,offline_access

ブラウザで認可を完了します。offline_accessスコープにより、Codexは別のブラウザ認可を必要とせずにXataセッションを更新できます。

次にcodexを起動し、/mcpを実行して、xataが接続され認証されていることを確認します。

Antigravity CLI

グローバルMCP設定にXataを追加します：

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Xataを1つのプロジェクトでのみ有効にするには、代わりにそのプロジェクトのルートで.agents/mcp_config.jsonを使用します。

agyを起動し、/mcpを入力します。MCP Managerで、xataに対してAuthenticateを使用し、プロンプトに従ってOAuthを完了します。

OpenCode

OpenCodeの設定ファイルにXataサーバーを追加します：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

次にターミナルから認証します：

opencode mcp auth xata

Amp

ターミナルからサーバーを追加します：

amp mcp add xata https://api.xata.tech/mcp

次にampを起動します。ブラウザで認証を求められるはずです。/mcp list toolsを実行して、サーバーが接続されていることを確認します。

Windsurf

WindsurfでCascadeパネルを開き、MCP（ハンマー）アイコンをクリックし、Configureをクリックして生の設定ファイル（~/.codeium/windsurf/mcp_config.json）を開きます。
Xataサーバーエントリを追加します：

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

ファイルを保存し、CascadeサイドバーでRefreshをクリックします。ブラウザウィンドウが開いたらOAuthフローを完了します。

Zed

Settings → AI → MCP Serversを開き、Add Server → Add Remote Serverをクリックするか、設定ファイルを直接編集します：

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Zedは標準のMCP OAuthフローを使用してサーバーに対する認証を促します。

Cline

VS CodeでClineを開き、MCP Serversアイコンをクリックします。
Remote Serversタブで、名前としてxataを、URLとしてhttps://api.xata.tech/mcpを入力し、トランスポートとしてStreamable HTTPを選択します。または、設定JSONを直接編集します：

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

[!NOTE]

トランスポートタイプはstreamableHttp（キャメルケース）である必要があります。省略すると、ClineはレガシーSSEトランスポートにフォールバックしますが、Xata MCPサーバーはこれをサポートしていません。

その他のMCPクライアント

以下の機能をサポートするMCPクライアントであれば接続できます：

Streamable HTTP経由のリモートMCPサーバー（SSEではない）
動的クライアント登録を伴うOAuth、またはAPIキー認証用のカスタムHTTPヘッダー

リモートMCPサーバーを設定する場所については、お使いのクライアントのドキュメントを参照し、URLとしてhttps://api.xata.tech/mcpを使用してください。

接続の確認

接続後、アシスタントに次のように尋ねます：

Xata MCPサーバーを使用して、ブランチを一覧表示するREST APIオペレーションを見つけてください。

アシスタントは{"query":"list branches"}を指定してsearch_operationsを呼び出し、listBranchesオペレーションを返すはずです。このオペレーションはcall_read_operationを通じて呼び出すことができます。そうなれば、接続は正常に機能しています。

利用可能なツール

Xata MCPサーバーは以下のツールを公開しています：

ツール	説明
`search_operations`	意図（たとえば「ブランチを一覧表示」や「メンバーを招待」）に基づいてXata REST APIオペレーションを見つけます。
`describe_operation`	特定のオペレーションのパラメータとリクエスト/レスポンススキーマを返します。
`call_read_operation`	読み取り専用のXata REST APIオペレーションを呼び出します。
`call_write_operation`	データを作成または更新するXata REST APIオペレーションを呼び出します。
`call_destructive_operation`	データを破壊したりアクセスを取り消したりするXata REST APIオペレーションを呼び出します。`confirm=true`が必要です。
`run_sql`	ブランチに対してSQLを実行します。デフォルトでは読み取り専用で、データを変更するステートメントには`write=true`と`confirm=true`の両方が必要です。
`describe_schema`	ブランチのテーブルとカラムを一覧表示します。
`list_skills`	利用可能なXataスキル（一般的な複数ステップのタスク向けのガイド付きワークフロー）を一覧表示します。
`get_skill`	特定のスキルの手順を読み取ります。
`search_xata`	Xataのドキュメントを検索します。
`query_docs_filesystem_xata`	パスを指定してXataのドキュメントページを読み取ります。

セキュリティ

対話的なクライアントにはOAuthを推奨します。トークンは短命で、クライアントでサーバーを切断することで取り消すことができます。
自動化には、専用のAPIキーを使用し、定期的にローテーションしてください。
一部のツールはデータを変更できます：call_write_operationとcall_destructive_operationはリソースを変更または削除でき（後者にはconfirm=trueが必要）、run_sqlはwrite=trueとconfirm=trueの両方を指定して呼び出すとデータを変更できます。アシスタントが提案するアクションを承認する前に確認し、書き込みや削除については必ず人間を介在させてください。

トラブルシューティング

認証が失敗し続ける、またはループする。 クライアントからXataサーバーを削除し、クライアントを再起動してから、サーバーを再度追加して新しいOAuthフローを開始してください。

ブラウザで認証時に「Client not found」と表示される。 MCPクライアントに、Xataの認証サーバーで利用できなくなったOAuth登録が保存されている可能性があります。クライアントによっては、MCPサーバーを削除して再追加してもこの登録が残ることがあります。クライアントでXataの保存済みOAuth登録をクリアし、Xata MCPサーバーを再起動して再度認証し、新しい登録を許可してください。

たとえば、VS Codeでは：

コマンドパレットを開きます（Cmd+Shift+P / Ctrl+Shift+P）。
Authentication: Remove Dynamic Authentication Providersを実行します。
Xataに関連するプロバイダーを選択し、無関係なプロバイダーは変更しないでください。
Xata MCPサーバーを再起動し、認証を再度完了します。

サーバーには接続するが、ツールが表示されない。 認証ステップを完了したことを確認してください。ほとんどのツールは、表示される前に有効なセッションを必要とします。クライアントの認証フローを再実行し、ツールリストを更新してください。全ツールの一覧については利用可能なツールを参照してください。

クライアントがまったく接続できない。 URLが正確にhttps://api.xata.tech/mcpであること、およびクライアントがStreamable HTTPをサポートしていることを確認してください。SSE専用のクライアントはサポートされていません。

サーバーがクライアントに表示されない。 クライアントのMCP設定ファイルの構文を確認してください。JSONの形式はクライアントによって異なります（mcpServers 対 servers 対 context_servers、url 対 serverUrl）。また、クライアントのログも確認してください。ほとんどのクライアントは、設定変更後に完全な再起動が必要です。

このドキュメントは、開発者向けドキュメントプラットフォームであるMintlify上で構築およびホストされています。