MCP dbsend

Готовый Streamable HTTP сервер на https://api.dbsend.ru/v1/mcp. Устанавливать сервер на свой компьютер не нужно.

Ключ и права

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

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

Храните его в переменной окружения или локальном secret store.

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

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

Codex

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

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

В Codex Desktop/IDE можно также открыть Settings → MCP servers → Add server, выбрать Streamable HTTP, указать URL и перезапустить клиент. Проверка: /mcp.

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

# Проверка внутри Claude Code
/mcp

Для командной конфигурации используйте .mcp.json и Authorization: Bearer $${DBSEND_API_KEY}; сам ключ не коммитьте.

Методы

Tool	Scope	Назначение
list_projects	projects.read	Список проектов tenant
list_databases	databases.read	Базы и их состояния
create_database	databases.create	Создание базы нужного engine
set_database_status	databases.update	Pause или resume
list_snapshots	backups.read	Последние слепки и инспекция
get_backup_diff	backups.diff	Diff двух версий
create_restore	backups.restore	Подготовить восстановление
get_restore_job	backups.restore	Проверить restore job
get_usage	billing.read	Квоты, расход и тариф

Примеры промтов

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

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

401: ключ неверный, отозван или заголовок не передан.
403: ключу не хватает scope; создайте новый ключ с минимально нужным правом.
429: исчерпан rate limit — подождите до X-RateLimit-Reset.
Tool не виден: MCP фильтрует методы по scopes ключа.
Не подключается: проверьте URL, переменную окружения и перезапустите клиент.