PocketSmith Read-only
официальныйТолько для чтения: транзакции, бюджеты, прогнозы и аналитика из инструмента для управления личными финансами PocketSmith.
Что можно делать с PocketSmith Read Only MCP?
- Проверка финансового состояния — Запросите сводку по чистому капиталу, темпу расходов относительно бюджета и состоянию бюджета по категориям.
- Сравнение расходов — Сравните расходы по категориям и получателям платежей за два периода, чтобы увидеть, что изменилось.
- Выявление регулярных расходов — Найдите подписки и регулярные счета, указав периодичность и общую годовую стоимость.
- Прогнозы движения денежных средств и чистого капитала — Спрогнозируйте остатки на счетах и чистый капитал на будущее с помощью механизма прогнозирования PocketSmith.
- Поиск транзакций — Найдите транзакции с фильтрами по дате, категории, ключевому слову или статусу.
- Прямые ссылки — Получите ссылку на конкретную страницу PocketSmith, отчёт или отфильтрованный поиск, о котором идёт речь.
Размещённый MCP-сервер
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
MCP-сервер
Подключите свой аккаунт PocketSmith к любому ИИ-помощнику, поддерживающему Model Context Protocol.
Подключив ИИ-помощника к PocketSmith через Model Context Protocol (MCP), вы предоставите ему прямой доступ к своим финансовым данным, бюджетам и прогнозам. Он сможет предоставлять аналитические выводы и информацию, а также выполнять за вас различные действия.
Возможности
MCP-сервер PocketSmith позволяет ИИ-помощникам от вашего имени просматривать данные PocketSmith и управлять ими. Вместо того чтобы переключаться между ИИ-помощником и PocketSmith, вы можете задавать вопросы и выполнять действия на естественном языке:
- Просматривать расходы, бюджеты и чистую стоимость активов
- Искать транзакции и назначать им категории
- Создавать и обновлять бюджетные события
- Анализировать тенденции и сравнивать расходы за разные периоды
- Проверять статус синхронизации банковских данных и запускать обновление
- Получать прямые ссылки на нужную страницу или отчёт PocketSmith
Доступны два режима:
| Режим | Описание | Как подключиться |
|---|---|---|
| Полный доступ | Все 66 инструментов — просмотр, создание, обновление и удаление | Подключение одним нажатием из каталога Claude или ChatGPT |
| Только чтение | 40 инструментов только для чтения — просмотр и анализ без изменений | Ручная настройка в качестве пользовательского коннектора (несколько дополнительных шагов) |
Большинству пользователей подойдёт полный доступ. Для удаления любых данных всегда требуется ваше явное подтверждение. Вы также можете попросить помощника уточнять у вас разрешение перед внесением любых других изменений. Выберите режим только для чтения, если хотите гарантировать, что помощник никогда не сможет изменить ваши данные.
Подключение
Полный доступ доступен как приложение в каталогах Claude и ChatGPT, поэтому для подключения достаточно одного нажатия. Режим только для чтения пока не представлен ни в одном из каталогов, поэтому его нужно вручную добавить как пользовательский коннектор, указав URL из раздела Другие MCP-клиенты ниже.
Claude (claude.ai, Claude Desktop и мобильные приложения)
Полный доступ:
- Откройте PocketSmith Complete Access в каталоге Claude
- Нажмите Connect
- Вы будете перенаправлены в PocketSmith для авторизации доступа
Коннекторы привязаны к вашему аккаунту Claude. Поэтому после подключения на claude.ai PocketSmith также будет доступен в Claude Desktop и мобильных приложениях Claude.
Только чтение:
- На claude.ai или в Claude Desktop откройте Settings > Connectors
- Нажмите Add custom connector
- Введите название (например, "PocketSmith Read-only") и URL
https://mcp-readonly.pocketsmith.com/mcp - Нажмите Connect рядом с новым коннектором и авторизуйте доступ в PocketSmith
Claude Code
# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
При первом использовании Claude Code предложит пройти авторизацию через OAuth.
ChatGPT (chatgpt.com и приложение для компьютера)
Полный доступ:
- Откройте PocketSmith в каталоге приложений ChatGPT на chatgpt.com
- Нажмите Connect
- Вы будете перенаправлены в PocketSmith для авторизации доступа
Приложения привязаны к вашему аккаунту ChatGPT. Поэтому после подключения на chatgpt.com PocketSmith также будет доступен в приложении ChatGPT для компьютера. Если он не появится, перезапустите приложение.
Только чтение:
Режим только для чтения нужно настроить на chatgpt.com, а не в приложении для компьютера:
- Откройте Settings > Apps & Connectors и включите Developer mode (в разделе Advanced settings)
- Нажмите Create, чтобы добавить пользовательский коннектор
- Введите название (например, "PocketSmith Read-only") и URL
https://mcp-readonly.pocketsmith.com/mcp - Нажмите Connect — вы будете перенаправлены в PocketSmith для авторизации доступа
Не используйте пункт Settings > Plugins > Add MCP server в приложении для компьютера: добавленные там серверы доступны только в Codex, но не в ChatGPT.
Рабочие пространства Business/Enterprise/Edu: администратор рабочего пространства должен сначала включить приложение или добавить коннектор в разделе Workspace settings. Затем каждый пользователь подключает и авторизует собственный аккаунт PocketSmith.
Codex
Полный доступ: если вы уже подключили PocketSmith из каталога приложений ChatGPT, он автоматически станет доступен в Codex при следующем чате. В противном случае добавьте его из командной строки:
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Только чтение:
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
При первом использовании Codex предложит пройти авторизацию через OAuth.
Другие MCP-клиенты
| Режим | URL |
|---|---|
| Полный доступ | https://mcp.pocketsmith.com/mcp |
| Только чтение | https://mcp-readonly.pocketsmith.com/mcp |
Подключиться по этим URL можно из любого MCP-клиента, поддерживающего HTTP-транспорт и OAuth. Сервер поддерживает OAuth 2.0 с PKCE и публикует метаданные обнаружения по адресам /.well-known/oauth-authorization-server и /.well-known/oauth-protected-resource.
Аутентификация
Аутентификация выполняется автоматически через OAuth. При первом подключении вы будете перенаправлены в PocketSmith, чтобы войти в аккаунт и предоставить доступ. ИИ-помощник получает токен с правами, соответствующими выбранному режиму доступа (полный или только для чтения), и никогда не видит ваш пароль PocketSmith.
Токены зашифрованы и не хранятся на сервере — сервер MCP не сохраняет никаких данных. Вы можете в любой момент отозвать доступ на странице авторизованных приложений PocketSmith.
Примеры использования
«Как идут дела в этом месяце?»
Попросите оценить финансовое состояние и получить краткую сводку:
Вы: Как у меня идут дела с финансами в этом месяце? Укладываюсь ли я в бюджет?
Используется инструмент financial_health_snapshot, который показывает чистую стоимость активов, темп расходов за текущий месяц относительно бюджета, индикаторы состояния бюджета по категориям и задачи, требующие внимания, например транзакции без категории.
«За какие подписки я плачу?»
Найдите регулярные платежи, о которых вы могли забыть:
Вы: Можешь найти все мои регулярные расходы и подписки? Хочу узнать, сколько я плачу каждый месяц и какова общая сумма за год.
Инструмент find_recurring_expenses анализирует историю транзакций, выявляет регулярные платежи по получателям, определяет их периодичность и подсчитывает общую сумму за год.
«Сравни мои расходы с прошлым месяцем»
Узнайте, на что вы потратили деньги иначе:
Вы: Сравни мои расходы в этом месяце с прошлым. В каких категориях они выросли или снизились?
Инструмент spending_comparison разбивает расходы за оба периода по категориям и получателям, выделяя изменения, а также новых и исчезнувших получателей.
«Проанализируй мои финансы за март»
Получите подробный обзор по итогам месяца:
Вы: Подготовь полный обзор за март 2025 года: доходы, расходы, норма сбережений и соответствие бюджету.
Инструмент month_end_review формирует подробный отчёт со сводкой доходов и расходов, нормой сбережений, отклонениями от бюджета по категориям, основными получателями, примечательными транзакциями и снимком чистой стоимости активов.
«Назначь категории моим недавним транзакциям»
Разберите транзакции без категорий:
Вы: За последнюю неделю у меня накопилось много транзакций без категорий. Можешь посмотреть их и назначить категории?
Инструмент list_transactions находит недавние транзакции без категорий, затем инструмент list_categories просматривает дерево категорий, а инструмент update_transaction назначает подходящие категории на основе названий получателей. (Требуется режим полного доступа.)
«Какой будет баланс моего сберегательного счёта через 6 месяцев?»
Спрогнозируйте будущие остатки на счетах:
Вы: Как будет меняться баланс моего сберегательного счёта в течение следующих 6 месяцев с учётом моего бюджета?
Инструмент cash_flow_forecast прогнозирует будущие остатки с помощью механизма прогнозирования PocketSmith, показывая ожидаемую динамику каждого счёта и предупреждая о возможном падении баланса ниже безопасного порога.
«Покажи, где это находится»
Получите прямую ссылку на нужную страницу или отчёт в веб-приложении PocketSmith:
Вы: Как изменились мои расходы на продукты за последний год? Дай ссылку, чтобы я мог сам изучить подробности.
Инструмент get_trend_analysis обобщает тенденцию, а затем инструмент navigate_to_trends создаёт прямую ссылку на отчёт Trends с фильтрами по категории Groceries и диапазону дат, чтобы вы могли продолжить изучение в PocketSmith. Все инструменты навигации работают так же: помощник отвечает на вопрос, а затем передаёт ссылку на нужную страницу, отчёт или поиск транзакций.
Доступные инструменты
Аналитика (инструменты комплексного анализа)
Эти инструменты объединяют несколько вызовов API, чтобы подготовить подробный анализ, готовый к использованию:
| Инструмент | Возможности |
|---|---|
financial_health_snapshot | Чистая стоимость активов, темп расходов, индикаторы состояния бюджета, задачи, требующие внимания |
month_end_review | Полный обзор периода: доходы и расходы, норма сбережений, отклонения от бюджета, основные получатели |
spending_comparison | Сравнение двух периодов по категориям и получателям |
find_recurring_expenses | Выявление подписок и регулярных счетов с подсчётом годовых расходов |
cash_flow_forecast | Прогноз остатков на счетах с предупреждениями о критически низком балансе |
net_worth_forecast | Динамика чистой стоимости активов: исторические тенденции, прогнозы и ключевые этапы |
forecast_accuracy | Сравнение фактических и прогнозируемых остатков для оценки надёжности бюджета |
Бюджетирование
| Инструмент | Возможности |
|---|---|
get_budget | Анализ бюджета по категориям за прогнозный период |
get_budget_summary | Фактические расходы и доходы в сравнении с бюджетом за выбранный период |
get_trend_analysis | Динамика расходов по категориям |
delete_forecast_cache | Принудительный пересчёт бюджета после массового редактирования |
Транзакции
| Инструмент | Возможности |
|---|---|
list_transactions | Поиск и фильтрация транзакций по дате, категории, ключевому слову и статусу |
get_transaction | Полная информация об отдельной транзакции |
create_transaction | Добавление новой транзакции |
update_transaction | Изменение транзакции (получатель, категория, метки, заметки, разделение) |
delete_transaction | Удаление транзакции |
Счета и финансовые учреждения
| Инструмент | Возможности |
|---|---|
list_accounts | Список всех счетов пользователя или финансового учреждения |
get_account | Информация о счёте, включая баланс и дочерние счета |
create_account / update_account / delete_account | Управление счетами |
update_account_display_order | Изменение порядка счетов |
list_institutions / get_institution | Просмотр финансовых учреждений |
create_institution / update_institution / delete_institution | Управление финансовыми учреждениями |
list_transaction_accounts / get_transaction_account / update_transaction_account | Просмотр и обновление счетов транзакций |
Категории и правила
| Инструмент | Назначение |
|---|---|
list_categories / get_category | Просмотр иерархии категорий |
create_category / update_category / delete_category | Управление категориями |
list_category_rules / create_category_rule | Просмотр и создание правил автокатегоризации |
Бюджетные события
| Инструмент | Назначение |
|---|---|
list_events / get_event | Просмотр событий прогноза бюджета |
create_event / update_event / delete_event | Управление регулярными и разовыми бюджетными событиями |
Вложения
| Инструмент | Назначение |
|---|---|
list_attachments / get_attachment | Просмотр вложений с чеками и документами |
create_attachment / update_attachment / delete_attachment | Управление вложениями |
assign_transaction_attachment / unassign_transaction_attachment | Привязка вложений к транзакциям и отвязка от них |
Каналы данных
| Инструмент | Назначение |
|---|---|
get_data_feeds_connection_status | Проверка состояния синхронизации банковских каналов и сведений о провайдере |
refresh_data_feeds_connection | Запуск синхронизации одного или всех подключений банковских каналов |
Навигация
Эти инструменты создают прямые ссылки, чтобы ассистент мог направить вас на нужную страницу PocketSmith в рамках беседы — с предварительно выбранными счетами, категориями и датами, а также другими необходимыми элементами управления на странице.
| Инструмент | Назначение |
|---|---|
navigate_to_transactions | Поиск транзакций с фильтрами по счету, категории, ключевому слову или дате |
navigate_to_budget | Переход на страницу бюджета с настройками дат и другими параметрами, которыми можно управлять через ссылку |
navigate_to_trends | Отчет о динамике расходов или доходов по категории с течением времени; все параметры доступны через ссылку |
navigate_to_income_expense | Отчет о доходах и расходах (отчет о прибылях и убытках) с фильтрами, диапазонами дат и другими параметрами по ссылке |
navigate_to_cashflows | Отчет о денежных потоках (помесячная таблица) |
navigate_to_net_worth | Страница чистой стоимости с фильтрами и другими параметрами, доступными через ссылку |
navigate_to_calendar | Календарь запланированных и прогнозируемых бюджетных событий и балансов с диапазонами дат, доступными через ссылку |
navigate_to_account_summary | Сводка по счету за определенный месяц |
Прочее
| Инструмент | Назначение |
|---|---|
get_current_user / update_user | Просмотр и обновление профиля и настроек пользователя |
list_labels | Просмотр всех меток транзакций |
list_saved_searches | Просмотр сохраненных фильтров поиска транзакций |
list_currencies / get_currency | Справочные данные о валютах |
list_time_zones | Справочные данные о часовых поясах |
Модель данных PocketSmith
Понимание иерархии PocketSmith помогает при формулировании вопросов:
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Финансовые учреждения — банки или финансовые провайдеры
- Счета объединяют один или несколько транзакционных счетов и сценариев
- Транзакционные счета содержат фактические записи о транзакциях
- Сценарии содержат бюджетные события, которые используются механизмом прогнозирования PocketSmith
- Категории имеют иерархическую структуру (родительские и дочерние) и общие для всех счетов
- Метки — это теги, которые можно добавлять к транзакциям для гибкой группировки
Конфиденциальность и безопасность
- Политика конфиденциальности PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
- Ваши учетные данные PocketSmith никогда не передаются ИИ-ассистенту
- Токены OAuth зашифрованы с помощью AES-256-GCM и не сохраняются на сервере
- Для всего обмена данными с API используется шифрование TLS
- Вы можете в любой момент отозвать доступ в разделе авторизованных приложений PocketSmith
Поддержка
- Справка и поддержка: https://learn.pocketsmith.com
- Связаться со службой поддержки: help@pocketsmith.com