Live release feed
Sub-second macro releases for FX backtests
Point-in-time history
USD 25/month
무료 체험 시작

Implementation

How-To Guides

FXMacroData와 Windsurf AI (MCP) 를 연결하는 방법

FXMacroData를 MCP를 통해 Windsurf AI에 연결하고 Cascade 내부에서 실시간 매크로 발표, 릴리스 캘린더 및 COT 데이터를 자연 언어로 검색합니다.

다른 언어로도 제공 English
Share article X LinkedIn Email
FXMacroData와 Windsurf AI (MCP) 를 연결하는 방법 image

이 가이드의 끝까지 당신의 윈드서프 IDE는 18개의 통화에서 거시 경제 지표 시리즈, 출시 달력, CFTC COT 위치, 귀금속 가격, FX 스팟 요금까지 실시간으로 액세스 할 수 있습니다.

당신이 성취 할 수 있는 것

  • 캐스케이드 채팅에서 매크로 질문을 하세요 EUR CPI의 최신 인쇄물입니다?, 이 다음 FED 결정은 언제입니까?
  • 노트북과 스크립트에 실시간 지표 데이터를 가져오기 윈드서프가 시리즈를 가져오면, 당신은 코딩 흐름에 머물러 있습니다
  • 연결 경로 두 개 무설치 호스팅된 MCP 엔드포인트와 로컬 파이썬 패키지를 통해 uvx

필수 조건

  • 윈드 서핑 IDE 최신 버전을 다운로드 합니다. 위드서프. (전체 MCP 지원에 1.0+ 버전이 권장됩니다.)
  • FXMacroData API 키 미국 달러 외의 데이터에 대해서는 fxmacrodata.com/subscribe (USD 데이터는 무료이며 테스트에 필요한 키는 없습니다.)
  • 컴퓨터에서 네트워크 접속 fxmacrodata.com
  • 선택 (국가 경로만): uv 설치 실행 pip install uv 보거나 docs.astral.sh/uv

윈드서프 내부의 매크로 데이터가 중요한 이유는

윈드서프에서 FX 전략 또는 매크로 모델을 만드는 것은 일반적으로 브라우저로 전환하고, 달력 사이트에서 데이터를 가져와, 번호를 메모리에 복사하고, 다시 전환하는 것을 의미합니다. FXMacroData가 MCP 서버로 윈드 서프에 연결되면, 모든 것이 사라집니다. 캐스케이드 패널에서 질문을 하면 도구 호출이 배경에서 발생하고, 결과는 대화에 도착합니다. 코드에 삽입하거나 추가 해석 할 준비가되었습니다.

윈드서프의 캐스케이드 에이전트는 가장 뛰어난 인공지능 코딩 어시스턴트 중 하나입니다. 실시간 매크로 데이터와 결합하면 하나의 프롬프트로 두 화폐의 정책율 역사를 가져와


- MCP (보증) - MCC (보험자)

경로 A MCP를 통해 연결 추천

모델 컨텍스트 프로토콜 (MCP) 윈드서프의 캐스케이드 에이전트에 외부 도구를 추가하는 원본 방법입니다. 하나의 JSON 구성 블록과 캐스캐드는 FXMacroData 서버가 노출하는 모든 도구를 자동으로 발견합니다.

1단계

단계 1 MCP 구성 파일을 열기

윈드서프는 JSON 파일로 MCP 서버 정의를 저장합니다:

~/.codeium/windsurf/mcp_config.json

이 파일을 Windsurf에서 직접 열 수 있습니다.Ctrl+Shift+P / Cmd+Shift+P그리고 찾고 있습니다. 윈드서프: MCP 구성을 열또는 윈드 서핑 설정 → MCP 그리고 클릭합니다. 구성 편집. 파일이 아직 존재하지 않는다면, 그것을 만들자.

2단계

단계 2 FXMacroData 서버 항목을 추가

FXMacroData에 대한 항목을 추가합니다. mcpServers 객체. 설정에 가장 적합한 옵션을 선택:

옵션 A 호스팅된 엔드포인트 (제로 설치, 가장 간단)

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp"
    }
  }
}

이것은 스트리밍 가능한 HTTP 전송을 사용하여 생산 FXMacroData MCP 서버에 캐스케이드를 가리키고 있습니다. ping 도구는 API 키 없이 즉시 작동합니다. USD가 아닌 통화에 대해, URL에 API 키를 첨부합니다:

