API и MCP для личных финансов
Данные Tetri доступны для собственных отчётов, скриптов и внешних ассистентов. Через REST API можно получить транзакции и добавить расходы из другого приложения. Через MCP — подключить выбранный клиент к финансовой истории.
Подключение собственных инструментов
Для таблицы с отчётом достаточно доступа к чтению. Скрипту, который добавляет покупки, нужно разрешение на создание транзакций. В настройках Tetri можно выпустить отдельный ключ для каждой интеграции.
Срок ключа — от 1 до 90 дней. Например, для разовой выгрузки можно выбрать один день, а для регулярного обновления отчёта — более долгий срок.
Ключ содержит только выбранные разрешения. Его значение доступно один раз после создания — для сохранения в настройках клиента или защищённом хранилище.
Доступ под задачу
Для сводки расходов можно разрешить чтение транзакций без их изменения. Для загрузки выписок — добавить права импорта. REST и MCP требуют отдельных ключей.
Замена и отзыв доступа
В списке сохранён только префикс токена; полное значение повторно недоступно. Ненужный ключ можно отозвать отдельно. После изменения пароля или почты все ключи отозваны, и подключениям нужны новые.
Собственные отчёты и таблицы
Через API можно загрузить расходы в таблицу со своими формулами: например, посчитать стоимость поездок по проектам. Скрипт получает транзакции из Tetri вместе с категориями; повторно разбирать банковскую выписку не нужно.
Методы доступны по /api/v1/programmatic. В документации API есть описание OpenAPI и примеры запросов на cURL, JavaScript и Python.
Учёт расходов из своего приложения
Личный бот или скрипт может создавать транзакции в Tetri. Для покупки за границей доступны отдельно сумма покупки и сумма списания со счёта. Для выписки — загрузка файла, проверка результата и подтверждение импорта.
Если ввод нужен обычной фразой, запрос POST /transactions/parse вернёт черновик. Например, «кофе 300 рублей вчера» можно разобрать, уточнить недостающий кошелёк и затем сохранить отдельным запросом.
Для повторов после сетевого сбоя нужен один Idempotency-Key длиной 16–128 символов и прежнее тело запроса. Тогда повтор не добавит второй расход. Другое тело с тем же ключом вернёт 409.
Финансовая история во внешнем ассистенте
К Tetri можно подключить выбранный внешний ассистент через MCP. Клиент получит доступ к разрешённым данным — например, расходам за месяц — для работы в привычной программе. Ассистента выбирает и подключает владелец; MCP — способ доступа к Tetri.
Подключение MCP-клиента
Клиенту нужны адрес POST /mcp, поддержка Streamable HTTP и MCP-ключ в Authorization: Bearer. Загрузку выписок и создание шаблонов следует подключать через REST API.
Чтение истории и добавление расходов
Через MCP доступны кошельки и балансы, транзакции, бюджеты, регулярные платежи, цели и отчёты. Для вопросов по истории достаточно чтения. Если нужно добавлять расходы, можно отдельно разрешить create_transaction.
Работа регулярных интеграций
Для обновления отчёта по расписанию можно выделить собственный ключ. В журнале доступны выполненные запросы и их статусы: по ним можно проверить, почему очередное обновление не завершено.
Частота обновлений
На ключ доступны 1 200 запросов чтения в минуту, 120 запросов отчётов и действий, 5 запросов загрузки и подтверждения импорта. Эти ограничения нужно учесть в расписании; после ответа 429 — отложить повтор.
Несколько подключений
В пространстве допустимо до пяти активных ключей. Таблицу, личного бота и MCP-клиент можно подключить независимо и заменять доступ только нужной интеграции.
Доступ к выбранному пространству
Ключ привязан к пространству и правам его владельца. Например, доступ к личным расходам не даёт интеграции доступ к отдельному семейному пространству.
Диагностика подключения
В журнале доступны время, ключ, статус и длительность запроса. По статусу можно проверить истёкший доступ или нехватку разрешений. Содержимое тела запроса в журнале не сохранено.
Вопросы об интеграциях
Интеграция должна запрашивать изменения через API. Вебхуков для отправки событий во внешний сервис пока нет.
Создать личный токен доступа в настройках интеграций. Для REST и MCP нужны отдельные токены. OAuth не поддержан.
Скрипт с правом создания транзакций может сохранить расход через API. Для каждого запроса на создание нужен Idempotency-Key. Разбор текстовой фразы сам по себе расход не сохраняет.
У GET /transactions есть параметры start, end и limit. В ответе до 100 транзакций; для продолжения доступны page или after.
Да. При создании ключа можно выбрать права чтения без создания транзакций и других изменений. Они действуют только в пространстве этого ключа.
Программный доступ входит в Pro. Стоимость и пробный период — в условиях подписки.