Baserow MCP

Подключите AI-агента к 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

• Самостоятельное размещение: URL вашего backend с добавленным суффиксом /mcp, например https://baserow.example.com/mcp. Скопируйте его в Baserow: My settings → MCP server.

В примерах ниже используется URL baserow.io. Для самостоятельно размещённой версии 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 в папки навыков ваших агентов. При самостоятельном размещении Baserow тоже выполните skills add: инструкцию содержат только плагины, перечисленные ниже.

Требования для самостоятельно размещённой версии

• Версия Baserow новее 2.4.1. В более старых версиях нет /mcp и входа в систему; используйте там ключ endpoint.

• На backend необходимо установить BASEROW_MCP_OAUTH_ENABLED=true. По умолчанию параметр отключён.

• У backend должен быть общедоступный URL с HTTPS, чтобы к нему могли обращаться размещённые в облаке приложения, например Claude.ai и ChatGPT. Backend также должен иметь возможность отправлять исходящие HTTPS-запросы: они используются для получения метаданных клиентов приложений.

• Настройте reverse proxy так, чтобы запросы к /mcp, путям внутри /mcp/ и адресам /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource направлялись на backend. Маршрут должен точно соответствовать /mcp, а не работать как префикс: frontend показывает страницу входа по адресу /mcp-authorize/.

Подробнее см. в разделе Вход через MCP OAuth для самостоятельно размещённой версии Baserow.

Установка для разных агентов

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

Плагины Codex, Copilot и Gemini, а также кнопки добавления всегда подключаются к baserow.io. Поэтому для самостоятельно размещённой версии Baserow добавьте в этих агентах только сервер.

Claude Code

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

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

Claude.ai и Claude Desktop

Откройте Customize → Connectors → + Add → Add custom connector. Назовите коннектор Baserow и укажите URL сервера. В планах Team и Enterprise владелец организации добавляет коннектор в разделе Organization settings → Connectors.

ChatGPT

Откройте Plugins, нажмите кнопку с плюсом, выберите Add custom MCP server и укажите 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

Для самостоятельно размещённой версии Baserow добавьте только сервер: copilot mcp add --transport http baserow . Если плагин уже установлен, сначала удалите его командой 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: нажмите кнопку Connect или Sign in рядом с сервером.

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

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

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

• Вход не начинается или клиент сообщает, что сервер не поддерживает OAuth либо регистрацию клиентов. Для самостоятельно размещённой версии Baserow проверьте требования к настройке.

• Не удаётся подключиться по введённому URL. Скопируйте URL точно так, как он указан в Baserow в разделе My settings → MCP server. URL должен оканчиваться на /mcp; не добавляйте завершающий слеш.

• В Claude Code отображаются два сервера Baserow. Если команда claude mcp list показывает плагин plugin:baserow:baserow и добавленный вручную сервер baserow, оставьте тот, который подключается. Команда claude plugin disable baserow@baserow отключает сервер плагина, а claude mcp remove baserow удаляет добавленный вручную сервер.

Ключи endpoint

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

" -t sse -n baserow -g -a claude-code">

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 сохраняет ключ в пользовательской конфигурации, а не в текущей папке, поэтому он не попадёт в commit.

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

• Политика конфиденциальности: 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