MCP (Model Context Protocol) позволяет подключать ИИ‑клиенты (Cursor, Perplexity, Cloud Code и др.) к Budgeter. Сервер MCP работает на том же хосте, что и External API; доступ по API ключу (заголовок X-Api-Key).
Где взять API ключ
В веб‑приложении: Настройки → API. Создайте ключ и скопируйте его — полный ключ показывается один раз. Для MCP подойдёт тот же ключ, что и для запросов к POST /v1/....
Базовый URL MCP
Продакшен:
https://api-external.budgeter.online/mcp
Заголовки
При каждом запросе к эндпоинту MCP клиент передаёт X-Api-Key: <ваш_api_ключ>. Ключ проверяется так же, как для External API; действуют те же scopes и лимиты.
Конфиг для Cursor
Добавьте сервер Budgeter в настройки MCP (например .cursor/mcp.json). Замените YOUR_API_KEY на ваш ключ.
Продакшен
{
"mcpServers": {
"Budgeter AI": {
"url": "https://api-external.budgeter.online/mcp",
"headers": {
"X-Api-Key": "YOUR_API_KEY"
}
}
}
}Локальная разработка
{
"mcpServers": {
"Budgeter AI": {
"url": "http://localhost:5102/mcp",
"headers": {
"X-Api-Key": "YOUR_API_KEY"
}
}
}
}После сохранения конфига перезапустите Cursor или обновите список MCP‑серверов. В списке инструментов появятся Tools Budgeter (например список счетов, создание счёта).
Ошибки и лимиты
Те же, что и у External API: INVALID_API_KEY / API_KEY_REVOKED (401), FORBIDDEN_SCOPE (403), RATE_LIMIT_EXCEEDED (429, заголовок Retry-After), VALIDATION_ERROR (400), RESOURCE_NOT_FOUND (404). Лимиты: 120 запросов/мин, 3000/час, 30000/день, 600000/месяц; для изменяющих операций — 60/мин.
См. также
Внешний API: основы — базовый URL, получение ключа, коды ошибок.
API: Счета — методы работы со счетами (list, get, create, update, delete).