How to Connect FXMacroData to Claude / Claude Desktop (MCP)

Pada akhir panduan ini Claude Desktop akan memiliki akses langsung ke seri indikator makroekonomi, kalender rilis bank sentral, posisi CFTC COT, harga logam mulia, dan nilai spot FX di 18 mata uang semua dapat ditanyakan dalam bahasa Inggris sederhana dari percakapan Claude Desktops Anda.

Jalan A Hubungkan melalui MCP Direkomendasikan

Model Protokol Konteks (MCP) adalah mekanisme asli Claude Desktop untuk terhubung ke sumber data eksternal. Satu blok konfigurasi JSON dan Claude secara otomatis menemukan setiap alat yang diekspos server FXMacroData tidak diperlukan definisi skema, tidak ada boilerplate HTTP.

Langkah 1 Buka file konfigurasi Claude Desktop

Claude Desktop membaca konfigurasi server MCP dari file JSON yang disimpan di jalur tetap pada mesin Anda. Buka (atau buat) file di lokasi untuk sistem operasi Anda:

Di macOS Anda dapat membuka file langsung dari Terminal:

open -a "TextEdit" ~/Library/Application\ Support/Claude/claude_desktop_config.json

Jika file belum ada, buatlah file tersebut. Jika file tersebut sudah ada dan berisi entri server MCP lainnya, Anda akan menambahkan blok FXMacroData di sampingnya jangan menghapus entri yang ada.

Langkah 2 Tambahkan blok server FXMacroData MCP

Pasang JSON berikut ke dalam claude_desktop_config.json, menggantikan YOUR_API_KEY dengan kunci FXMacroData Anda yang sebenarnya:

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

- Apa? uvx perintah download dan menjalankan mcp-server-fxmacrodata Paket PyPI secara otomatis setiap kali Claude Desktop dimulai tidak ada manual pip install dibutuhkan.

Jika file konfigurasi Anda sudah memiliki mcpServers kunci dengan server lain, menggabungkan fxmacrodata blok ke objek yang ada:

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

Langkah 3 Restart Claude Desktop

Tamat sepenuhnya dan buka kembali Claude Desktop sehingga mengambil konfigurasi baru.

osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude

Pada Windows, klik kanan ikon Claude di sistem tray, pilih Berhentilah, lalu relancet Claude dari menu Start.

Setelah restart, Claude Desktop akan meluncurkan uvx mcp-server-fxmacrodata Subprocess di latar belakang. uv belum diinstal pada komputer Anda, Claude mungkin menunjukkan kesalahan; install uv Pertama dengan pip install uv dan kemudian restart Claude.

Langkah 4 Memverifikasi koneksi

Mulai percakapan baru di Claude Desktop dan ketik:

Gunakan alat ping FXMacroData untuk memeriksa koneksi.

Claude akan menelepon ping Alat. pong jawaban dalam jawaban Claude mengkonfirmasi server MCP berjalan dan dapat dihubungi. Jika Claude mengatakan alat tidak tersedia, periksa kembali bahwa JSON tersebut valid (tidak ada koma terakhir, tanda kurung yang benar) dan bahwa Claude Desktop sepenuhnya di-restart.

Langkah 5 Jelajahi alat yang tersedia

Setelah terhubung, Claude dapat memanggil alat FXMacroData berikut secara langsung:

Claude memutuskan alat mana yang akan dipanggil dari prompt bahasa alami Anda Anda tidak perlu memberi nama alat atau menulis JSON. Hanya mengajukan pertanyaan makro Anda dan Claude menangani pengiriman alat secara otomatis.

Langkah 6 Cobalah alur kerja analis yang sebenarnya

Anda sedang meninjau potensi carry trade pada GBP/JPY menjelang keputusan Bank of England berikutnya.

Membawa suku bunga kebijakan GBP dan JPY selama 12 bulan terakhir, menunjukkan kepada saya suku bunga spot GBP/JPY selama jendela yang sama, dan meringkas perbedaan carry dan bank sentral yang terlihat lebih agresif menuju kuartal berikutnya.

Claude menelepon. indicator_query dua kali (satu kali per mata uang) dan forex REST yang mendasari panggilan yang kembali ini panggilan alat adalah:

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

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

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

Perwakilan indicator_query Jawaban:

{
  "currency": "GBP",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-03-20", "val": 4.50, "announcement_datetime": 1742482200 },
    { "date": "2026-02-06", "val": 4.50, "announcement_datetime": 1738836000 },
    { "date": "2025-11-07", "val": 4.75, "announcement_datetime": 1731002400 },
    { "date": "2025-08-01", "val": 5.00, "announcement_datetime": 1722506400 }
  ]
}

Dengan tingkat kebijakan dan seri spot di tangan, Claude menghasilkan analisis carry berdasarkan data saat ini daripada pengetahuan yang tersusun dari pelatihan. Docs suku bunga kebijakan GBP Dan Dokumen suku bunga kebijakan JPY menunjukkan skema indikator lengkap jika Anda ingin memperluas analisis lebih lanjut.

Jalan B panggilan API REST langsung Alternatif

Jika Anda lebih suka untuk memberi makan FXMacroData langsung ke dalam perintah sistem Claude, menggunakannya di dalam skrip Python yang memanggil Claude API, atau bereksperimen dengan data sebelum mengatur MCP, REST API adalah jalur yang paling sederhana. Setiap titik akhir menerima kunci API parameter kueri.

Mengambil data indikator dengan Python

import requests

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

# Latest EUR inflation series
resp = requests.get(
    f"{BASE}/announcements/eur/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"])

Menambahkan data langsung ke panggilan Claude API

Anda dapat mengambil data dari FXMacroData di Python dan kemudian lulus ke Claude melalui SDK Anthropic sebagai bagian dari pesan pengguna:

import anthropic
import requests

BASE    = "https://fxmacrodata.com/api/v1"
FX_KEY  = "YOUR_FXMACRODATA_API_KEY"
ANT_KEY = "YOUR_ANTHROPIC_API_KEY"

# Pull the latest USD non-farm payrolls
resp  = requests.get(f"{BASE}/announcements/usd/non_farm_payrolls",
                     params={"api_key": FX_KEY}, timeout=10)
nfp   = resp.json()["data"][:6]

client   = anthropic.Anthropic(api_key=ANT_KEY)
message  = client.messages.create(
    model   = "claude-opus-4-5",
    max_tokens = 1024,
    messages = [{
        "role":    "user",
        "content": f"Here are the last six USD non-farm payroll readings: {nfp}. "
                   "Summarise the trend and tell me what this implies for the Fed outlook.",
    }],
)
print(message.content[0].text)

Daftar penuh mata uang dan indikator yang didukung dapat dilihat di /api-data-docsMisalnya, USD non-perhutanan gaji Dan Inflasi EUR halaman termasuk jalur titik akhir yang tepat, deskripsi lapangan, dan contoh tanggapan.

Ringkasan

Anda telah kabel FXMacroData ke Claude Desktop dalam tiga langkah: dibuka claude_desktop_config.json, menambahkan blok server FXMacroData MCP dengan uvx, dan mengkonfirmasi hubungan dengan ping Dari sini setiap pertanyaan makro yang Anda tanyakan di Claude Desktop memicu panggilan data langsung tidak ada tab browser-switching, tidak ada impor data manual, tidak angka latihan-set basi.

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.