Twelve Data

Server MCP Twelve Data

Hubungkan Claude, ChatGPT, dan asisten AI lainnya ke API keuangan Twelve Data — harga real-time dan historis, 60+ indikator teknikal, fundamental, laba, dividen, ETF, berita perusahaan, penggerak pasar, dan lainnya.

Anda memerlukan akun Twelve Data. Daftar di twelvedata.com.

Ada dua cara untuk menggunakannya. Sebagian besar orang sebaiknya menggunakan server cloud (Opsi 1) — tidak ada yang perlu diinstal.

---

Opsi 1 — Gunakan server cloud kami (disarankan)

Hubungkan asisten AI Anda ke server yang kami hosting:

https://mcp.twelvedata.com/mcp

Itu saja. Tanpa instalasi, tanpa API key untuk disalin dan ditempel. Saat Anda terhubung, jendela browser terbuka dan Anda masuk dengan akun Twelve Data Anda — API key pribadi Anda tertaut secara otomatis dan tetap terikat pada akun Anda.

Cara menambahkannya

Claude (Desktop / Web) dan ChatGPT mendukung konektor / server MCP khusus:

1. Buka pengaturan Connectors (atau Integrations / MCP servers) asisten Anda.
2. Tambahkan konektor baru dengan URL https://mcp.twelvedata.com/mcp.
3. Saat diminta, klik Connect / Log in — halaman masuk Twelve Data terbuka di browser Anda.
4. Otorisasi, dan selesai. Ajukan pertanyaan seperti "Apa RSI untuk AAPL?" atau "Tunjukkan laba terbaru TSLA."

Nama menu yang tepat berbeda antar aplikasi dan versi, tetapi alurnya selalu sama: tambahkan URL, lalu masuk melalui popup browser.

Host MCP tidak menerbitkan token. URL konektor adalah https://mcp.twelvedata.com/mcp. Klien harus mengikuti metadata sumber daya yang dilindungi dari URL tersebut ke server otorisasi yang disebutkan di sana. Jangan arahkan konektor ke root host (akan menjawab 404), atau ke /register atau /.well-known/oauth-authorization-server host ini.

Perplexity (konektor jarak jauh khusus)

Pengguna Perplexity Pro, Max, dan Enterprise dapat menambahkan server yang dihosting sebagai konektor jarak jauh khusus. Itu adalah pengaturan per-akun, bukan daftar di direktori kurasi publik Perplexity.

1. Di Perplexity, buka Account settings → Connectors → + Custom connector dan pilih Remote. Di Enterprise, admin mungkin perlu mengizinkan konektor khusus terlebih dahulu.
2. Atur Name menjadi Twelve Data dan MCP Server URL menjadi https://mcp.twelvedata.com/mcp.
3. Pilih OAuth untuk autentikasi dan Streamable HTTP untuk transport. Biarkan Client ID dan Client Secret kosong agar Perplexity dapat menggunakan registrasi klien dinamis di server otorisasi yang disebutkan dalam metadata sumber daya yang dilindungi server.
4. Terima pengakuan konektor khusus Perplexity dan klik Add. Kemudian klik kartu konektor Twelve Data untuk memulai autentikasi, masuk ke akun Twelve Data Anda, dan otorisasi akses.
5. Setelah konektor diaktifkan, coba prompt berikut:
   • "Gunakan Twelve Data untuk menemukan simbol AAPL."
   • "Gunakan Twelve Data untuk mendapatkan kutipan terbaru untuk AAPL, termasuk harga dan volume."
   • "Gunakan Twelve Data untuk menampilkan lima harga penutupan harian terakhir untuk AAPL."
   • "Gunakan Twelve Data untuk menampilkan RSI AAPL."

Setiap orang masuk dengan akun Twelve Data mereka sendiri. Jika admin Enterprise membagikan konektor, minta autentikasi individual untuk setiap anggota. Jangan menempelkan API key Twelve Data ke bidang autentikasi API Key konektor.

Jika jendela OAuth diblokir, login gagal, atau alat berhenti setelah waktu idle, buka konektor Twelve Data, nonaktifkan, aktifkan lagi, dan masuk. Hubungkan kembali dengan cara ini daripada mengalihkan konektor ke auth API Key. Konfirmasi bahwa URL persis https://mcp.twelvedata.com/mcp tanpa garis miring di akhir, dan bahwa paket Twelve Data menyertakan data yang diminta. Lihat panduan konektor jarak jauh khusus Perplexity untuk layar pengaturan saat ini.

