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 и мобильные приложения)

Полный доступ:

  1. Откройте PocketSmith Complete Access в каталоге Claude
  2. Нажмите Connect
  3. Вы будете перенаправлены в PocketSmith для авторизации доступа

Коннекторы привязаны к вашему аккаунту Claude. Поэтому после подключения на claude.ai PocketSmith также будет доступен в Claude Desktop и мобильных приложениях Claude.

Только чтение:

  1. На claude.ai или в Claude Desktop откройте Settings > Connectors
  2. Нажмите Add custom connector
  3. Введите название (например, "PocketSmith Read-only") и URL https://mcp-readonly.pocketsmith.com/mcp
  4. Нажмите 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 и приложение для компьютера)

Полный доступ:

  1. Откройте PocketSmith в каталоге приложений ChatGPT на chatgpt.com
  2. Нажмите Connect
  3. Вы будете перенаправлены в PocketSmith для авторизации доступа

Приложения привязаны к вашему аккаунту ChatGPT. Поэтому после подключения на chatgpt.com PocketSmith также будет доступен в приложении ChatGPT для компьютера. Если он не появится, перезапустите приложение.

Только чтение:

Режим только для чтения нужно настроить на chatgpt.com, а не в приложении для компьютера:

  1. Откройте Settings > Apps & Connectors и включите Developer mode (в разделе Advanced settings)
  2. Нажмите Create, чтобы добавить пользовательский коннектор
  3. Введите название (например, "PocketSmith Read-only") и URL https://mcp-readonly.pocketsmith.com/mcp
  4. Нажмите 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

Поддержка