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 서버
Model Context Protocol을 지원하는 모든 AI 어시스턴트에 PocketSmith 계정을 연결하세요.
Model Context Protocol (MCP)을 통해 AI 어시스턴트를 PocketSmith에 연결하면 금융 데이터, 예산, 예측 정보에 직접 액세스할 수 있습니다. 인사이트와 정보를 제공하고 여러 작업도 대신 수행할 수 있습니다.
기능
PocketSmith MCP 서버를 사용하면 AI 어시스턴트가 사용자를 대신해 PocketSmith 데이터를 읽고 관리할 수 있습니다. AI 어시스턴트와 PocketSmith를 오갈 필요 없이 자연어로 질문하고 작업을 요청할 수 있습니다.
- 지출, 예산, 순자산 검토
- 거래 검색 및 분류
- 예산 이벤트 생성 및 업데이트
- 추세 분석 및 기간별 지출 비교
- 은행 피드 동기화 상태 확인 및 새로고침 실행
- 적절한 PocketSmith 페이지나 보고서로 바로 연결되는 딥 링크 받기
두 가지 액세스 모드를 사용할 수 있습니다.
| 모드 | 설명 | 연결 방법 |
|---|---|---|
| 전체 액세스 | 도구 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 옵션은 사용하지 마세요. 여기에 추가한 서버는 ChatGPT가 아니라 Codex에서만 사용할 수 있습니다.
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 | 두 날짜 기간의 카테고리 및 수취인별 나란히 비교 |
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 자격 증명은 AI 어시스턴트와 절대 공유되지 않습니다
- OAuth 토큰은 AES-256-GCM으로 암호화되며 상태 비저장 방식입니다(서버 측에 저장되는 정보 없음)
- 모든 API 통신은 TLS 암호화를 사용합니다
- PocketSmith 승인된 애플리케이션에서 언제든지 액세스 권한을 취소할 수 있습니다
지원
- 도움말 및 지원: https://learn.pocketsmith.com
- 지원팀에 문의: help@pocketsmith.com