개요
AI assistant는 fcontext MCP server를 사용해 사용자의 fcontext 계정으로 인증되고 사용량 기반으로 과금되는 시장 데이터에 접근할 수 있습니다. 첫 버전은 실시간 시세, 정적 종목 데이터, 계산된 시세 지표, 캔들스틱, 시장 뉴스, 재무 캘린더, 변동 상위 종목 도구를 제공합니다. Remote MCP endpoint:인증
MCP server는 OAuth 2.1을 사용합니다. 대화형 MCP 클라이언트가 처음 연결되면 로그인하고 시장 데이터 접근을 승인하도록 리디렉션됩니다. MCP 클라이언트에는 API key가 필요하지 않습니다. Authorization server:market_data scope가 포함되어야 합니다.
API key는
https://openapi.fcontext.com/api/market-data의 HTTP Market Data API용입니다. 자체 서버 측 통합을 구축하는 경우가 아니라면 MCP 클라이언트는 OAuth를 사용해야 합니다.시작하기
Remote MCP server를 지원하는 클라이언트를 선택하고 fcontext endpoint를 추가하세요.- Codex Desktop
- Claude / Claude Code
- Cursor
다음 URL로 remote MCP server를 추가합니다.Codex가 요청하면 OAuth 로그인을 완료한 뒤 시장 데이터가 필요한 채팅에서 server를 활성화하세요.
MCP 도구
연결 후 AI assistant는 다음 도구를 호출할 수 있습니다.| 도구 | 설명 |
|---|---|
fcontext_get | /api/market-data 뒤의 상대 경로로 허용된 fcontext 시장 데이터 GET 엔드포인트를 호출합니다. |
fcontext_quote | 하나 이상의 심볼에 대한 실시간 시세를 가져옵니다. |
fcontext_static_info | 정적 종목 정보를 가져옵니다. |
fcontext_calc_index | 계산된 시세 지표를 가져옵니다. |
fcontext_candlestick | 심볼의 과거 캔들스틱 데이터를 가져옵니다. |
fcontext_news | 시장 뉴스를 가져옵니다. |
fcontext_finance_calendar | 재무 캘린더 이벤트를 가져옵니다. |
fcontext_top_movers | 변동 상위 종목을 가져옵니다. |
사용 예시
연결 후 AI assistant에게 다음과 같이 물어볼 수 있습니다.- “What is Apple’s latest quote?”
- “Show me one month of daily candlesticks for Nvidia.”
- “What are today’s top US market movers?”
- “Find recent news for Tesla.”
- “Check upcoming finance calendar events for this week.”
- “Compare static information for AAPL.US and MSFT.US.”
문제 해결
| 문제 | 확인할 것 |
|---|---|
| 클라이언트가 authorization metadata를 발견하지 못함 | https://openapi.fcontext.com/api/auth/.well-known/oauth-authorization-server 또는 https://openapi.fcontext.com/.well-known/oauth-authorization-server/api/auth에 접근 가능한지 확인하세요. |
MCP 요청이 401을 반환함 | MCP server를 다시 연결하고 OAuth를 다시 완료하세요. 응답에는 protected resource metadata URL을 포함한 WWW-Authenticate가 포함됩니다. |
MCP 요청이 403을 반환함 | Token은 유효하지만 market_data scope가 없습니다. 클라이언트를 다시 승인하세요. |
| 도구 호출이 경로 오류로 실패함 | fcontext_get에는 quote 또는 content/news 같은 상대 경로를 사용하세요. 절대 URL과 path traversal은 거부됩니다. |