{
  "mcpServers": {
    "fxmacrodata": {
      "serverUrl": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

옵션 B: 로컬 MCP 서버를 통해 uvx

로컬 프로세스를 선호하거나 네트워크가 출력 HTTP 스트리밍을 제한하는 경우 이 기능을 사용하세요. uvx 런너는 다운로드하고 실행합니다 mcp-server-fxmacrodata PyPI 패키지가 자동으로

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
안전성 Git에서 추적하는 파일로 직접 API 키를 커밋하지 마십시오. ~/.codeium/windsurf/mcp_config.json 글로벌 gitignore에, 또는 환경 변수를 참조: YOUR_API_KEY${FXMACRODATA_API_KEY} 그리고 shell 프로필에 변수를 내보냅니다.
3단계

단계 3 Windsurf MCP 서버를 다시 로드

구성 파일을 저장 한 후, MCP 서버를 다시 로드 하 여 Windsurf가 새로운 항목을 픽업 합니다. 명령 패러다임을 열기 (Ctrl+Shift+P / Cmd+Shift+P그리고 달릴거야

Windsurf: Refresh MCP Servers

아니면, 윈드 서핑 설정 → MCP 서버 목록 옆에 있는 리프레쉬 아이콘을 클릭하세요. fxmacrodata 녹색 연결 표시기와 함께 활성 서버 목록에 표시됩니다.

단계 4

단계 4 캐스케이드에서 연결을 확인

캐스케이드 패널을 열고 들어가 있는지 확인해 에이전트 모드 (편집이나 채팅이 아닌)

Run the FXMacroData ping tool.

캐스케이드 전화 ping 배경에 있는 도구. pong 응답은 서버에 접속이 가능하고 인증서가 유효하다는 것을 확인합니다. 실시간 데이터를 검색할 준비가 되었습니다.

단계 5: 사용 가능한 도구

5단계 이용 가능한 도구를 탐구하라

연결되면 Cascade는 서버가 노출하는 모든 도구를 등록합니다. 여기 전체 세트가 있습니다:

도구 그 효과 예제 프롬프트
indicator_query 모든 통화 + 지표에 대한 역사 발표 시리즈를 가져오기 AUD 정책금리율은 얼마인가요?
데이터 카탈로그 사용 가능한 지표 및 통화 목록 NZD에 대해 어떤 지표가 있습니까?
릴리스_칼란 예정된 날짜와 함께 다가오는 매크로 릴리스 이번 주에는 어떤 달러 데이터가 나올까요?
외환 선택적 기술적 덮개와 함께 FX 스팟 EUR/USD 거래 가격은 얼마입니까?
cot_data CFTC 포지셔닝 거래자의 약속 JPY의 최신 COT 보고서를 보여주세요.
상품 귀금속 가격 (금, 은, 플래티넘) 현재 금 가격은 얼마인가요?
시장_세션 라이브 FX 세션 창 (시드니, 도쿄, 런던, 뉴욕) 지금 어떤 FX 세션은 열려 있나요?
표시기_비주얼_아티팩트 지원되는 클라이언트에 대한 차트 준비 데이터 아티팩트를 생성 “Chart USD inflation over the last 2 years.”
연결이 활성화되었는지 확인합니다 FXMacroData 핑 도구를 실행합니다.

캐스케이드는 자연어 프롬프트에서 어떤 도구를 호출해야 하는지 결정합니다. 도구 이름을 지정하거나 JSON을 구성할 필요가 없습니다.

단계 6: 일 흐름 예제

단계 6 실제 분석 작업 흐름을 시도하십시오

You are building a carry-trade signal in a Python notebook and want to compare the USD–AUD policy-rate differential with AUD/USD spot movement over the last year. In Cascade Agent mode, prompt Windsurf:

지난 12개월 동안의 USD와 AUD 정책율을 가져오고, 같은 창에 AUD/USD 현금율을 뽑고, 환율과 함께 환율의 차이를 그리는 파이썬 코드를 작성합니다.

캐스케이드 전화 indicator_query 두 번 (통화당 한 번) forex 한 번, 다음 당신의 오픈 파일에 직접 플롯링 코드를 작성합니다.

# USD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/usd/policy_rate?api_key=YOUR_API_KEY"

# AUD policy rate
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"

# AUD/USD spot rate
curl "https://fxmacrodata.com/api/v1/forex/AUD/USD?api_key=YOUR_API_KEY"

대표님 indicator_query 답:

{
  "currency": "AUD",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-04-01", "val": 4.10, "announcement_datetime": 1743483000 },
    { "date": "2026-02-18", "val": 4.10, "announcement_datetime": 1739862600 },
    { "date": "2025-12-10", "val": 4.35, "announcement_datetime": 1733806200 },
    { "date": "2025-11-05", "val": 4.35, "announcement_datetime": 1730793000 }
  ]
}

정책금리와 외환 시리즈를 가지고, 캐스케이드는 당신이 하나의 HTTP 호출을 작성하지 않고도 전체 비교 차트를 구축할 수 있습니다. AUD 정책금리 지표 페이지 그리고 미국 달러 정책금리 문서 분석을 확장하려면 전체 지표 스키마를 보여주세요.

캐스케이드에서 시도할 수 있는 더 많은 것들이

  • 지난 6개월 동안의 EUR 인플레이션을 보여 주세요
  • 이번 주 GBP에 대해 어떤 거시적인 발표가 예정되어 있습니까?
  • EUR 선물에 대한 COT 순 지위는 얼마입니까?
  • 지금 FX 세션이 어떤데 겹쳐져 있나요?

하나의 프롬프트에서 도구를 결합

  • EUR CPI와 다음 ECB 달력 날짜를 가져오기
  • NZD 고용 + NZD/USD 현상 및 요약
  • 한 메시지에서 JPY에 대한 금 가격과 COT를 얻으십시오.
  • CAD의 지표 목록 및 최신 정책율을 가져오기

──────── B 경로: REST API (ALTERNATE) ─────

경로 B 직접 REST API 호출 대안

예를 들어 윈드 서퍼에서 열린 Jupyter 노트북 내부에서 또는 사용자 지정 캐스케이드 컨텍스트 제공자를 구축하는 경우 명시적인 HTTP 호출을 선호하면 REST를 통해 FXMacroData를 직접 질의 할 수 있습니다. 모든 엔드포인트에서는 질의 매개 변수 API 키를 받아 들입니다.

표시자 데이터를 가져오기

import requests

BASE = "https://fxmacrodata.com/api/v1"
KEY  = "YOUR_API_KEY"

# Latest AUD inflation series
resp = requests.get(
    f"{BASE}/announcements/aud/inflation",
    params={"api_key": KEY},
    timeout=10,
)
data = resp.json()
for row in data["data"][:5]:
    print(row["date"], row["val"])

발매 일정을 확인합니다

# Upcoming USD releases
resp = requests.get(
    f"{BASE}/calendar/usd",
    params={"api_key": KEY},
    timeout=10,
)
events = resp.json()
for event in events["data"][:3]:
    print(event["indicator"], event["release_date"])

외환 현금율을 끌어내기

# EUR/USD last 30 trading days
resp = requests.get(
    f"{BASE}/forex/EUR/USD",
    params={"api_key": KEY},
    timeout=10,
)
rates = resp.json()["data"]
print(rates[0])  # {"date": "2026-04-15", "rate": 1.1342}

사용 가능한 통화와 지표의 전체 목록은 /api-data-docs각 표시 페이지에는 정확한 최종 지점 경로, 필드 설명 및 예제 응답이 포함됩니다. 유로 인플레이션 아니면 농부 외의 USD 임금-


───────── 요약

요약

당신은 두 단계로 FXMacroData를 윈드서프에 연결했습니다. ~/.codeium/windsurf/mcp_config.json FXMacroData MCP 서버를 가리키고, ping 캐스케이드 에이전트 모드에서 호출합니다. 여기서 캐스캐드에 입력하는 매크로 질문이 실시간 데이터 호출을 유발합니다. 브라우저 탭 전환, 수동 데이터 수입이 없습니다.

빠른 시작 요약
1. 열 ~/.codeium/windsurf/mcp_config.json 윈드서프: MCP 구성을 열- 그래요
2. fxmacrodata 호스트 URL 또는 로컬로 입력 uvx 지휘관
3. 윈드서프: MCP 서버를 갱신- 그래요
4. 에이전트 캐스케이드 패널에서 모드
5. 종류 FXMacroData ping 도구를 실행하세요 연결을 확인하기 위해서요.
6. 매크로 질문을 시작하거나 Cascade가 데이터를 직접 코드로 끌어내도록 하세요.

어떤 데이터가 있는지 알아볼 준비가 되셨습니까? FXMacroData API 문서 전체 지표 카탈로그를 확인하거나 MCP 서버 참조 인증 옵션과 고급 도구 스키마를 위한 API 키가 없는 경우 가입하세요 모든 18개 통화와 전체 지표 세트를 잠금 해제합니다.

Blogroll

AI Answer-Ready

Key Facts

Page
How To Connect FXmacrodata Windsurf MCP
Section
Articles
Canonical URL
https://fxmacrodata.com/ko/articles/how-to-connect-fxmacrodata-windsurf-mcp
Source
FXMacroData editorial and official publisher references
Last Updated
2026-06-15 11:06 UTC

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

What is this page about? This page explains How To Connect FXmacrodata Windsurf MCP with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.