Xata MCP server

MCP Server

Подключите Cursor, Claude, VS Code и другие MCP-клиенты к организациям, проектам и веткам Xata

Сервер Xata MCP позволяет ИИ-ассистентам и агентам взаимодействовать с вашими организациями, проектами и ветками Xata с помощью Model Context Protocol (MCP).

Что такое сервер Xata MCP?

• Размещённый сервер MCP, работающий вместе с API Xata — ничего не нужно устанавливать или запускать локально.
• Аутентификация через OAuth в браузере или с помощью ключа API Xata в средах без графического интерфейса.
• Доступен из любого MCP-клиента, поддерживающего удалённые серверы через Streamable HTTP.

URL сервера:

https://api.xata.tech/mcp

Сервер использует транспорт Streamable HTTP. Конечной точки SSE и локальной версии сервера (npm) нет.

Аутентификация

Сервер MCP поддерживает два способа аутентификации:

Способ	Когда использовать	Требования к клиенту
OAuth	Интерактивная работа в редакторе или чате	Поддержка OAuth для MCP (динамическая регистрация клиента)
Ключ API	Автоматизация, CI, агенты без графического интерфейса	Поддержка пользовательских HTTP-заголовков

OAuth

Для клиентов с поддержкой OAuth достаточно URL сервера. При первом подключении клиент регистрируется в Xata, открывает окно браузера и предлагает войти в аккаунт Xata и подтвердить доступ. Срок действия токенов ограничен, и они имеют область действия, ограниченную сервером MCP.

Ключ API

Клиенты, поддерживающие пользовательские заголовки, могут вместо этого использовать ключ API Xata для аутентификации:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Создайте отдельный ключ API для доступа к MCP, а не используйте повторно существующий ключ. Храните его в переменной среды или в хранилище секретов клиента — никогда не добавляйте его в систему контроля версий.

Настройка MCP-клиента

Cursor

[!TIP]

В Cursor есть прямая ссылка для быстрой настройки OAuth:

Добавить в Cursor

Также можно добавить сервер вручную:

1. Откройте палитру команд и найдите «Cursor Settings».
2. В разделе Tools & MCP нажмите New MCP Server.
3. Добавьте сервер Xata в открывшийся файл конфигурации:

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

4. Сохраните файл. 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

Для работы серверов MCP в VS Code требуются расширения GitHub Copilot и GitHub Copilot Chat.

1. Откройте палитру команд (Cmd+Shift+P / Ctrl+Shift+P).
2. Выполните команду MCP: Add Server и выберите HTTP.
3. Введите https://api.xata.tech/mcp в качестве URL и xata в качестве имени.

Также можно добавить сервер в конфигурацию вручную:

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

Запустите сервер из меню MCP: List Servers и разрешите аутентификацию, когда появится запрос.

Claude (веб-версия и приложение для компьютера)

[!TIP]

Откройте диалог настройки пользовательского коннектора Claude с уже заполненными данными Xata:

Подключить Xata к Claude

Проверьте и подтвердите коннектор в Claude, затем пройдите аутентификацию в Xata.

Также можно добавить Xata вручную как пользовательский коннектор:

1. Перейдите в Settings → Connectors.
2. Нажмите Add custom connector.
3. Введите https://api.xata.tech/mcp в качестве URL сервера и нажмите Add.
4. Следуйте инструкциям, чтобы войти в аккаунт Xata.

[!NOTE]

Пользовательские коннекторы с удалённым MCP доступны не во всех тарифных планах Claude; для командных планов может потребоваться, чтобы их добавил владелец организации. Подробности см. в документации Claude.

ChatGPT

Подключите ChatGPT к Xata с помощью пользовательского коннектора:

1. В ChatGPT перейдите в Settings → Connectors → Advanced settings и включите Developer mode.
2. На вкладке Connectors создайте новый коннектор, указав URL сервера:

https://api.xata.tech/mcp

3. Выберите OAuth для аутентификации и выполните процедуру авторизации, когда появится запрос.
4. В каждом чате, где вы хотите использовать Xata, нажмите кнопку + и включите коннектор Xata в разделе Add sources.

Codex CLI

Добавьте сервер Xata:

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

[!NOTE]

Команда add может открыть браузер и сообщить об ошибке OAuth. Если это произойдёт, выполните приведённую ниже команду входа; запись сервера xata уже сохранена.

Пройдите аутентификацию в Xata, указав области OAuth явно:

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

Завершите авторизацию в браузере. Область offline_access позволяет Codex обновлять сеанс Xata без повторной авторизации в браузере.

