Как подключить Softr к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Softr, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Softr + Gemini

Дайте ИИ работать с Softr: просматривать Softr Databases, таблицы и поля, выводить, искать и читать записи; после вашего подтверждения создавать и обновлять записи, добавлять пользователей в приложение Softr и создавать magic link для входа.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

SOFTR_API_KEY

Шаг 1 — Получите учётные данные

1. В Softr Studio нажмите на название своего workspace слева вверху, откройте API tokens и создайте токен кнопкой Create. Задайте ему имя и срок действия.
2. Выберите для каждого workspace, что разрешено токену: доступ к Databases с правом View only для чтения или Edit data, если ИИ должен создавать и обновлять записи; для инструментов работы с пользователями приложения добавьте доступ к Applications.
3. Скопируйте токен в SOFTR_API_KEY. Softr показывает его только один раз.
4. Необязательно, для инструментов работы с пользователями приложения: укажите в SOFTR_DOMAIN адрес опубликованного приложения Softr, к которому относятся пользователи, например yourapp.softr.app или ваш собственный домен, без https://. Без него инструменты для баз данных работают, а инструменты для пользователей приложения нет.
5. Установите коннектор и проверьте его с помощью softr_list_databases: он показывает базы данных, доступные токену.

Только Softr Databases: коннектор работает с базами данных, созданными в Softr. Airtable, Google Sheets и другие источники, подключённые к приложению Softr, через этот API недоступны.

Что он читает: ваши базы данных; их таблицы со всеми полями, типом каждого поля, признаком обязательности и вариантами выбора; записи таблицы постранично, так, как их показывает представление, или через поиск с фильтром и сортировкой; и отдельную запись по её id. При чтении возвращаются названия полей, поэтому ответы легко понять.

Id полей для записи: для создания и обновления записей, а также для фильтров и сортировки при поиске нужны id полей из softr_list_tables, а не названия. ИИ сначала находит их.

Спрашивает перед каждой записью: softr_create_record, softr_update_record, softr_create_app_user и softr_generate_magic_link меняют данные или дают доступ. Перед каждым вызовом ИИ показывает таблицу и все значения, запись и точные изменения или имя и e-mail человека и ждёт вашего согласия. Приложения, построенные на этой таблице, сразу показывают изменения; поля, которые не указаны, сохраняют своё значение.

Magic link выполняет вход от имени этого человека: ссылка открывает приложение Softr от имени этого пользователя без пароля. ИИ передаёт её только вам, для этого человека, и никогда не публикует в открытом доступе. Новый пользователь приложения может войти и видит то, что разрешают его группы пользователей.

Отключены при установке: softr_delete_record и softr_delete_app_user. Администратор включает их осознанно; тогда ИИ удаляет только ту запись или того человека, которых вы назвали, и только после вашего подтверждения. Более мягкий вариант: деактивировать пользователя в Softr Studio.

Персональные данные: приложения Softr часто являются клиентскими порталами и внутренними инструментами с данными о клиентах, сотрудниках и заказах. ИИ показывает только то, что вам нужно, и воспринимает текст в записях как данные, а не как инструкции.

Лимиты: около 40 чтений и 30 записей в секунду на токен. Для некоторых эндпоинтов может понадобиться более высокий тариф Softr.

Частые ошибки: 401: токен неверный, истёк или удалён; создайте новый в разделе API tokens. 403: токену это не разрешено; дайте ему Edit data для записи или доступ к Applications для инструментов работы с пользователями приложения. 402 QUOTA_EXCEEDED: достигнут лимит тарифа или эндпоинт требует более высокого тарифа.

Коннектор не создаёт и не меняет базы данных, таблицы, поля и представления, не выводит список пользователей приложения (в API Softr такого вызова нет) и не управляет группами пользователей, страницами приложения и рабочими процессами.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Softr.

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

Примеры запросов

• «Какие базы данных и таблицы Softr ты видишь?»
• «Покажи открытые заявки в нашем клиентском портале за эту неделю, сначала самые новые.»
• «Найди запись клиента Northwind GmbH и скажи, какой у них тариф и дата продления.»
• «Поменяй статус заявки от Anna Weber на «В работе». Сначала покажи изменение.»
• «Добавь Marco Rossi, [email protected], как пользователя нашего партнёрского портала и создай для него magic link.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT