Baserow

Baserow MCP

Подключите своего ИИ-агента к Baserow. Ваш агент сможет читать и изменять таблицы в одном рабочем пространстве Baserow, используя только те инструменты, которые вы разрешите при входе.

Этот репозиторий устанавливает MCP-сервер Baserow и короткий навык, который обучает агента его использованию. Он работает с Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi и другими агентами.

URL сервера

• baserow.io: https://api.baserow.io/mcp
• Self-hosted: URL вашего бэкенда, за которым следует /mcp, например https://baserow.example.com/mcp. Скопируйте его из раздела «Мои настройки» → «MCP-сервер» в Baserow.

Примеры ниже используют URL baserow.io. На self-hosted Baserow используйте свой собственный URL.

Быстрый старт

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp находит установленных агентов и спрашивает, к каким добавить Baserow. Снимите флажок с Claude Desktop, если он указан, и добавьте Baserow туда как пользовательский коннектор. skills add копирует навык baserow-basics в папки навыков ваших агентов. На self-hosted Baserow также запустите skills add, поскольку только плагины ниже включают навык.

Требования для self-hosted

• Версия Baserow новее 2.4.1. В более старых версиях нет /mcp или входа; используйте ключ конечной точки.
• BASEROW_MCP_OAUTH_ENABLED=true на бэкенде. По умолчанию выключен.
• Публичный HTTPS URL бэкенда, чтобы размещённые приложения, такие как Claude.ai и ChatGPT, могли его достичь, а также исходящий HTTPS с бэкенда, который получает метаданные клиентов приложений.
• Ваш обратный прокси отправляет /mcp и пути под /mcp/, /oauth/, /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource на бэкенд. Сопоставляйте /mcp точно, а не как префикс: фронтенд обслуживает страницу входа по адресу /mcp-authorize/.

См. MCP OAuth вход для self-hosted Baserow.

Установка для каждого агента

Агент	baserow.io	Self-hosted
Claude Code	Плагин	Тот же плагин, введите свой URL при запросе
Claude.ai, Claude Desktop	Пользовательский коннектор	То же, с вашим URL
ChatGPT	Пользовательский MCP-сервер	То же, с вашим URL
Codex	Плагин	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Плагин	Только сервер
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Добавить в Cursor	Файл конфигурации
VS Code	Добавить в VS Code	Файл конфигурации
Goose	Добавить в Goose	Быстрый старт с вашим URL
OpenCode, Windsurf, Zed	Файл конфигурации	То же, с вашим URL
Любой другой агент	Быстрый старт	То же, с вашим URL

Плагины Codex, Copilot и Gemini, а также кнопки «Добавить» всегда указывают на baserow.io, поэтому на self-hosted Baserow добавляйте только сервер для этих агентов.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

Когда он запросит URL, нажмите Esc, чтобы оставить baserow.io, или введите свой self-hosted URL. Чтобы изменить его позже, запустите /plugin configure baserow@baserow.

Claude.ai и Claude Desktop

Настройка → Коннекторы → + Добавить → Добавить пользовательский коннектор. Назовите его Baserow и введите URL вашего сервера. На планах Team и Enterprise владелец добавляет его в разделе «Настройки организации» → «Коннекторы».

ChatGPT

Откройте «Плагины», выберите кнопку «плюс», затем «Добавить пользовательский MCP-сервер» и введите URL вашего сервера. Названия меню часто меняются. На планах Business и Enterprise администратор должен сначала разрешить пользовательские MCP-серверы.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

На self-hosted Baserow добавьте только сервер: copilot mcp add --transport http baserow <your url>. Если плагин установлен, сначала удалите его с помощью copilot plugin uninstall baserow; его сервер заменяет ваш без предупреждения.

Файлы конфигурации

Чтобы добавить только сервер, без плагина:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, затем opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, настройки:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

Вход

Ваш агент открывает страницу Baserow в вашем браузере. Войдите, выберите рабочее пространство и отметьте инструменты, которые агент может использовать. Инструменты чтения позволяют агенту просматривать базы данных, таблицы и строки; инструменты записи позволяют создавать, обновлять и удалять строки. При первом подключении отмечены только инструменты чтения.

Где начинается вход:

• Claude Code: запустите /mcp, выберите plugin:baserow:baserow и пройдите аутентификацию.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor и VS Code: кнопка «Подключить» или «Войти» рядом с сервером.

Чтобы изменить рабочее пространство или инструменты, войдите снова: повторно пройдите аутентификацию сервера в вашем агенте или отключите приложение в разделе «Мои настройки» → «MCP-сервер» в Baserow и подключитесь снова. Обычное повторное подключение сохраняет старый вход.

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

• Инструмент отсутствует, или базы данных не перечислены. Подключение имеет только то рабочее пространство и инструменты, которые вы выбрали при входе. Войдите снова, как описано выше. Инструменты, изменяющие таблицы или поля, недоступны через MCP.
• Вход не начинается, или клиент сообщает, что сервер не поддерживает OAuth или регистрацию клиентов. На self-hosted Baserow проверьте требования для self-hosted.
• Подключение не удаётся с введённым вами URL. Скопируйте URL точно так, как его показывает раздел «Мои настройки» → «MCP-сервер». Он заканчивается на /mcp, без завершающего слэша.
• Два сервера Baserow в Claude Code. Если claude mcp list показывает plugin:baserow:baserow плагина и сервер baserow, добавленный вами вручную, оставьте тот, который подключается. claude plugin disable baserow@baserow отключает сервер плагина; claude mcp remove baserow удаляет ваш.

Ключи конечных точек

Baserow 2.4.1 и старше принимает только ключ конечной точки, и плагин этого не настраивает. Скопируйте URL конечной точки из раздела «Мои настройки» → «MCP-сервер». Он заканчивается на /sse и содержит ваш ключ. Добавьте его вручную к агенту, поддерживающему SSE-серверы, например Claude Code, Cursor или VS Code; Codex и Goose не поддерживают:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Новые версии также принимают ключ как заголовок на /mcp, что полезно для скриптов:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

Ключ даёт полный доступ к своему рабочему пространству. -g записывает его в ваш пользовательский конфиг, а не в текущую папку, чтобы он не попал в коммит.

Конфиденциальность и поддержка

• Политика конфиденциальности: https://baserow.io/privacy-policy
• Условия: https://baserow.io/terms-and-conditions
• Помощь: форум сообщества или свяжитесь с нами

Разработка

В scripts/ запустите npm install, затем npm test и npm run check. CI выполняет те же проверки. Инструменты находятся там, чтобы установка плагинов не устанавливала их зависимости.

Плагин Claude Code объявляет свой сервер в .claude-plugin/plugin.json, поэтому он может использовать введённый вами URL. .mcp.json содержит URL baserow.io для других инструментов, которые читают плагины в формате Claude, таких как GitHub Copilot CLI и Cursor.

Лицензия

MIT