Claude 연동
한 번의 설치 명령으로 Claude Desktop이 개인 자산 분석가가 됩니다. 포트폴리오, 순자산, 현금흐름, 시장 데이터, 입력한 목표를 모두 참고해서, 일반론이 아닌 내 실제 상황에 기반한 답을 하게 됩니다.
물을 수 있는 것
순자산 추정
사용자
연말까지 순자산 $1M 가능한 페이스야?
Claude
현재 순자산은 $441K이며, 지난 1년간 평균 +$6,400/월씩 증가했습니다. 이 페이스라면 약 87개월 후인 2033년 7월에 $1M에 도달합니다. 연말까지는 불가능합니다. 12월까지 도달하려면 월 +$46K를 저축해야 하며, 이는 현재 페이스의 약 7배입니다.
포트폴리오 익스포저 + 실적 발표 리서치
사용자
다음 주 TSLA 실적인데 애널리스트 컨센서스 어때? 그리고 내 익스포저 얼마나 돼?
Claude
TSLA 실적은 4월 30일 AMC 발표입니다. 컨센서스 EPS 추정치는 $0.43입니다. 직전 분기는 $0.41로 미스였습니다. 보유 수량은 392주, 평균 단가 $245.68, 현재 +60.97% 상태입니다. TSLA가 포트폴리오의 약 82%를 차지합니다. 5% 변동 시 포트폴리오는 약 ±$7,500 움직입니다.
AI 시각화 (Claude Desktop 아티팩트)
사용자
내 재무 상황 차트로 한눈에 보여줘.
Claude
포트폴리오, 자산 이력, 현금흐름 데이터를 통합합니다. 인터랙티브 대시보드를 생성합니다. 순자산 추세, 자산 비중, 월별 저축률을 한 화면에 표시합니다.
↳ Claude는 차트가 포함된 인터랙티브 React 아티팩트를 직접 렌더링합니다. 사용자가 코드를 작성할 필요는 없습니다.
자연어 거래 기록
사용자
방금 NVDA 10주 $875에 샀어. 기록해줘.
Claude
완료. NVDA 10주 @ $875.00이 오늘자로 기록되었습니다. NVDA 포지션은 이제 166주, 평균 단가 $134.51, +$121,618 (+548%) 상태입니다. (add_txn이 자동으로 호출됨.)
프롬프트
Claude Desktop에서
/를 입력하면 가이드가 적용된 워크플로에
접근할 수 있습니다. Firma는 10개의 프롬프트를 제공하며, 각 프롬프트는
올바른 도구 호출 순서를 강제하므로 사용자가 기억할 필요가 없습니다.일괄 가져오기
import-tradesCSV 또는 증권사 거래 내역 파일을 첨부합니다. Claude가 컬럼 매핑을 제시하고 사용자 확인을 받은 뒤, 모든 행을 한 번의 일괄 호출로 기록합니다. 수백 행을 한 번에 처리합니다.
import-balance순자산 스프레드시트(행=월, 열=자산 카테고리)를 첨부합니다. 동일한 매핑-확인-일괄 흐름으로 여러 월을 한 번에 처리합니다.
import-flow수입/지출 스프레드시트를 첨부합니다. Import-balance와 동일한 흐름이며, 현금흐름 테이블을 대상으로 합니다.
워크플로
month-end해당 기간의 모든 자산 및 현금흐름 카테고리를 순서대로 묻고, 한 번에 일괄 등록한 뒤 정산 요약을 표시합니다.
morning오늘의 브리핑을 가져오며, 주의가 필요한 항목만 요약합니다. 집중도 위험, 다가오는 실적 발표, 거시경제 신호 변화, 주요 변동 종목 등.
analyst자산 분석가 페르소나를 활성화합니다. Claude는 집중도 위험을 먼저 제시하고, 모든 수치를 순자산 또는 runway 기준으로 환산하며, 포트폴리오 + 현금흐름 + 거시경제를 통합된 시각으로 결합합니다.
setup-profile목표를 등록합니다 (출생 연도, 은퇴 목표 연도, 목표 순자산, 위험 성향, 메모). 5개 항목 모두 선택 입력이며, Claude가 대화 중에 자연스럽게 묻고 입력하지 않은 항목은 건너뜁니다.
의사결정 지원
pre-mortem해당 포지션이 향후 12개월 동안 잘못될 수 있는 5가지 구체적 시나리오를 제시합니다. 실제 데이터에 기반한 실패 메커니즘, 포트폴리오에 미치는 달러 영향, 그리고 한 가지 구체적 대응 방안.
rebalance현재 비중과 목표 비중을 비교하여 차이를 표시하고, 구체적 매매를 제안합니다. 추천 전에 거래 사유, 매도 시 세금 부담, 워시세일 위험을 점검합니다.
tax-harvest미실현 손실 종목을 스캔하고 30일 워시세일 규칙을 적용한 뒤, 시장 익스포저를 유지하기 위한 유사하지만 동일하지 않은 대체 종목을 제안하며, 세율 구간별 절세 효과를 추정합니다.
scenario시장 충격(“S&P -20%”), 단일 종목 변동, 거시경제 변화 시나리오를 실제 포트폴리오에 적용해 분석합니다. 베타 가정을 먼저 명시하므로 사용자가 가정을 수정해 재실행할 수 있습니다.
슬래시 명령어를 외울 필요는 없습니다. Claude는 모든 대화 시작 시
setup_status를 호출하며, 응답에는 동일한 분석 프레임워크와
트리거 조건이 포함됩니다. 그래서 위험한 매수에는 pre-mortem이, 연말 세금
관련 질문에는 harvest가, 거시경제 질문에는 scenario 분석이 입력 없이도
자동으로 적용됩니다. 슬래시 명령어는 명시적으로 호출하고 싶을 때 사용할
수 있습니다.동작 원리
MCP(Model Context Protocol)는 AI 모델을 로컬 도구 및 데이터 소스에
연결하기 위한 개방형 표준입니다. Firma는 MCP 서버를 구현한
firma-mcp 바이너리를 제공합니다. firma mcp install을
실행하면 이를 Claude Desktop 설정에 등록합니다:$firma mcp install
✓MCP registered at ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop을 재시작하면 도구 패널에 firma가 표시됩니다. 재무 관련
질문을 하면 Claude가 firma 도구를 자동으로 호출합니다. 사용자가
명시적으로 호출할 필요는 없습니다.
팁
시각화를 직접 요청하기
Claude Desktop은 React 컴포넌트를 아티팩트로 렌더링할 수 있습니다. “순자산 추세 차트 보여줘”라고 요청하면 실제 데이터를 사용한 인터랙티브 시각화가 생성됩니다.
한 질문에서 여러 데이터 소스 결합
Claude는 단일 응답에서 여러 도구를 호출할 수 있습니다. “저축률이랑 TSLA 포지션이랑 상관관계 어때?”라고 묻으면 현금흐름과 포트폴리오 데이터를 모두 가져와 답변합니다.
대화로 거래 기록
거래 추가에 CLI를 사용할 필요가 없습니다. Claude에게 알려주면
add_txn이 직접 호출됩니다. 이미 Claude와 대화 중일 때 유용합니다.사용 가능한 도구
Read · 포트폴리오
show_portfolio보유 종목 + 손익 + 평균 단가
show_txns거래 내역 (티커 필터 가능)
show_dividend연간 배당 추정 + 종목별 배당 수익률
show_concentration티커, 통화, 섹터, 국가별 HHI 집중도
show_snapshot포트폴리오 가치 이력 (종목별 또는 일별 합계)
show_prices보유 종목의 최신 동기화 가격
show_benchmark동일 기간 SPY/QQQ (또는 사용자 지정 벤치마크) 대비 수익률
show_risk변동성, 드로다운, Sharpe, Sortino, 베타 (스냅샷 이력 필요)
show_profile사용자 목표: 출생 연도, 은퇴 목표, 목표 순자산, 위험 성향, 메모
set_profile프로필 항목 업데이트 (부분 업데이트, 전달된 항목만 변경)
Read · 자산 & 현금흐름
show_balance자산 항목 (기간 필터 가능)
show_flow현금흐름 항목 (기간 필터 가능)
report_balance월별 순자산 추세 (집계)
report_flow월별 수입 / 지출 / 저축률 추세
report_combined자산 + 현금흐름 추세를 한 번에
report_settle월말 요약: 자산 + 현금흐름 합계
Read · 거시경제 & 브리핑
get_brief데일리 브리핑: 보유 종목 + 변동 + 뉴스 + 실적 + 거시경제 + 신호 + 자동 생성 인사이트 (일별 캐시)
show_macro큐레이트된 FRED 거시경제 스냅샷 (지표 8개 + 홈 통화 기준 동적 환율)
show_stress5개 FRED 시리즈 기반 경제 스트레스 지수 (0–100) 및 세부 항목
show_regime5개 이진 신호 기반 거시경제 레짐 편향 (Risk-on / Mixed / Risk-off)
fetch_fred_seriesID로 FRED 시계열 직접 조회 (80만 개 이상 시리즈 중 임의)
search_fred_series키워드로 FRED 카탈로그 검색
get_fx_rate특정 날짜의 과거 환율 (USD 대비), 로컬 캐시에서 조회
Read · 리서치
show_earnings다가오는 실적 발표 + EPS 이력
show_insider내부자 매매 거래
show_financialsSEC 보고 분기 재무제표
show_news최근 기업 뉴스 기사
Write
add_txn단일 거래 기록 (매수, 매도, 입고, 배당, 세금)
add_txns여러 거래 일괄 입력 (스프레드시트 가져오기에 사용)
edit_txnID로 기존 거래의 항목 업데이트
delete_txnID로 거래 삭제
add_balance자산 항목 단일 upsert (동일 키 시 수정으로 동작)
add_balances여러 월에 걸친 자산 항목 일괄 upsert (순자산 스프레드시트 가져오기에 사용)
add_flow현금흐름 항목 단일 upsert (동일 키 시 수정으로 동작)
add_flows여러 월에 걸친 현금흐름 항목 일괄 upsert (수입/지출 스프레드시트 가져오기에 사용)
add_monthly단일 기간의 자산 + 현금흐름 항목 일괄 upsert
delete_balance특정 기간의 자산 항목 삭제 (전체 또는 단일 카테고리)
delete_flow특정 기간의 현금흐름 항목 삭제 (전체 또는 단일 카테고리)
add_snapshot가격을 동기화하고 오늘의 포트폴리오 스냅샷을 기록
edit_snapshot스냅샷 항목 수정
delete_snapshot특정 날짜의 모든 스냅샷 항목 삭제
Actions
sync_pricesFinnhub에서 최신 주가 가져오기
sync_fx_ratesFRED에서 과거 환율 캐시 백필 (증분)