MCP

호스티드 리서치 엔진 MCP

Cursor, VS Code와 다른 MCP 클라이언트에서 데스크와 같은 분석 작업, 관심종목, 크레딧, 모의 거래를 호출하세요. URL만 추가한 뒤 로그인하세요. 설정 파일에 토큰을 넣지 마세요.

전송
Streamable HTTP
로그인
데스크 OAuth · PKCE
도구
데스크 도구 27개

같은 데스크를 에디터에서

MCP 엔드포인트는 리서치 데스크 Node BFF에 있습니다. 도구는 같은 /api, 같은 사용자, 같은 크레딧 기준과 모의 거래 플래그를 사용합니다. 분석은 비동기입니다. 실브로커가 아니며 TradingView 시세 MCP의 복제도 아닙니다.

클릭 한 번 또는 명령 한 줄로 설치

Cursor와 VS Code는 JSON을 직접 고치지 않아도 됩니다. 다른 클라이언트는 호스티드 URL을 붙여넣습니다. 첫 연결에서 데스크 로그인과 동의 페이지가 열립니다.

원클릭

Cursor

Cursor를 열고 호스티드 서버를 추가합니다. 안내가 나오면 데스크와 같은 계정으로 로그인하세요.

Cursor에 추가

URL 붙여넣기

Claude Desktop / claude.ai

Customize → Connectors → Add custom connector. 호스티드 URL을 붙여넣은 뒤 로그인하세요.

Claude Connectors 열기 →
MCP URL
https://mcp.tradingagentsreport.com/mcp

CLI 클라이언트

명령을 복사한 뒤 클라이언트에서 데스크 로그인을 마칩니다.

Claude Code
claude mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

세션에서 /mcp를 실행하고 브라우저 로그인을 완료하세요.

Codex
codex mcp add tradingagents-report --url https://mcp.tradingagentsreport.com/mcp
codex mcp login tradingagents-report

둘째 줄이 브라우저에서 데스크를 엽니다.

Gemini CLI
gemini mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

Gemini가 인증을 요청하면 /mcp auth tradingagents-report를 실행하세요.

기타 클라이언트와 JSON

설치 링크나 CLI가 없을 때 사용합니다. 구형 클라이언트는 http 대신 streamable-http를 쓸 수 있습니다. URL은 같습니다. Authorization 헤더는 넣지 마세요. 토큰은 OAuth가 제공합니다.

