Xata MCP server

MCP-сервер

Подключите Cursor, Claude, VS Code и другие MCP-клиенты к Xata

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

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

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

URL сервера:

https://api.xata.tech/mcp

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

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

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

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

OAuth

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

API-ключ

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

Authorization: Bearer YOUR_XATA_API_KEY

Предупреждение

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

Настройка 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

В качестве альтернативы вы можете добавить его вручную:

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 и следуйте инструкциям в браузере для аутентификации.

Чтобы использовать API-ключ вместо OAuth (например, в 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 (веб и настольная версия)

Совет

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

<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 как пользовательский коннектор вручную:

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

Примечание

Пользовательские коннекторы с удалённым 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

Примечание

Команда 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 предложит вам пройти аутентификацию на сервере с помощью стандартного процесса MCP OAuth.

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"
    }
  }
}

Примечание

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

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

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

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

Обратитесь к документации вашего клиента, чтобы узнать, где настроить удалённые MCP-серверы, и используйте https://api.xata.tech/mcp в качестве URL.

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

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

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

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

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

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

Инструмент	Описание
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.

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

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

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