MCP로 AI 어시스턴트 연결하기

시작하기 전에

1. AlgoVesta 계정. 7일 체험이면 충분합니다 — 이를 테스트하는 데 유료 요금제는 필요 없습니다.
2. MCP 클라이언트: 웹·데스크톱·모바일의 Claude, Claude Code, Cursor, 유료 요금제의 ChatGPT, Gemini CLI, 또는 Model Context Protocol을 지원하는 다른 무엇이든 가능합니다.
3. 키. 시작하는 데 연결된 거래소가 필요하지 않습니다: paper 키는 5,000달러 가상 잔고를 대상으로 전체 도구 세트를 실행하므로, 실제 계정이 관여되기 전에 모든 것을 설정하고 연습할 수 있습니다.

1. MCP 링크 만들기

1. AlgoVesta 패널을 열고 MCP 연결 탭으로 이동하세요
2. 키 생성을 클릭하고 어디서 사용할지 알 수 있는 라벨을 붙이세요(예: claude-desktop 또는 cursor-laptop)
3. 범위를 선택하세요: 포트폴리오 조회만 하려면 read, 5,000달러 가상 잔고로 전체 도구를 사용하려면 paper, 실제 주문을 실행하려면 live
4. 표시되는 주소를 복사하세요. 다음과 같은 형식입니다:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Claude에 추가하기

1. Claude에서 설정 → 커넥터를 여세요
2. 커스텀 커넥터 추가를 클릭하세요
3. 이름을 붙이고(AlgoVesta) URL 필드에 MCP 링크를 붙여넣으세요
4. 저장한 뒤 새 대화를 시작하세요 — 대화의 도구 목록에 표시됩니다

이 커넥터는 웹, 데스크톱, 모바일의 Claude 간에 동기화되므로 한 번만 추가해도 휴대폰까지 함께 적용됩니다. 시크릿 주소를 붙여넣고 싶지 않다면, AlgoVesta는 PKCE(S256)와 동적 클라이언트 등록을 지원하는 표준 OAuth 2.1 엔드포인트도 https://api.algovesta.com/mcp에서 제공합니다 — 커넥터를 그 주소로 지정하면 일반적인 브라우저 동의 화면으로 안내됩니다.

3. Claude Code에 추가하기

명령 하나로 스트리머블 HTTP를 통해 서버를 등록합니다:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

이후 claude mcp list를 실행해 서버가 등록되고 연결 가능한지 확인하세요.

4. Cursor 또는 ChatGPT에 추가하기

Cursor는 JSON 설정 파일을 읽습니다. mcp.json에 항목을 하나 추가하세요:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI는 동일한 항목을 사용하지만 필드 이름이 url 대신 httpUrl입니다. 나머지는 모두 동일합니다.

ChatGPT는 설정에서 개발자 모드를 활성화한 유료 요금제에서 커스텀 MCP 커넥터를 지원합니다. 그곳에서 커넥터를 추가하고 동일한 링크를 붙여넣으세요.

5. 연결 확인하기

1. 클라이언트에서 새 대화를 시작하세요
2. 다음과 같이 물어보세요: How is my portfolio?
3. 어시스턴트는 get_portfolio_context 도구를 호출하여 실제 잔고와 오픈 포지션으로 답해야 합니다 — paper 키라면 5,000달러 가상 잔고 기준입니다

도구를 호출하지 않고 일반론으로 답한다면 서버가 연결되지 않은 것입니다: 어시스턴트가 귀하의 계정이 아니라 트레이딩 일반에 대해 이야기하고 있는 것입니다. 링크를 다시 확인하고 클라이언트를 재시작하세요.

연결 후 어시스턴트가 할 수 있는 일

20개 도구가 제공됩니다. 그중 14개는 읽거나 리허설할 뿐 아무것도 바꾸지 않습니다: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel, compile_policy. 6개는 씁니다: place_order, close_position, modify_position, cancel_order, create_strategy, update_strategy.

이 도구들을 이름으로 직접 호출할 필요는 없습니다. "제가 뭘 보유하고 있죠?", "지금 0.1 BTC를 사면 얼마가 들까요?", "ETH 포지션 절반을 청산해줘"처럼 평범한 언어로 물어보면 어시스턴트가 도구를 선택하고 연결해서 사용합니다. 어시스턴트가 여는 모든 포지션에는 손절매가 필수이며, 이후 이를 제거하는 도구는 존재하지 않습니다. 각 도구의 전체 스키마는 개발자 문서에 있습니다.

401 unauthorized

키가 취소되었거나 삭제되었거나 주소를 잘못 입력한 경우입니다. 링크를 손으로 붙여넣거나 끝에 공백이 포함된 채로 복사했을 때 가장 흔히 발생하는 오류입니다. MCP 연결 탭에 키가 여전히 존재하는지 확인하세요. 존재한다면 문자열을 고치려 하지 말고 삭제한 뒤 새로 만드세요.

insufficient_scope

어시스턴트가 호출하려던 도구가 키가 가진 범위보다 더 높은 범위를 요구합니다. read 키는 place_order를 호출할 수 없고, paper 키는 실제 계정에 접근할 수 없습니다. 범위에는 등급이 있으므로, paper가 필요한 도구는 read 키를 거부합니다. 이 제한을 받아들이거나, 실제로 필요한 범위로 새 키를 발급하세요 — live로 이동하려면 2단계 인증이 필요합니다.

user_frozen

계정에서 킬 스위치가 활성화되어 모든 키가 한 번에 정지된 상태입니다. 이는 의도된 동작으로, 비상 브레이크입니다. 거래를 재개하려면 패널에서 동결을 해제하세요. 하나의 클라이언트만 차단하려던 것이었다면 그 키 하나만 취소하세요 — 나머지는 계속 작동합니다.

rate_limited

해당 키에서 분당 60회 요청 한도를 초과했습니다. 비용이 큰 도구에는 더 엄격한 한도가 적용됩니다: place_order는 분당 10회, replay_channel은 시간당 5회로 제한됩니다. 잠시 기다렸다가 다시 시도하세요. 이 오류가 반복해서 나타난다면 대부분 에이전트가 루프에 빠진 것이지 빠르게 거래하고 있는 것이 아닙니다 — 요청 속도를 높이기 전에 어시스턴트가 실제로 무엇을 하고 있는지 확인해볼 가치가 있습니다.