AI 도구로 포트폴리오 제출하기 MCP 서버

Claude · ChatGPT · Cursor · Claude Code · Gemini CLI 같은 AI 도구에 이 플랫폼을 MCP(Model Context Protocol) 서버로 연결하면, AI가 시세를 조회하고 종목을 스크리닝해 비중표를 만들고 규칙 검사를 거쳐 대화 한 번으로 제출까지 할 수 있습니다. 설치할 것은 없습니다 — 주소 하나를 도구에 등록하면 됩니다.

1. 연결 주소

토큰 없이 연결하면 조회·스크리닝·규칙 검사까지 됩니다. 실제 제출과 내 기록 조회에는 계정 페이지의 개인 토큰이 필요합니다 — 주소 뒤에 ?token=으로 붙이거나(가장 간단), 도구가 지원하면 Authorization: Bearer 헤더로 넣습니다.

https://faip-gateway.juho-2b6.workers.dev/mcp

토큰 포함 주소 (제출 가능) — 로그인 상태면 내 토큰이 자동으로 채워집니다

https://faip-gateway.juho-2b6.workers.dev/mcp?token=faip-닉네임-…

토큰이 든 주소는 비밀번호와 같습니다. 그 주소를 아는 사람(또는 AI 세션)은 내 이름으로 제출할 수 있습니다. 공유 문서·스크린샷·공용 PC의 도구 설정에 남기지 마세요. 유출이 의심되면 관리자에게 토큰 재발급을 요청하세요.

2. 도구별 연결 방법

설정 → 커넥터(Connectors) → 커스텀 커넥터 추가. 이름은 FAIP, 원격 MCP 서버 URL에 아래 주소를 넣고 저장. 인증(OAuth)은 "없음"으로 두면 됩니다 — 토큰은 URL에 들어 있습니다. 저장 후 새 대화의 도구(+) 메뉴에서 FAIP를 켜고 대화하세요. 무료 요금제는 커스텀 커넥터가 제한될 수 있습니다.

https://faip-gateway.juho-2b6.workers.dev/mcp?token=faip-닉네임-…

터미널에서 한 줄. 헤더 방식이라 URL에 토큰이 남지 않습니다(--scope user를 붙이면 모든 프로젝트에서 사용).

claude mcp add --transport http faip https://faip-gateway.juho-2b6.workers.dev/mcp --header "Authorization: Bearer faip-닉네임-…"

확인: claude mcp list → 대화에서 "FAIP 규칙 알려줘"로 시작.

설정 → 커넥터 → 고급 → 개발자 모드 켜기 → 커넥터 만들기: 이름 FAIP, MCP 서버 URL 아래 주소, 인증 "없음". 대화에서 도구 메뉴로 FAIP를 선택하면 됩니다. (개발자 모드는 Plus/Pro/Business 등에서 제공되며, 설정 화면 명칭은 버전에 따라 조금 다를 수 있습니다.)

https://faip-gateway.juho-2b6.workers.dev/mcp?token=faip-닉네임-…

프로젝트의 .cursor/mcp.json(또는 전역 ~/.cursor/mcp.json)에 추가 → 설정 → MCP 에서 켜기.

{ "mcpServers": { "faip": { "url": "https://faip-gateway.juho-2b6.workers.dev/mcp", "headers": { "Authorization": "Bearer faip-닉네임-…" } } } }

~/.gemini/settings.json 에 추가.

{ "mcpServers": { "faip": { "httpUrl": "https://faip-gateway.juho-2b6.workers.dev/mcp", "headers": { "Authorization": "Bearer faip-닉네임-…" } } } }

워크스페이스 .vscode/mcp.json 에 추가 → Copilot 채팅을 Agent 모드로.

{ "servers": { "faip": { "type": "http", "url": "https://faip-gateway.juho-2b6.workers.dev/mcp", "headers": { "Authorization": "Bearer faip-닉네임-…" } } } }

3. AI가 쓸 수 있는 도구

도구	하는 일	토큰
`faip_get_rules`	규칙 · 유니버스 235종목(이름·섹터) · 현재 시즌 · 이번 제출이 적용되는 주 · 마감	불필요
`faip_rank_universe`	유니버스 전체를 최근 수익률로 순위 매김(모멘텀 스크리닝, 섹터 필터, 역순 가능) + SPY 대비	불필요
`faip_get_prices`	지정 종목 종가 요약(5/20/60/120일 수익률·변동성), 필요하면 일별 시계열	불필요
`faip_validate_portfolio`	비중표 규칙 검사 — 저장·채점 없음, 몇 번이든 안전	불필요
`faip_submit_portfolio`	실제 제출(다음 월요일 리밸런싱 주문, 마지막 제출만 인정)	필요
`faip_submit_forecast`	예측 트랙(선택) 5분위 확률 제출	필요
`faip_my_status`	내 제출·채점 기록, 다음 유효주	필요
`faip_get_leaderboard` · `faip_get_seasons`	시즌 리더보드(상위 30) · 시즌 목록과 명예의 전당	불필요

차트 퀴즈는 일부러 빠져 있습니다 — AI가 대신 풀면 대회의 의미가 없기 때문입니다. 서버 안내문(instructions)에는 "제출 전 반드시 규칙 검사 → 사용자에게 비중표와 근거를 보여주고 확인받은 뒤 제출"이 적혀 있어, AI 도구는 기본적으로 확인을 거칩니다.

4. 이렇게 말해 보세요

1규칙 파악"FAIP 대회 규칙이랑 이번 주 마감 알려줘. 섹터별로 유니버스에 어떤 종목이 있어?"

2전략 → 검사"최근 12주 모멘텀 상위 10종목을 뽑아서 동일비중 총노출 0.8 포트폴리오를 만들고, 규칙 검사까지 해 줘. SPY보다 변동성이 큰 종목은 비중을 반으로."

3확인 후 제출"근거 요약해서 보여주고, 내가 OK 하면 제출해. 제출 뒤 내 상태 확인해 줘."

AI는 도구로 얻은 실제 시세만 씁니다. 그래도 최종 판단과 제출 승인은 참가자의 몫입니다 — 리더보드에 남는 이름은 AI가 아니라 여러분입니다.

5. 연결 테스트

브라우저에서 바로 서버를 두드려 봅니다. 토큰 칸을 비우면 조회 도구만, 채우면 내 상태까지 확인합니다. 어떤 버튼도 제출을 만들지 않습니다.

FAIP — Finance AI Platform · 교육·연구용 플랫폼입니다. 본 사이트의 어떤 내용도 투자 권유가 아니며, 실거래 주문·송금 자동화를 지원하지 않습니다(검증·백테스트 전용).
리더보드 · 차트 퀴즈 · 대회 참가 · 제출 가이드 · faip-client (파이썬) ↗