AI 어시스턴트가 읽을 수 있는 포트폴리오 관리

AI 어시스턴트는 시장을 잘 설명하지만, 내가 무엇을 갖고 있는지는 몰라요. 채팅에 잔액을 붙여넣는 건 번거롭고 다음 날이면 이미 낡은 정보가 돼요. Sonar는 MCP 커넥터로 포트폴리오의 최신 읽기 전용 화면을 어시스턴트에게 건네서, 답변이 실제 보유 종목에서 출발하게 해요.

물어볼 수 있는 것

이번 주 내 포트폴리오 성과는 어땠고, 어떤 종목이 변화를 이끌었어?

내 상위 5개 종목은 뭐고, 포트폴리오에서 몇 %를 차지해?

일주일 전보다 감성이 더 부정적으로 바뀐 보유 종목은 뭐야?

내가 가진 코인마다 지난 30일 보유자 증가율과 가격 변화를 비교해 줘.

어제 ETH 0.5개를 샀어. 내 포트폴리오에 추가해 줘.

어시스턴트는 데이터를 설명할 뿐이고, 무엇을 읽어 낼지는 직접 판단하시면 돼요. Sonar는 투자 조언을 하지 않고, 커넥터도 마찬가지예요.

MCP 커넥터

MCP(Model Context Protocol)는 Claude, ChatGPT, Cursor 같은 어시스턴트가 외부 도구를 호출할 때 쓰는 표준이에요. Sonar 서버는 다음 도구를 제공해요.

add_position을 제외한 모든 도구는 읽기만 하고, add_position도 요청한 종목을 기록할 뿐이에요. 어떤 도구도 거래, 자금 이동, 연결된 계정 변경, 삭제를 할 수 없어요.

연결 방법

1. 로그인해서 API 및 AI 도구를 열고, 키를 만든 뒤 커넥터 URL을 복사하세요.
2. Claude(웹, 데스크톱, 모바일): 설정 → 커넥터 → 사용자 지정 커넥터 추가. 이름을 정하고 URL을 붙여넣은 뒤 저장하세요.
3. ChatGPT: 설정 → 앱 및 커넥터 → 고급에서 개발자 모드를 켜고, URL로 인증 없이 커넥터를 만든 다음 채팅의 도구 메뉴에서 켜세요.
4. Claude Code, Cursor 및 기타 MCP 클라이언트: 서버 https://sonarfolio.com/api/mcp에 키를 Bearer 토큰으로 넣어 사용하세요.

claude mcp add --transport http sonar https://sonarfolio.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

전체 안내는 개발자 페이지에 있어요.

REST API

Bearer 키를 쓰는 HTTPS 기반 JSON으로, 스프레드시트, 대시보드, 스크립트에 쓸 수 있어요.

• GET /api/v1/me: 요금제, 접근 범위, 오늘 사용량
• GET /api/v1/portfolio: 합계, 24시간 변화, 손익, 비중, 변동 종목
• GET /api/v1/holdings: 계좌별 모든 보유 종목
• POST /api/v1/holdings: 보유 종목 추가
• GET /api/v1/assets: 보유한 각 자산의 시장 데이터와 소셜 데이터
• GET /api/v1/assets/{id}: 보유 자산 하나의 상세 정보
• GET /api/v1/assets/search: 자산 ID 검색

응답에는 데이터 출처와 시각, 한도와 크레딧 헤더가 포함돼요.

CLI

API를 감싼, 의존성이 없는 커맨드라인 도구예요.

npm install -g sonarfolio
sonar login
sonar portfolio
sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'

명령어로는 portfolio, holdings, assets, asset, search, add(기록 전에 확인해요), 화면에 계속 띄워 두는 watch 등이 있어요. 모든 명령어가 --json을 지원해요.

어시스턴트가 보는 것

보유한 것만 봐요. 소셜 데이터, 온체인 데이터, 자산 상세 정보는 포트폴리오에 있는 자산만 대상이고, 시장 전체가 아니에요. 증권사나 거래소 로그인 정보, 거래소 API 키, 지갑 키는 애초에 Sonar에 없어요. 데이터가 어시스턴트에 전달되는 건 직접 내 키로 연결하고 질문할 때뿐이고, 키를 취소하면 접근도 끝나요.

포트폴리오 자체는 Sonar에 추가한 출처에서 와요. 50개 이상 네트워크의 지갑, Starter, Standard, Premium에서 Plaid로 연결한 증권사와 암호화폐 거래소, CSV 가져오기, 직접 입력. 모든 출처는 코인과 주식 포트폴리오 관리에서 확인하세요.

요금제와 크레딧

• Starter(월 $7): AI 도구와 API에서 보유 자산의 시장 데이터와 소셜 데이터, 하루 500회 요청.
• Standard(월 $11): 보유 종목, 손익, 자산 비중과 코인 온체인 데이터가 더해지고, 하루 1,000회 요청.
• Premium(월 $20): 같은 내용에 하루 2,000회 요청.
• Free를 포함한 모든 계정은 요청 1회당 1크레딧인 API 크레딧 100개로 시작해서, 먼저 커넥터를 써 볼 수 있어요. 추가 크레딧은 1,000개에 $1이고 만료되지 않으며, 하루 한도를 다 쓴 뒤에는 어떤 요금제에서든 쓸 수 있어요. 응답 속 소셜 데이터는 계속 요금제를 따라요.

요금을 확인하세요.

보안

API 키는 지문 형태로만 저장되고, 전체 키는 만들 때 한 번만 보여요. 키나 커넥터 URL을 가진 사람은 누구나 포트폴리오 데이터를 읽을 수 있으니 비공개로 보관하고, 유출되면 API 페이지에서 취소하세요. 그 뒤의 포트폴리오는 처음부터 읽기 전용으로 설계됐어요. 자세한 내용은 보안 페이지에 있어요.

자주 묻는 질문

Claude나 ChatGPT 무료 버전에서도 되나요?

각 어시스턴트가 사용 중인 계정에서 무엇을 허용하는지에 따라 달라요. Sonar 쪽에서는 모든 요금제에서 동작하고, Free에서는 API 크레딧을 써요.

어시스턴트가 대신 매매할 수 있나요?

아니요. 커넥터는 거래, 자금 이동, 계정 변경을 할 수 없어요. 요청한 보유 종목을 기록하는 것만 할 수 있어요.

어떤 MCP 클라이언트를 지원하나요?

Claude, ChatGPT, Claude Code, Cursor 안내가 준비돼 있고, URL이나 Bearer 토큰으로 HTTP 기반 MCP를 지원하는 클라이언트라면 연결할 수 있어요.

계좌를 연결하지 않고도 써 볼 수 있나요?

네. 종목 몇 개를 직접 입력하고 키를 만든 뒤 물어보세요. 아니면 먼저 예시 포트폴리오를 둘러보세요.