How to Use FXMacroData with Cline AI in VS Code (MCP)

Pada akhir panduan ini, ekstensi Cline AI Anda akan memiliki akses langsung ke seri indikator makroekonomi, kalender rilis, posisi CFTC COT, harga logam mulia, dan kurs spot FX di 18 mata uang semuanya dapat ditanyakan dalam bahasa Inggris sederhana dari dalam VS Code tanpa meninggalkan editor Anda.

Jalan A Hubungkan melalui MCP Direkomendasikan

Model Protokol Konteks (MCP) adalah cara asli untuk menambahkan alat eksternal ke Cline. Satu blok konfigurasi dan Cline secara otomatis menemukan setiap alat yang server FXMacroData mengekspos tidak ada definisi skema, tidak ada boilerplate HTTP.

Langkah 1 Buka panel pengaturan Cline MCP

Cline menyimpan konfigurasi server MCP dalam file JSON yang dapat Anda edit langsung dari ekstensi. Server MCP ikon (plug icon) di bagian atas panel. Kemudian klik Edit Config (atau Mengkonfigurasi Server MCP) untuk membuka file pengaturan.

File konfigurasi berada di:

# macOS
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Linux
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Windows
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Langkah 2 Tambahkan server FXMacroData MCP

Di dalam file konfigurasi Anda akan menemukan tingkat atas mcpServers Tambahkan entri FXMacroData menggunakan salah satu dari dua opsi di bawah ini.

Opsi A Endpoint host (tidak ada instalasi, paling sederhana)

Points Cline pada server MCP produksi FXMacroData menggunakan transportasi HTTP Streamable. ping Untuk mata uang non-USD tambahkan kunci API Anda ke URL.

{
  "mcpServers": {
    "FXMacroData": {
      "type": "streamableHttp",
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Pilihan B Server MCP lokal melalui uvx

Gunakan ini jika Anda lebih memilih proses lokal atau jika jaringan Anda membatasi streaming HTTP keluar. uvx Runner mengunduh dan menjalankan mcp-server-fxmacrodata Paket PyPI secara otomatis. env Blok akan memberikan kunci API Anda ke server.

{
  "mcpServers": {
    "FXMacroData": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Langkah 3 Simpan dan isi ulang Cline

Setelah menyimpan file konfigurasi, Cline mengambil server baru secara otomatis. Jika tidak muncul dalam daftar MCP Server segera, muat ulang ekstensi dengan mengklik Perbarui ikon di panel MCP Server, atau restart VS Code.

Setelah dimuat, entri server FXMacroData harus muncul dengan indikator status koneksi hijau di panel Cline MCP Servers.

Langkah 4 Memverifikasi koneksi dengan ping

Buka chat Cline baru dan ketik:

Run the FXMacroData ping tool.

Cline memanggil ping alat di latar belakang. pong respon mengkonfirmasi server dapat dihubungi dan kredensial Anda valid. Anda siap untuk menanyakan data langsung.

Langkah 5 Jelajahi alat yang tersedia

Setelah terhubung, Cline mendaftar semua alat yang diekspos server.

Cline memutuskan alat mana yang akan dipanggil dari prompt bahasa alami Anda. Anda tidak perlu menentukan nama alat atau membangun JSON hanya mengajukan pertanyaan.

Langkah 6 Cobalah alur kerja analis yang sebenarnya

Anda sedang membangun sinyal carry-trade di notebook Python dan ingin membandingkan perbedaan kebijakan-tingkat USDAUD dengan pergerakan spot AUD/USD selama setahun terakhir.

Membawa nilai kebijakan USD dan AUD selama 12 bulan terakhir, kemudian menarik nilai spot AUD/USD untuk jendela yang sama dan menulis kode Python untuk memetakan perbedaan nilai di samping nilai tukar.

Cline memanggil. indicator_query dua kali (satu kali per mata uang) dan forex Setelah itu, tulis kode plot langsung ke file terbuka Anda.

# 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"

Perwakilan indicator_query Jawaban:

{
  "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 }
  ]
}

Dengan kebijakan-tingkat dan seri forex di tangan, Cline dapat perancah grafik perbandingan penuh tanpa Anda menulis panggilan HTTP tunggal. Halaman indikator suku bunga kebijakan AUD Dan Dokumen suku bunga kebijakan USD menunjukkan skema indikator lengkap jika Anda ingin memperluas analisis.

Jalan B panggilan API REST langsung Alternatif

Jika Anda lebih suka panggilan HTTP eksplisit misalnya di dalam buku catatan Jupyter yang dijalankan melalui VS Code, atau saat membangun penyedia konteks kustom Anda dapat menanyakan FXMacroData langsung melalui REST. Semua endpoint menerima kunci API parameter kueri.

Mengambil data indikator

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"])

Memeriksa kalender rilis

# 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"])

Pembuangan nilai spot FX

# 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}

Daftar lengkap mata uang dan indikator yang tersedia dapat dilihat di /api-data-docsSetiap halaman indikator mencakup jalur titik akhir yang tepat, deskripsi lapangan, dan contoh tanggapan misalnya Inflasi EUR atau USD non-perhutanan gaji.

Ringkasan

Anda telah kabel FXMacroData ke Cline AI dalam dua langkah: menambahkan server FXMacrodata MCP ke pengaturan Clines JSON dan mengkonfirmasi koneksi dengan ping Dari sini, setiap pertanyaan makro yang Anda ketik di Cline chat memicu panggilan data langsung tidak ada tab browser-switching, tidak ada impor data manual.

Siap untuk menjelajahi data apa yang tersedia? FXMacroData API dokumen Untuk katalog indikator lengkap, atau periksa Referensi server MCP Jika Anda belum memiliki kunci API, Langganan untuk membuka semua 18 mata uang dan set indikator lengkap.