Codex (CLI, desktop, dan IDE)

Tambahkan server MCP yang dihosting ke Codex tanpa menginstal repositori ini atau menyalin API key:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

Perintah add memulai OAuth: selesaikan masuk Twelve Data di browser Anda. Jika Anda perlu mengotorisasi lagi nanti, jalankan codex mcp login twelvedata. Di Codex, gunakan /mcp untuk memeriksa koneksi, lalu tanyakan: "Gunakan Twelve Data untuk mendapatkan kutipan terbaru untuk AAPL." dan "Gunakan Twelve Data untuk menampilkan RSI AAPL." Untuk memutuskan, jalankan codex mcp remove twelvedata.

Repositori plugin publik adalah https://github.com/MazeBraker/twelvedata-skills. Ini menginstal keterampilan dan MCP yang dihosting yang sama:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Opsi 2 — Jalankan sendiri dengan API key

Lebih suka menjalankan server di mesin Anda sendiri? Anda hanya perlu API key Twelve Data — tanpa pengaturan OAuth. Dapatkan di twelvedata.com → dasbor Anda → API Keys.

1. Instal

Membutuhkan Python 3.10+ (3.12 direkomendasikan; di macOS brew install python@3.12 atau make python-install).

make install

2. Tambahkan API key Anda

Buat file .env di root proyek dengan kunci Anda, hanya dapat dibaca oleh Anda:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Server membaca kunci dari .env dan setiap permintaan menggunakannya. Tidak perlu langkah login.

3. Hubungkan melalui stdio

Claude Desktop — tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

Gunakan jalur .venv/bin/python (bukan Python sistem — macOS menyertakan 3.9, dan server ini membutuhkan 3.10+). Mulai ulang Claude Desktop setelah mengedit konfigurasi.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Hubungkan melalui HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Jalankan di Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file menjaga kunci keluar dari riwayat shell Anda. Hubungkan ke http://localhost:8000/mcp seperti pada langkah 4. Login OAuth tidak didukung di Docker.

6. Keamanan

• make run dan Docker melayani /mcp dengan tanpa autentikasi, di 0.0.0.0 secara default.
• Setiap panggilan dilayani di bawah kredensial Anda.
• Siapa pun yang mencapai port dapat memanggil auth_status dan oauth_configure. Itu termasuk halaman web yang Anda buka, melalui DNS rebinding, karena bind default tidak memeriksa header Host maupun Origin.
• MCP_HOST=127.0.0.1 make run menjaga server tetap lokal dan mengaktifkan pemeriksaan Host dan Origin SDK MCP.
• Dengan MCP_HOST=127.0.0.1, ngrok hanya berfungsi saat dimulai dengan --host-header=rewrite.

7. Pemecahan Masalah

Panggil auth_status dari klien Anda terlebih dahulu. Ini menunjukkan apakah API key dikonfigurasi, token tersimpan, host yang terdeteksi, dan URI pengalihan — biasanya cukup untuk melihat apa yang hilang.

---

Apa yang dapat Anda tanyakan

• Harga — saham, ETF, forex, kripto, komoditas (real-time & historis)
• Indikator teknikal — RSI, MACD, SMA, BBANDS, ATR, dan 60+ lainnya
• Fundamental — laporan keuangan, laba, dividen, pemecahan saham, profil perusahaan, kapitalisasi pasar, statistik kunci, kalender IPO
• Dana — profil ETF & reksa dana, kinerja, kepemilikan, risiko
• Berita — berita perusahaan & siaran pers
• Intelijen pasar — penggerak, nilai tukar, peringkat analis, target harga
• Regulasi — pengajuan SEC/EDGAR, transaksi orang dalam, kepemilikan institusional

Format simbol: saham AAPL, kripto BTC/USD, forex EUR/USD.

---

Mitra

Menjalankan instance publik Anda sendiri atau menyiapkan login OAuth khusus? Itu adalah pengaturan mitra — hubungi kami di twelvedata.com dan kami akan memberikan panduan pengaturan dan kredensial OAuth.