PocketSmith Read-only
公式読み取り専用:PocketSmithの個人向け財務ツールから、取引、予算、予測、インサイトを取得します。
PocketSmith Read Only MCPで何ができますか?
- 財務状況の確認 — 純資産、予算に対する支出ペース、カテゴリ別予算の状況を尋ねます。
- 支出の比較 — 2つの期間の支出をカテゴリ別・支払先別に比較し、何が変わったかを確認します。
- 定期支出の検出 — サブスクリプションや定期的な請求を、頻度と年間総額とともに見つけます。
- キャッシュフローと純資産の予測 — PocketSmithの予測エンジンを使って、口座残高と純資産の将来の推移を予測します。
- 取引の検索 — 日付、カテゴリ、キーワード、ステータスで絞り込んで取引を検索します。
- ディープリンク — 話題にしているPocketSmithのページ、レポート、または絞り込み検索への直接リンクを取得します。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
MCP Server
Model Context Protocol に対応した AI アシスタントに PocketSmith アカウントを接続できます。
Model Context Protocol(MCP)を介して AI アシスタントを PocketSmith に接続すると、財務データ、予算、予測に直接アクセスできるようになります。分析情報や情報を提供するほか、さまざまな操作を代わりに実行できます。
できること
PocketSmith MCP サーバーを使うと、AI アシスタントがあなたに代わって PocketSmith のデータを読み取り、管理できます。AI アシスタントと PocketSmith を切り替える代わりに、自然な言葉で質問したり、操作を依頼したりできます。
- 支出、予算、純資産を確認する
- 取引を検索してカテゴリ分けする
- 予算イベントを作成、更新する
- 傾向を分析し、期間ごとの支出を比較する
- 銀行フィードの同期状況を確認し、更新を開始する
- PocketSmith の適切なページやレポートへのディープリンクを取得する
2 つのアクセスモードを利用できます。
| モード | 説明 | 接続方法 |
|---|---|---|
| フルアクセス | 66 個すべてのツール — 読み取り、作成、更新、削除 | Claude または ChatGPT のディレクトリからワンクリックで接続 |
| 読み取り専用 | 読み取り専用の 40 個のツール — 表示と分析のみ、変更不可 | カスタムコネクタとして手動で設定(追加の手順が少し必要) |
ほとんどの方にはフルアクセスがおすすめです。削除を行う場合は、必ず事前に明示的な承認が必要です。また、ほかの変更を行う前にも確認するようアシスタントに依頼できます。アシスタントがデータを変更できないことを保証したい場合は、読み取り専用を選択してください。
接続
フルアクセスは Claude と ChatGPT のディレクトリに掲載されているアプリとして利用できるため、ワンクリックで接続できます。読み取り専用はまだどちらのディレクトリにも掲載されていないため、以下のその他の MCP クライアントにある URL を使って、カスタムコネクタとして手動で追加する必要があります。
Claude(claude.ai、Claude Desktop、モバイルアプリ)
フルアクセス:
- Claude ディレクトリでPocketSmith Complete Accessを開きます
- Connect をクリックします
- PocketSmith にリダイレクトされるので、アクセスを許可します
コネクタは Claude アカウントに紐づいているため、claude.ai で接続すると、Claude Desktop と Claude モバイルアプリでも PocketSmith を利用できます。
読み取り専用:
- 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、デスクトップアプリ)
フルアクセス:
- chatgpt.comでChatGPT アプリディレクトリの PocketSmithを開きます
- Connect をクリックします
- PocketSmith にリダイレクトされるので、アクセスを許可します
アプリは ChatGPT アカウントに紐づいているため、chatgpt.com で接続すると、ChatGPT デスクトップアプリでも PocketSmith を利用できます。表示されない場合は、デスクトップアプリを再起動してください。
読み取り専用:
読み取り専用はデスクトップアプリではなく、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
フルアクセス: ChatGPT アプリディレクトリから PocketSmith にすでに接続している場合は、次のチャットから 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 |
HTTP トランスポートと OAuth に対応した MCP クライアントであれば、これらの URL を使って接続できます。サーバーは OAuth 2.0 with PKCE に対応しており、検出メタデータを /.well-known/oauth-authorization-server と /.well-known/oauth-protected-resource で公開しています。
認証
認証は OAuth によって自動的に処理されます。初回接続時に PocketSmith にリダイレクトされるので、ログインしてアクセスを許可してください。AI アシスタントには、選択したアクセスモード(フルアクセスまたは読み取り専用)に限定されたトークンが渡され、PocketSmith のパスワードが知られることはありません。
トークンは暗号化され、ステートレスです。MCP サーバーには何も保存されません。PocketSmith の認証済みアプリケーションページから、いつでもアクセスを取り消せます。
使用例
「今月の状況はどうですか?」
ひと目でわかる概要を得るために、財務状況のチェックを依頼します。
あなた: 今月の財務状況はどうですか?予算どおりに進んでいますか?
financial_health_snapshot ツールを使って、純資産、当月の支出ペースと予算の比較、カテゴリ別の予算状況、未分類の取引などの対応事項を返します。
「どんなサブスクリプションに支払っていますか?」
忘れているかもしれない定期的な支払いを見つけます。
あなた: 定期的な支出やサブスクリプションをすべて見つけてもらえますか?毎月何にいくら支払っているかと、年間の合計額を知りたいです。
find_recurring_expenses ツールを使って取引履歴を調べ、支払先ごとに定期的な支払いを特定し、頻度を分類して、年間の合計額を算出します。
「先月と支出を比較してください」
お金の使い方がどのように変わったかを確認します。
あなた: 今月と先月の支出を比較してください。どのカテゴリが増減しましたか?
spending_comparison ツールを使って両方の期間をカテゴリ別、支払先別に分類し、変化した点や新たに現れた支払先、見られなくなった支払先を示します。
「3 月の財務状況を確認してください」
月末の包括的なレビューを取得します。
あなた: 2025 年 3 月の収入、支出、貯蓄率、予算との比較を含めて、詳しく振り返ってください。
month_end_review ツールを使って、収入と支出の概要、貯蓄率、カテゴリ別の予算差異、主な支払先、注目すべき取引、純資産のスナップショットを含む詳細なレポートを作成します。
「最近の取引をカテゴリ分けしてください」
未分類の取引を整理します。
あなた: 先週の未分類の取引がたくさんあります。確認して、カテゴリ分けしてもらえますか?
list_transactions を使って最近の未分類の取引を見つけ、次に list_categories でカテゴリツリーを確認し、update_transaction で支払先名に基づいて適切なカテゴリを割り当てます。(フルアクセスモードが必要です。)
「6 か月後、貯蓄口座はいくらになっていますか?」
口座残高の今後の推移を予測します。
あなた: 予算に基づくと、今後 6 か月間の貯蓄口座残高はどうなりそうですか?
cash_flow_forecast を使って PocketSmith の予測エンジンで残高の推移を予測し、各口座の今後の見通しを示します。また、残高が安全な基準を下回る可能性のある時点を知らせます。
「そのページを開いてください」
PocketSmith のウェブアプリケーション内にある適切なページやレポートへのリンクを取得します。
あなた:過去 1 年間で食料品への支出はどう変わりましたか?自分でも詳しく確認できるよう、リンクをください。
get_trend_analysis を使って傾向を要約し、次に navigate_to_trends でトレンドレポートへのディープリンクを作成します。リンクは「食料品」カテゴリと日付範囲であらかじめ絞り込まれているため、PocketSmith でそのまま詳しく確認できます。すべてのナビゲーションツールがこのように動作します。アシスタントが回答した後、話題にしたページ、レポート、取引検索への正確なリンクを提示します。
利用可能なツール
インサイト(複合分析ツール)
これらのツールは複数の API 呼び出しを組み合わせ、すぐに活用できる詳細な分析を作成します。
| ツール | できること |
|---|---|
financial_health_snapshot | 純資産、支出ペース、予算状況、対応事項 |
month_end_review | 収入と支出、貯蓄率、予算差異、主な支払先を含む期間全体のレビュー |
spending_comparison | 2 つの期間をカテゴリ別、支払先別に並べて比較 |
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 | 1 件の取引の詳細を取得 |
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 | 1つまたはすべての銀行フィード接続の同期を開始する |
ナビゲーション
これらのツールはディープリンクを生成し、会話に応じて適切なアカウント、カテゴリ、日付、およびレポートに必要なその他のページ内コントロールで事前にフィルターされた、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)
- 金融機関は銀行または金融サービス提供者を表します
- 口座は1つ以上の取引口座とシナリオをまとめます
- 取引口座には実際の取引記録が保存されます
- シナリオには、PocketSmithの予測エンジンを動かす予算イベントが保存されます
- カテゴリは階層構造(親/子)になっており、すべての口座で共有されます
- ラベルは、柔軟にグループ化するために取引に追加できるタグです
プライバシーとセキュリティ
- PocketSmithのプライバシーポリシー: https://www.pocketsmith.com/legal/privacy-policy/
- PocketSmithの認証情報がAIアシスタントと共有されることはありません
- OAuthトークンはAES-256-GCMで暗号化され、ステートレスです(サーバー側には何も保存されません)
- すべてのAPI通信はTLSで暗号化されます
- PocketSmithの認証済みアプリケーションから、いつでもアクセスを取り消せます
サポート
- ヘルプとサポート: https://learn.pocketsmith.com
- サポートへのお問い合わせ: help@pocketsmith.com