mcpServers
{
  "mcpServers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Cursor: ~/.cursor/mcp.json. Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json.

VS Code · servers
{
  "servers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

워크스페이스: .vscode/mcp.json. VS Code는 mcpServers가 아니라 servers입니다.

VS Code CLI
code --add-mcp '{"name":"tradingagents-report","type":"http","url":"https://mcp.tradingagentsreport.com/mcp"}'
Windsurf
{
  "mcpServers": {
    "tradingagents-report": {
      "serverUrl": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Windsurf: ~/.codeium/windsurf/mcp_config.json. 원격 필드는 url이 아니라 serverUrl입니다.

도구가 다루는 범위

27개 도구가 데스크 API를 전달합니다. 분석 작업은 비동기로 유지됩니다. 시세와 뉴스는 데스크 스냅샷이며 전체 지표 팩이 아닙니다. 모의 주문은 수수료로 제품 크레딧을 차감하며 증권사로 가지 않습니다.

분석 작업

티커를 제출하고 진행률을 확인한 뒤 결정 카드와 보고서를 읽고, 기록을 보거나 취소합니다. 시작 전에 크레딧을 확인합니다.

시세 스냅샷

상장을 해석한 뒤 시세, OHLCV, 세션, 뉴스, 회사 식별을 가져옵니다. 재무제표는 완료된 보고서에 있습니다.

관심종목

로그인한 사용자의 관심종목을 나열·추가·삭제합니다. 추가는 티커만으로 상장을 해석할 수 있습니다.

크레딧과 플랜

주기/보너스 잔액, 청구서, 새 분석을 시작할 수 있는지 조회합니다. 결제는 브라우저에 남습니다.

모의 거래

모의 계좌 개설, 자산과 체결 조회, 출석, 주문과 취소. 기능 플래그가 있습니다. 실주문이 아닙니다.

리서치

resolve_listing

Normalize a ticker into exchange, symbol, and provider_symbol.

리서치

start_analysis

Submit an async research job and return its id immediately.

리서치

get_analysis

Job status and progress. Use get_analysis_report after success.

리서치

get_analysis_events

Stage timeline for a running or finished job.

리서치

get_analysis_report

Decision card and report sections after the job succeeded.

리서치

list_analyses

List the signed-in user's recent analysis jobs.

리서치

cancel_analysis

Request cancellation of a queued or running job.

크레딧

estimate_analysis

Check whether credits cover the start threshold.

시세

get_quote

Latest quote for an EXCHANGE:SYMBOL ticker.

시세

get_ohlcv

OHLCV bars. Timeframe defaults to D.

시세

get_ta_summary

Snapshot of last price, session, and identity. Not a full TA pack.

시세

get_news

Recent news headlines for a ticker.

시세

get_fundamentals

Company name, exchange, and logo. Statements are on reports.

관심

list_watchlist

List watchlist rows for the signed-in user.

관심

add_watchlist_item

Add a listing. A ticker is enough; the tool resolves the rest.

관심

remove_watchlist_item

Remove a watchlist row by id.

크레딧

get_usage

Period credits, bonus credits, and this cycle's ledger.

크레딧

get_subscription

Current plan, pending change, and invoices. Read-only.

모의

open_paper_account

Open the default $10,000 simulated account, or return it.

모의

get_paper_account

Cash, equity, P&L, and open positions.

모의

list_paper_orders

Paper orders for the default or given account.

모의

list_paper_fills

Paper fills (executions).

모의

list_paper_cash_ledger

Opening grant, check-in, and cash adjustments.

모의

get_paper_checkin

Daily simulated-USD check-in status.

모의

claim_paper_checkin

Claim today's simulated-USD check-in.

모의

place_paper_order

Place a simulated market or limit order. Not a live broker.

모의

cancel_paper_order

Cancel a pending or triggered paper order.

어시스턴트에게 이렇게 물어보세요

로그인 후 재시작은 보통 필요 없습니다. 도구에 맞는 프롬프트를 쓰세요.

  • 오늘 NASDAQ:AAPL을 시장, 뉴스, 펀더멘털로 분석해 줘.
  • 내 관심종목과 미청산 모의 포지션이 있는 종목은?
  • 크레딧이 얼마나 남았고, 분석 두 개를 시작할 수 있어?
  • HKEX:700 최신 시세와 최근 뉴스를 줘.
  • 필요하면 모의 계좌를 열고 현금과 자산을 보여 줘.
  • NASDAQ:AAPL 10주를 시장가로 모의 매수해.

데스크에서 로그인

첫 연결에서 리서치 데스크 로그인 후 동의 페이지가 열립니다. 웹 데스크와 같은 계정을 사용합니다. Clerk Dashboard의 OAuth applications나 Dynamic Client Registration은 필요 없습니다. 내장 브라우저로 로그인되지 않으면 링크를 시스템 브라우저에 복사하세요.

이 MCP가 하지 않는 일

호스티드 MCP는 데스크 어댑터이며 제품 한계를 따릅니다.

  • 실제 증권사 주문을 내지 않고 실자금을 보유하지 않습니다.
  • Stripe Checkout이나 고객 포털을 시작하지 않습니다.
  • 관리자, 큐, API 키 도구는 노출하지 않습니다.
  • 모의 거래가 꺼져 있으면 해당 도구는 PAPER_FEATURE_DISABLED를 반환합니다.
  • 분석은 웹 데스크와 같은 크레딧 장부를 사용합니다.

더 깊은 시세, 스크리너, 캘린더가 필요하면 TradingView MCP와 함께 쓰세요. 이 엔드포인트는 리서치 엔진이며 두 번째 시세 MCP가 아닙니다. TradingView MCP

MCP FAQ

호스티드 MCP에 대한 자주 묻는 질문

MCP 설정에 API 키를 넣어야 하나요?

아니요. Cursor, VS Code, CLI는 URL만 추가합니다. 데스크 로그인이 단기 액세스 토큰을 발급합니다. Clerk, Stripe, Core 키를 붙여 넣지 마세요.

어떤 계정이 쓰이나요?

브라우저 데스크와 같은 계정입니다. 관심종목, 작업, 크레딧, 모의 거래는 그 사용자 데이터입니다.

분석 작업은 MCP에서 어떻게 돌아가나요?

start_analysis는 id를 즉시 반환합니다. succeeded가 될 때까지 get_analysis를 폴링한 뒤 get_analysis_report를 호출하세요. 시작 호출을 완성된 보고서로 보지 마세요.

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

모의 주문만 가능하고, 모의 거래가 켜져 있을 때만입니다. 수수료는 제품 크레딧에서 차감됩니다. 증권사로 보내지 않습니다.