API и MCP для своих инструментов

В Tetri скрипт, таблицу или MCP-клиент можно подключить к кошелькам, транзакциям, бюджетам и отчётам своего пространства. У каждого ключа только выбранные права и срок не больше 90 дней.

Сравнить подпискиСоздать ключ

Ответ на POST /transactions/parse с фразой вроде «кофе триста рублей вчера»: черновик с суммой, валютой, датой, счётом и категорией и список полей, которых не хватило. Транзакция не создана.

Отдельный ключ на каждую интеграцию

В окне «Создание ключа» нужны название, клиент (REST API или MCP), срок от 1 до 90 дней и возможности. Чтение отмечено сразу, создание транзакций, шаблонов и импортов нужно включить вручную.

Токен виден один раз

Токен можно скопировать из окна создания. Позже в списке виден только префикс, сам токен показан не будет. При смене пароля или адреса почты все токены отозваны.

REST: чтение, запись и импорт

Базовый путь /api/v1/programmatic. Для создания обязателен заголовок Idempotency-Key длиной от 16 до 128 символов. При повторе запроса дубля нет. То же значение с другим телом даёт ответ 409.

MCP: только разрешённые инструменты

Адрес POST /mcp, транспорт Streamable HTTP без сессий, токен в заголовке Authorization: Bearer. Видны только инструменты, разрешённые ключом. Для записи есть один инструмент: create_transaction.

Журнал запросов и использование

В журнале время, ключ, действие, транспорт, статус и длительность запроса. Использование доступно за 7, 30 или 90 дней. Тела запросов не сохранены.

Права и ограничения ключа

  • Возможности ключа

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

  • Ключи

    До 5 активных ключей у пользователя в одном пространстве. Срок от 1 до 90 дней, по умолчанию 30.

  • Лимиты в минуту

    1 200 запросов на чтение, 120 на отчёты, инсайты, разбор текста, создание транзакций и шаблонов, 5 на загрузку и подтверждение импорта. Сверх лимита возвращён код 429.

  • Импорт

    POST /imports: файл до 10 МБ в формате CSV, Excel, OFX, QFX или MT940 и идентификатор счёта. Импорт после проверки нужно подтвердить вторым запросом, дубликаты пропущены.

  • Проверка запроса

    Каждый запрос проверен дважды: по возможностям ключа и по правам пользователя в пространстве.

  • Ключ и пространство

    Ключ относится к пользователю и к пространству, в котором создан. Доступ к другим пространствам закрыт.

Вопросы об API и MCP

Подключить свой инструмент

Создать ключ с правами на чтение и отправить первый запрос.