AI 어시스턴트 연결
Claude, ChatGPT, Claude Code, Cursor에 보유 자산을 묻거나, 채팅으로 포지션을 추가하세요.
웹, 데스크톱, 모바일의 모든 Claude 요금제에서 쓸 수 있어요. 무료 요금제에는 커스텀 커넥터 1개가 포함돼요.
설정 중에 Sonar에 로그인해요. 계정이 없나요? 무료로 만들기.
서버 URLhttps://sonarfolio.com/api/mcpCustomize를 열고 Connectors를 선택하세요.
Claude 커넥터 열기(새 탭에서 열림)+ Add, Add custom connector를 차례로 선택하세요. 이름을 Sonar로 하고 서버 URL을 붙여넣으세요.
물어보면 Sign in now와 Use Claude's published identity를 선택하고, 클라이언트 ID와 시크릿 없이 Add를 선택하세요.
Connect를 선택하고 로그인한 뒤 허용을 선택하세요. 채팅에서 +, Connectors를 차례로 선택해 켜세요.
내 포지션 중 가장 큰 다섯 개는 뭐야?웹의 ChatGPT를 사용하세요. 커스텀 MCP 서버는 ChatGPT 요금제에 따라 다르며, Business와 Enterprise에서는 관리자가 허용해야 할 수 있어요.
설정 중에 Sonar에 로그인해요. 계정이 없나요? 무료로 만들기.
서버 URLhttps://sonarfolio.com/api/mcpPlugins를 여세요.
ChatGPT 플러그인 열기(새 탭에서 열림)+, Add custom MCP server를 차례로 선택하세요. 이름을 Sonar로 하고 서버 URL을 붙여넣으세요.
Authentication을 OAuth로 설정하고 클라이언트 ID와 시크릿은 비워 두세요. 경고를 수락한 뒤 Create as a plugin을 선택하세요.
요청이 오면 로그인하고 허용을 선택하세요. 그다음 플러그인에서 설치하고 채팅에서 @를 입력하세요.
내 포지션 중 가장 큰 다섯 개는 뭐야?ChatGPT는 포지션을 추가하기 전에 확인을 요청해요.
Claude Code, Cursor처럼 헤더를 쓰는 클라이언트용이며, API 키를 사용해요.
무료 계정을 만든 다음 키를 만드세요. 키는 한 번만 표시돼요.
API 키 받기클라이언트에 Sonar를 추가하세요.
Claude Codeclaude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY"
Cursor: ~/.cursor/mcp.json{ "mcpServers": { "sonar": { "url": "https://sonarfolio.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }기타 MCP 클라이언트: Streamable HTTP, 헤더 Authorization: Bearer YOUR_KEYhttps://sonarfolio.com/api/mcpClaude Code에서
/mcp를 실행해 연결을 확인하세요.
키 없이도 돼요. 헤더 없이 URL을 추가하고 /mcp를 실행한 뒤 Sonar를 고르고 Authenticate를 선택하세요.
내 포지션 중 가장 큰 다섯 개는 뭐야?커넥터는 보유한 자산만 볼 수 있어요. 설명한 포지션을 추가할 수는 있지만, 거래하거나 자금을 옮기거나 무언가를 삭제할 수는 없어요.
문제 해결
연결되지 않거나 도구가 보이지 않아요
URL이 /api/mcp로 끝나는지, 로그인이 허용으로 끝났는지 확인하세요. 그래도 안 되면 Sonar를 제거하고 다시 추가하세요.
어시스턴트가 요금제나 크레딧이 필요하다고 해요
요금제에 따라 어시스턴트가 보는 범위가 정해지고, 도구 호출 1번이 요청 1회예요. 요청과 크레딧은 API 및 AI 도구에서 확인하세요.
앱 연결을 해제했거나 키를 폐기했어요
접근이 즉시 중단돼요. 다시 연결하려면 Sonar를 제거하고 다시 추가한 뒤 로그인하세요.
Team 또는 Enterprise 요금제의 Claude를 사용해요
소유자가 서버 URL로 Sonar를 한 번 추가하고, 각 멤버는 자기 계정에 로그인해요.
REST API
Bearer 키를 쓰는 HTTPS 기반 JSON이에요. 모든 엔드포인트에 대응하는 MCP 도구와 CLI 명령이 있어요.
curl https://sonarfolio.com/api/v1/assets \ -H "Authorization: Bearer YOUR_KEY"
- GET/api/v1/meMCPget_usageCLIsonar status요금제, 접근 권한, 오늘 사용량Starter
- GET/api/v1/assetsMCPlist_held_assetsCLIsonar assets보유한 각 자산의 시장 및 소셜 데이터Starter
- GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>보유 자산 하나: 시세, 소셜, 상위 크리에이터, 90일 종가Starter
- GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>자산 ID 찾기 (이름만)Starter
- GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolio합계, 24시간 변동, 손익, 자산 배분, 변동 상위Standard
- GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]계정별 모든 보유 내역Standard
- POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]포지션 추가: { asset_id, quantity, cost_usd?, date?, account? }데이터를 기록해요. MCP 클라이언트에는 destructive로 표시되고, CLI는 먼저 확인을 요청해요(--yes로 건너뜀).Starter
응답에는 출처, 타임스탬프, 고지 사항과 함께 X-RateLimit-Limit, -Remaining, -Reset, X-Credits-Remaining 헤더가 들어 있어요. 오류: { error: { code, message } }.
명령줄
같은 키로 터미널과 스크립트에서 같은 데이터를 써요.
설치하고 로그인하기
npm install -g sonarfolio sonar login
Node 18 이상이 필요해요. sonar login은 API 및 AI 도구에서 받은 키를 저장해요. 스크립트와 CI에서는 대신 SONAR_API_KEY를 설정하세요.
기타 설치 옵션
업데이트하려면 설치를 다시 실행하세요. 설치 없이 써 보기: npx -p sonarfolio sonar status. 이 사이트에서 설치: npm install -g https://sonarfolio.com/cli/latest.tgz. 키는 나만 읽을 수 있는 ~/.config/sonar/config.json에 저장돼요.
명령어
명령은 REST 엔드포인트와 함께 나와 있고, sonar watch [portfolio|assets]로 일일 한도 안에서 실시간 보기를 띄울 수 있어요.
스크립트에서
sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'모든 명령은 --json을 받아 API의 JSON을 출력해요.
한도와 크레딧
API 호출, MCP 도구 호출, CLI 명령 하나가 각각 요청 1회예요. 일일 한도는 00:00 UTC에 초기화돼요.
| 요금제 | 포함된 요청 | 범위 |
|---|---|---|
| Free | API 크레딧만 | 가격과 포트폴리오 |
| Starter | 하루 500회 | 가격, 소셜 데이터, 포지션 추가 |
| Standard | 하루 1,000회 | 보유 내역, 손익, 자산 배분, 온체인 데이터 추가 |
| Premium | 하루 2,000회 | 보유 내역, 손익, 자산 배분, 온체인 데이터 추가 |
엔드포인트 목록의 요금제 이름은 요청이 포함되는 곳을 나타내요. 그 밖에는 모든 요금제에서 API 크레딧으로 결제돼요. $1에 1,000개, 크레딧은 만료되지 않고, 모든 계정은 100개로 시작해요.