7.7

🤖 AI 통합 — Claude 및 ChatGPT 연결

단계별: sTraderZ.com 계정에 Claude, ChatGPT 및 Claude Code CLI 연결

1. 사전 요구 사항

AI 통합은 Basic 플랜 이상에서 이용 가능합니다(무료 플랜에서는 불가). AI 클라이언트를 OAuth를 통해 sTraderZ.com 계정에 연결합니다 — 클라이언트는 트레이딩 데이터에 대한 읽기 전용 액세스만 얻습니다.

MCP 엔드포인트
https://straderz.com/api/mcp.php

⚠️ URL은 정확히 이 형식이어야 합니다 — .php 포함, 끝에 슬래시 없음.

💎

Basic 플랜부터

무료 플랜에서는 이용 불가.

👁️

읽기 전용

read 스코프 — 거래 실행 없음.

🔓

언제든지 취소 가능

계정 페이지 「AI 통합」.

처음 연결 시 인증 대화 상자가 열립니다. 거기서 read 스코프를 확인합니다. 기존 연결은 계정 페이지 AI 통합에서 언제든지 확인하고 취소할 수 있습니다.

2. Claude (claude.ai) 연결

🤖
Claude · claude.ai
MCP 커넥터
  1. claude.ai 열기 → SettingsIntegrationsAdd more
  2. 「MCP Server URL」 필드에 입력: https://straderz.com/api/mcp.php
  3. Connect 클릭 → 브라우저가 sTraderZ.com 로그인/동의 페이지를 엽니다
  4. read 스코프 확인 (7개 도구에 대한 읽기 액세스)
  5. claude.ai로 돌아오면 서버가 활성으로 표시됨 → 채팅에서 테스트: 「최근 5개 거래를 보여줘」
중요: URL은 정확히 https://straderz.com/api/mcp.php이어야 합니다(.php 포함, 끝에 슬래시 없음).

3. ChatGPT (Custom GPT) 연결

💬
ChatGPT · Custom GPT
OpenAPI Actions

ChatGPT Custom GPT는 OpenAPI/Actions(MCP/JSON-RPC 아님)를 사용합니다. 이를 위한 별도의 REST 어댑터가 있습니다 — Claude용 MCP 엔드포인트는 영향을 받지 않습니다.

  1. ChatGPT 열기 → Explore GPTsCreateConfigure 탭 → Add actions
  2. 「Schema」 필드에 URL 입력: https://straderz.com/api/mcp-openapi-schema.php
  3. Authentication → OAuth:
    • Client ID + SecretsTraderZ 관리 페이지에서 복사
    • Authorization URLhttps://straderz.com/oauth/authorize.php
    • Token URLhttps://straderz.com/oauth/token.php
    • Scoperead
  4. 저장 → GPT 채팅에서 테스트
참고: ChatGPT Actions는 platform.openai.com의 인증된 계정이 필요합니다.

4. Claude Code CLI 연결

💻
Claude Code CLI
로컬 MCP 서버

~/.claude/settings.json 설정:

settings.json
{"mcpServers":{"straderz":{"type":"http","url":"https://straderz.com/api/mcp.php","headers":{"Authorization":"Bearer <your-access-token>"}}}}
토큰 획득: 브라우저에서 OAuth 흐름을 진행하세요. 토큰은 90일간 유효합니다.

확인:

bash
claude mcp list
# → straderz: https://straderz.com/api/mcp.php (connected)

5. 이용 가능한 도구 (참조)

✅ 7개 읽기 도구 · read 스코프만

모든 도구는 읽기 전용입니다. 거래 실행 없음.

도구Scope설명
list_accountsread연결된 모든 브로커 계정
get_portfolio_overviewread전체 포트폴리오, 포지션, 수익
list_positionsread계정별 오픈 포지션
list_tradesread최신 N개 거래 (필터 포함)
get_trade_detailread거래 사이클의 전체 세부 정보
get_performanceread성과 지표 (기간 선택 가능)
get_tax_reportread세금 보고서 요약 (평가 연도 선택 가능)