Xata MCP server

Перейти к основному содержанию

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

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

• Размещённый MCP-сервер, работающий параллельно с Xata API — ничего не нужно устанавливать или запускать локально.
• Аутентификация через 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:

Authorization: Bearer YOUR_XATA_API_KEY

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

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

​Cursor

Cursor предлагает глубокую ссылку для быстрой настройки OAuth:Добавить в Cursor

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

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

.cursor/mcp.json

{
  "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 как имя.

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

.vscode/mcp.json

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

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

​Claude (веб и десктоп)

Добавьте 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:

~/.gemini/config/mcp_config.json

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

Чтобы включить Xata только для одного проекта, используйте .agents/mcp_config.json в корне этого проекта. Запустите agy и введите /mcp. В MCP Manager используйте Authenticate для xata и следуйте подсказкам для завершения OAuth.

​OpenCode

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

~/.config/opencode/opencode.json

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

~/.codeium/windsurf/mcp_config.json

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

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

​Zed

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

settings.json

{
  "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, который Xata MCP-сервер не поддерживает.

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

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

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

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

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

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

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

Ассистент должен вызвать инструмент user_info и вернуть вашу пользовательскую идентификацию (или идентификацию API-ключа, если вы аутентифицировались с ключом). Если это так, подключение работает.

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

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

Инструмент	Описание
user_info	Возвращает идентификацию аутентифицированного вызывающего — ваш ID пользователя и email для OAuth или ID API-ключа.
search_operations	Находит операцию Xata REST API по намерению (например, «list branches» или «invite member»).
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, чтобы выполнить операторы, изменяющие данные.
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. Проверяйте действия, предлагаемые ассистентом, перед их одобрением и сохраняйте участие человека для любых операций записи или удаления.

​Устранение неполадок

Аутентификация постоянно не удаётся или зацикливается. Удалите сервер Xata из клиента, перезапустите клиент и добавьте сервер снова, чтобы запустить новый процесс OAuth. Сервер подключается, но инструменты не отображаются. Убедитесь, что вы завершили шаг аутентификации — большинство инструментов требуют действительную сессию для отображения. Повторно выполните процесс аутентификации клиента, затем обновите список инструментов. Полный набор см. в разделе Доступные инструменты. Ваш клиент вообще не может подключиться. Убедитесь, что URL точно https://api.xata.tech/mcp и что ваш клиент поддерживает Streamable HTTP. Клиенты, поддерживающие только SSE, не поддерживаются. Сервер не отображается в клиенте. Проверьте синтаксис файла конфигурации MCP клиента — форма JSON различается в зависимости от клиента (mcpServers против servers против context_servers, url против serverUrl) — и проверьте логи клиента. Большинству клиентов требуется полный перезапуск после изменений конфигурации.

Была ли эта страница полезной?

Назад

Организации

Далее