Xata MCP server

公式

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

xata.io で表示このMCPを試すスポンサー

Xata MCPで何ができますか？

Xata API操作の検出 — アシスタントにsearch_operationsを使ってブランチの一覧表示やメンバーの招待を行うREST API操作を探してもらいます。
操作詳細の確認 — describe_operationを使って任意のXata API操作のパラメータ、リクエスト/レスポンススキーマを取得します。
読み取り専用操作の実行 — call_read_operationを使ってブランチの一覧表示などの安全な読み取り専用Xata REST API呼び出しを実行します。
SQLクエリの実行 — run_sqlでブランチからデータをクエリします。明示的に確認された場合には書き込み操作も含みます。
データベーススキーマの探索 — describe_schemaを使って任意のブランチのテーブルとカラムを一覧表示します。
Xataドキュメントの検索 — search_xataまたはlist_skillsを使って関連ドキュメントやガイド付きワークフローを見つけます。

ドキュメント

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

警告

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

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

Cursor

ヒント

CursorはクイックOAuthセットアップ用のディープリンクを提供しています：

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=xata&config=eyJ1cmwiOiJodHRwczovL2FwaS54YXRhLnRlY2gvbWNwIn0%3D" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', backgroundColor: '#111111', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}>

<span style={{ color: '#ffffff' }}>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（ウェブおよびデスクトップ）

ヒント

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

<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Xata&connectorUrl=https%3A%2F%2Fapi.xata.tech%2Fmcp" style={{ display: 'inline-flex', alignItems: 'center', padding: '8px 12px', backgroundColor: '#735adc', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}> <span style={{ color: '#ffffff' }}>XataをClaudeに接続

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

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

設定 → コネクタに移動します。
カスタムコネクタを追加をクリックします。
サーバーURLとしてhttps://api.xata.tech/mcpを入力し、追加をクリックします。
プロンプトに従ってXataアカウントでサインインします。

注記

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

ChatGPT

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

ChatGPTで、設定 → コネクタ → 詳細設定に移動し、開発者モードを有効にします。
コネクタタブで、サーバーURLを使用して新しいコネクタを作成します：

https://api.xata.tech/mcp

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

Codex CLI

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

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

注記

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マネージャーで、xataの認証を使用し、プロンプトに従って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（ハンマー）アイコンをクリックして、設定をクリックし、生の設定ファイル（~/.codeium/windsurf/mcp_config.json）を開きます。
Xataサーバーエントリを追加します：

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

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

Zed

設定 → AI → MCPサーバーを開き、サーバーを追加 → リモートサーバーを追加をクリックするか、設定ファイルを直接編集します：

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

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

Cline

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

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

注記

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

その他のMCPクライアント

以下の条件をサポートする任意のMCPクライアントが接続できます：

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

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

接続の確認

接続後、アシスタントに次のように尋ねてください：

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

アシスタントはsearch_operationsを{"query":"list branches"}とともに呼び出し、call_read_operationを介して呼び出せるlistBranches操作を返すはずです。これが機能すれば、接続は正常です。

利用可能なツール

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フローをトリガーします。

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

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

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