Настрой Claude Desktop

1. Получи API-ключ

В дашборде перейди в Org Settings → API Keys → Create. Дай ему scope mcp:* (покрывает все пять инструментов ниже). Секрет показывается один раз; скопируй полную строку vrb_live_<prefix>.<secret>.

Храни в keychain ОС или в локальном .env — никогда не коммить. Ключ привязан к твоей org (и опционально к одному проекту); вызовы вне этого scope возвращают 404. Отозвать можно из дашборда в любой момент; отозванные ключи отдают 401 на следующем вызове.

2. Установка (или пропусти)

MCP server опубликован в npm и Homebrew. С npx ничего ставить не нужно — Claude Desktop тянет последнюю версию при каждом запуске. С brew получаешь зафиксированный локальный бинарник, удобно за строгими firewall'ами.

1// установка не нужна — npx подтягивает свежий @verbumia/mcp по требованию2npx -y @verbumia/mcp --version

1// опционально: установить глобально один раз — будет к запуску V12brew install verbumia/tap/verbumia-mcp

3. Подключи Claude Desktop

Открой конфиг-файл Claude Desktop, добавь запись verbumia под mcpServers, затем закрой и перезапусти приложение.

1// macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json2// Windows: %APPDATA%/Claude/claude_desktop_config.json3{4  "mcpServers": {5    "verbumia": {6      "command": "npx",7      "args": ["-y", "@verbumia/mcp@^0.11.0"],8      "env": {9        "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>",10        "VERBUMIA_PROJECTS": "<uuid1>,<uuid2>"11      }12    }13  }14}

Всего три env-переменные: VERBUMIA_TOKEN (обязательная), VERBUMIA_PROJECT (опциональная — заранее задаёт проект, чтобы агенту не пришлось сначала вызывать list_projects) и VERBUMIA_API_BASE (опциональная — по умолчанию https://api.verbumia.dev; переопредели для self-hosted или staging).

VERBUMIA_PROJECTS requires @verbumia/mcp ≥ 0.11.0. On older releases, see Backwards compatibility below.

Multi-project tool calls

When VERBUMIA_PROJECTS lists more than one UUID, the agent can't infer which project you mean — every tool call must include project_uuid. With a single UUID (or only the legacy VERBUMIA_PROJECT set), it's optional and defaults to that project.

1// list_missing_keys — project_uuid is REQUIRED when VERBUMIA_PROJECTS lists more than one UUID2{3  "name": "list_missing_keys",4  "arguments": {5    "project_uuid": "<uuid1>",6    "namespace": "checkout",7    "language_code": "ja"8  }9}

Phrase your prompt with the project in mind (« in the Checkout project, list missing keys for ja ») — the agent will resolve the project to its UUID and pass project_uuid on the tool call. For ambiguous prompts across multiple projects, the agent will call list_projects first.

Cursor (и другие MCP-клиенты)

Тот же JSON, другой файл. В Cursor положи его в .cursor/mcp.json (на проект) или ~/.cursor/mcp.json (на пользователя). Для других клиентов следуй их документации по MCP-конфигу — запись mcpServers.verbumia идентична.

1// .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (user-scoped)2{3  "mcpServers": {4    "verbumia": {5      "command": "npx",6      "args": ["-y", "@verbumia/mcp@^0.11.0"],7      "env": { "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>" }8    }9  }10}

5 инструментов V1

После настройки агент получает доступ к этим инструментам. По именам ты их не вызываешь — опиши намерение в чате, и агент сам выберет. Имена ниже — канонические идентификаторы, полезны при чтении трасс агента или при построении кастомных агентов поверх того же сервера.

Plan limits & quotas

You pay when an agent mutates your project, not when it observes it. Reads and listings are free; writes burn one unit; bulk and AI-assisted ops scale with the work they do.

What counts as a billable call

Per-plan ceilings

Monthly quota, hard per-minute rate, concurrent MCP sessions, and whether writes are allowed. The same numbers feed the X-MCP-Quota-Remaining header on every response.

When you hit a ceiling

Over the per-minute rate → 429 mcp_rate_limited with Retry-After (seconds). Over the monthly quota → 429 mcp_quota_exceeded with Retry-After set to the rollover. Free plan writes → 403 mcp_writes_disabled. Quotas reset on the 1st of each calendar month, UTC.

Как проверить

1. 1 Полностью перезапусти Claude Desktop (выйди и запусти снова — конфиг читается при старте).
2. 2 Открой новый чат. Иконка молотка должна показывать verbumia с пятью доступными инструментами.
3. 3 Напиши «List my Verbumia projects.» Агент должен вызвать list_projects и вернуть твои workspace'ы.

Застрял? Смотри логи Claude Desktop в ~/Library/Logs/Claude/mcp*.log (macOS). 90% проблем — опечатки в JSON или просроченный токен.