Затем запустите codex, выполните /mcp и убедитесь, что xata подключён и прошёл аутентификацию.

Antigravity CLI

Добавьте Xata в глобальную конфигурацию MCP:

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

Чтобы включить Xata только для одного проекта, используйте .agents/mcp_config.json в корневом каталоге этого проекта.

Запустите agy и введите /mcp. В MCP Manager нажмите Authenticate для xata и следуйте инструкциям, чтобы завершить OAuth-аутентификацию.

OpenCode

Добавьте сервер Xata в файл конфигурации OpenCode:

{
  "$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

1. В Windsurf откройте панель Cascade и нажмите значок MCP (молоток), затем Configure, чтобы открыть файл конфигурации в текстовом виде (~/.codeium/windsurf/mcp_config.json).
2. Добавьте запись сервера Xata:

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

3. Сохраните файл и нажмите Refresh на боковой панели Cascade. Завершите процедуру OAuth, когда откроется окно браузера.

Zed

1. Откройте Settings → AI → MCP Servers и нажмите Add Server → Add Remote Server либо отредактируйте файл настроек напрямую:

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

2. Zed предложит пройти аутентификацию на сервере с помощью стандартной процедуры OAuth для MCP.

Cline

1. Откройте Cline в VS Code и нажмите значок MCP Servers.
2. На вкладке Remote Servers введите xata в качестве имени, https://api.xata.tech/mcp в качестве URL и выберите Streamable HTTP в качестве транспорта. Либо отредактируйте JSON конфигурации напрямую:

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

[!NOTE]

Тип транспорта должен быть streamableHttp (camelCase). Если его не указать, Cline переключится на устаревший транспорт SSE, который сервер Xata MCP не поддерживает.

Другие MCP-клиенты

Подключиться можно из любого MCP-клиента, поддерживающего:

• Удалённые серверы MCP через Streamable HTTP (не SSE)
• OAuth с динамической регистрацией клиента или пользовательские HTTP-заголовки для аутентификации с помощью ключа API

Инструкции по настройке удалённых серверов MCP см. в документации клиента. В качестве URL используйте https://api.xata.tech/mcp.

Проверка подключения

После подключения попросите ассистента:

Используй сервер Xata MCP, чтобы найти операцию REST API для получения списка веток.

Ассистент должен вызвать search_operations с {"query":"list branches"} и вернуть операцию listBranches, которую можно вызвать через call_read_operation. Если это произошло, подключение работает.

Доступные инструменты

Сервер Xata MCP предоставляет следующие инструменты:

Инструмент	Описание
search_operations	Найти операцию REST API Xata по назначению (например, «получить список веток» или «пригласить участника»).
describe_operation	Вернуть параметры и схемы запросов и ответов для конкретной операции.
call_read_operation	Вызвать операцию REST API Xata только для чтения.
call_write_operation	Вызвать операцию REST API Xata, которая создаёт или обновляет данные.
call_destructive_operation	Вызвать операцию REST API Xata, которая удаляет данные или отзывает доступ. Требуется 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-клиенте сохранена регистрация OAuth, которая больше недоступна на сервере аутентификации Xata. В зависимости от клиента удаление и повторное добавление сервера MCP может не удалить эту регистрацию. Удалите сохранённую регистрацию OAuth для Xata в клиенте, затем перезапустите сервер Xata MCP и пройдите аутентификацию снова, чтобы создать новую регистрацию.

Например, в VS Code:

1. Откройте палитру команд (Cmd+Shift+P / Ctrl+Shift+P).
2. Выполните команду Authentication: Remove Dynamic Authentication Providers.
3. Выберите провайдер, связанный с Xata, не изменяя остальные провайдеры.
4. Перезапустите сервер Xata MCP и пройдите аутентификацию снова.

Сервер подключается, но инструменты не отображаются. Убедитесь, что вы завершили аутентификацию: для отображения большинства инструментов требуется действительный сеанс. Повторно пройдите процедуру аутентификации клиента, затем обновите список инструментов. Полный список см. в разделе Доступные инструменты.

Клиент вообще не может подключиться. Убедитесь, что URL точно совпадает с https://api.xata.tech/mcp и клиент поддерживает Streamable HTTP. Клиенты, поддерживающие только SSE, не поддерживаются.

Сервер не отображается в клиенте. Проверьте синтаксис файла конфигурации MCP клиента — структура JSON различается в разных клиентах (mcpServers vs servers vs context_servers, url vs serverUrl) — и проверьте журналы клиента. После изменения конфигурации большинству клиентов требуется полный перезапуск.

Эта документация создана и размещена на Mintlify, платформе для документации разработчиков.