Документация: MCP для AI-агентов

MCP dbsend

Готовый удалённый MCP-сервер (Streamable HTTP) по адресу https://api.dbsend.ru/v1/mcp. Устанавливать сервер на свой компьютер не нужно. Сценарии использования — на странице «Бэкапы через MCP».

Ключ и права

Создайте API-ключ в разделе «API-ключи» и выдайте только необходимые права (scopes). Ключ передаётся в заголовке Authorization: Bearer …, действует только в своём рабочем пространстве и в пределах тарифа. Ключ можно привязать к одной базе и задать срок действия.

Не вставляйте ключ в промты и git

Храните его в переменной окружения DBSEND_API_KEY или локальном хранилище секретов.

Пустой список прав ничего не разрешает

Для чтения достаточно databases.read, backups.read, backups.diff и billing.read.

Claude Code

macOS / Linux

export DBSEND_API_KEY='sqv_pk_…'
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $DBSEND_API_KEY" \
  dbsend https://api.dbsend.ru/v1/mcp

Проверка — команда /mcp внутри Claude Code. Для командной настройки положите в корень проекта .mcp.json; Claude Code подставит переменную окружения, сам ключ не коммитьте:

.mcp.json

{
  "mcpServers": {
    "dbsend": {
      "type": "http",
      "url": "https://api.dbsend.ru/v1/mcp",
      "headers": { "Authorization": "Bearer ${DBSEND_API_KEY}" }
    }
  }
}

Cursor

Добавьте сервер в .cursor/mcp.json проекта или в глобальный ~/.cursor/mcp.json. Cursor подставит значение из переменной окружения DBSEND_API_KEY.

.cursor/mcp.json

{
  "mcpServers": {
    "dbsend": {
      "url": "https://api.dbsend.ru/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:DBSEND_API_KEY}" }
    }
  }
}

После сохранения откройте Settings → MCP и убедитесь, что сервер dbsend включён и видит инструменты.

Codex

Задайте ключ в DBSEND_API_KEY и добавьте сервер в ~/.codex/config.toml (или проектный .codex/config.toml в доверенном проекте):

config.toml

[mcp_servers.dbsend]
url = "https://api.dbsend.ru/v1/mcp"
bearer_token_env_var = "DBSEND_API_KEY"

Инструменты

Сервер показывает только инструменты, разрешённые правами ключа. Инструментов удаления нет. Бинарные файлы через MCP не передаются: загрузку выполняет CLI или REST API, а агент в Claude Code или Cursor может запустить dbsend backup в терминале.

Инструмент	Право	Назначение
get_workspace	workspace.read	Рабочее пространство, тариф, лимиты и включённые функции
list_projects	projects.read	Список проектов
create_project	projects.create	Создать проект
list_databases / list_sources	databases.read	Базы и их состояние, фильтр по проекту и статусу
get_database	databases.read	Одна база и сводка по последней версии
create_database	databases.create	Создать базу нужного типа с учётом лимита тарифа
set_database_status	databases.update	Приостановить или возобновить приём бэкапов
list_snapshots	backups.read	Последние версии базы (инспекция — на тарифах от «Старт»)
list_backup_history	backups.read	История версий по всем базам или по одной
get_backup_status	backups.read	Статус обработки и время одной версии
get_snapshot	backups.read	Метаданные версии и инспекция: таблицы, строки, предупреждения
compare_snapshots	backups.diff	Diff двух версий одной базы (тарифы от «Старт»)
get_snapshot_download	backups.download	Защищённая ссылка на скачивание версии
start_backup	backups.upload	Проверить базу и лимиты и вернуть инструкции загрузки для CLI/API
prepare_restore	backups.restore	Выдать одноразовый код подтверждения восстановления (5 минут) для клиентов без elicitation
request_restore	backups.restore	Создать задачу восстановления (скачивание) — только после подтверждения человеком
get_restore_job / list_restore_jobs	backups.restore	Статус задач восстановления
get_usage	billing.read	Расход хранилища и загрузок, квоты тарифа

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

«Покажи базы dbsend, у которых последний успешный бэкап старше 24 часов.»
«Сравни две последние версии базы production и кратко оцени риск изменений.»
«Покажи расход хранилища и оставшиеся лимиты тарифа.»
«Подготовь восстановление последней версии базы analytics и верни статус задачи.»
«Создай DuckDB-базу reports в проекте Analytics, не изменяя другие ресурсы.»

Типичные ошибки

401: ключ неверный, отозван, истёк или заголовок не передан.
403: ключу не хватает права или он привязан к другой базе; создайте ключ с минимально нужными правами.
409 CONFIRMATION_REQUIRED: восстановление подтверждает человек. Если клиент поддерживает MCP elicitation, он сам покажет запрос. Иначе вызовите prepare_restore, покажите пользователю версию и передайте полученный одноразовый код в request_restore как confirmationCode.
429: исчерпан rate limit — подождите до X-RateLimit-Reset.
Инструмент не виден: MCP фильтрует инструменты по правам ключа.
Не подключается: проверьте URL, переменную окружения и перезапустите клиент.

Готовы попробовать?

Бесплатный тариф: 1 база, 500 МБ и 3 версии — без карты.

Тарифы Начать бесплатно