Claude에 연결
firma는 Claude의 커스텀 커넥터로 연결됩니다. 설치할 프로그램도, 터미널도 없습니다. 커넥터 주소를 붙여넣고 Google로 한 번 로그인하면 계정이 자동으로 만들어집니다.
연결 단계
커넥터를 지원하는 Claude
커스텀 커넥터(MCP)를 추가할 수 있는 Claude가 필요합니다. 설정에 커넥터 메뉴가 보이면 준비된 것입니다.
Google 계정
로그인은 Google로만 진행됩니다. 처음 연결할 때 한 번 로그인하면 firma 계정이 자동으로 만들어집니다.
Finnhub · FRED API 키 (무료, 나중에)
시세·실적·뉴스(Finnhub)와 거시경제·환율(FRED)에 쓰입니다. 연결을 먼저 끝낸 뒤 API 키 등록에서 넣으면 됩니다. 둘 다 무료입니다.
1
Claude 설정 열기
Claude에서 설정 → 커넥터 → 커스텀 커넥터 추가로 들어갑니다.
2
커넥터 주소 붙여넣기
https://firma-cloud.vercel.app/api/mcp이 주소를 커넥터 URL 칸에 그대로 붙여넣고 추가합니다.
3
Google로 로그인
연결하면 로그인 화면이 한 번 뜹니다. Google로 로그인하고 승인하면 firma 계정이 자동으로 만들어지고, 바로 Claude 안에서 firma 도구를 쓸 수 있습니다.
4
보유 자산 알려주기
대화창에 CSV, 증권사 거래 내역, 스크린샷을 첨부하거나 보유 자산을 말로 설명한 뒤 셋업을 요청합니다:
"[trades.csv 첨부] 이걸로 firma 셋업해줘. 그다음에 동기화하고 포트폴리오 보여줘."
Claude가 모든 행을 add_txn으로 입력한 뒤 sync로 시세·환율을 맞추고 결과를 보여줍니다. 자세한 예시는 데이터 가져오기를 참고하세요.
5
일상적 사용
셋업 후에는 하루 한 번 Claude에게 브리핑을 요청하면 됩니다:
"동기화하고 오늘 브리핑 줘."
Claude가 sync 후 get_market_brief를 호출합니다. 응답에는 비중이 포함된 보유 종목, 당일 손익, 뉴스, 다가오는 실적, 거시경제 컨텍스트, 이번 주 스탠스, 보유 종목별 추천이 담깁니다. 데일리 체크인에서 확인하세요.
계정과 데이터
연결할 때 Google 로그인 한 번으로 firma 계정이 만들어집니다. 거래·잔액·현금흐름
기록은 이 계정에 저장되고, 사용자별로 분리되어 다른 사람은 볼 수 없습니다.
firma는 은행이나 증권사 계좌에 연결하지 않습니다, 내가 적은 기록만 사용합니다.
로그인 다음 단계는 API 키 등록입니다. 시세·거시
데이터를 쓰려면 무료 Finnhub·FRED 키를 한 번 넣어두면 됩니다.