Koneksi MCP Remote

Index Alpha API menyediakan server MCP remote yang kompatibel dengan standar di https://api.indexalpha.id/mcp. Anda dapat menghubungkan Claude Desktop, Cursor, Windsurf, atau klien lain yang mendukung MCP langsung ke endpoint ini — tanpa perlu mengatur server lokal.

Apa yang memungkinkan koneksi remote MCP

MCP remote memungkinkan klien AI Anda mengambil data ringkasan broker IDX dan foreign-flow secara real time. Berbeda dengan pengaturan server MCP lokal yang dijelaskan dalam panduan Integrasi AI, endpoint remote:

• tidak memerlukan runtime Node.js atau file lokal
• mengautentikasi dengan akun Google Anda (OAuth 2.0) — tidak perlu menempelkan API key
• berbagi kuota langganan yang sudah ada dengan REST API
• selalu diperbarui dengan fitur API terbaru

Persyaratan langganan dan kuota

• Anda memerlukan langganan Index Alpha yang aktif (Starter atau Professional).
• Akun plan gratis dapat mengakses endpoint remote MCP tetapi tunduk pada kuota harian/bulanan yang sama seperti REST API.
• Setiap panggilan tool MCP yang berhasil mengkonsumsi 1 unit kuota, identik dengan permintaan REST yang setara.
• Periksa kuota yang tersisa dengan tool get_account_status atau endpoint Usage.

Menghubungkan dari klien AI

Klien AI apa pun yang mendukung Model Context Protocol (MCP) dapat terhubung ke endpoint remote:

https://api.indexalpha.id/mcp

Langkah pengaturannya sedikit berbeda per klien, tetapi koneksi pertama selalu diakhiri dengan masuk menggunakan Google di browser Anda. Tidak ada API key yang perlu ditempel - autentikasi dan langganan Anda diselesaikan di sisi server.

Claude Desktop

1. Buka Claude Desktop → Settings → Developer → Edit Config. Ini akan membuka claude_desktop_config.json.
2. Tempelkan kode berikut ke dalam objek mcpServers:

{
  "mcpServers": {
    "index-alpha": {
      "url": "https://api.indexalpha.id/mcp",
      "transport": "streamable-http"
    }
  }
}

3. Restart Claude Desktop. Claude akan secara otomatis menemukan tool yang tersedia. Anda sekarang dapat bertanya seperti:

"Bagaimana ringkasan broker untuk BBCA pada 2026-03-26?"

Claude akan memanggil tool get_broker_summary dan menampilkan hasilnya secara langsung.

Claude Code

Di terminal Anda, tambahkan server dengan:

claude mcp add index-alpha https://api.indexalpha.id/mcp

Saat pertama digunakan, Claude Code membuka jendela browser untuk masuk dengan Google. Verifikasi koneksi dengan:

claude mcp list

Anda kemudian dapat meminta data pasar kepada Claude Code di proyek mana pun, misalnya:

"Gunakan server MCP index-alpha: berapa foreign flow untuk TLKM bulan ini?"

ChatGPT

1. Buka aplikasi desktop ChatGPT (macOS atau Windows).
2. Klik ikon profil Anda → Settings → Work with Apps.
3. Klik Connect app dan pilih MCP Server, lalu tempel URL server:

https://api.indexalpha.id/mcp

4. Setujui koneksi di browser yang terbuka (masuk dengan Google). ChatGPT kemudian menemukan tool yang tersedia dan dapat memanggilnya dalam percakapan Anda.

Cursor / Windsurf

1. Buka Settings → AI → MCP Servers.
2. Tambahkan server baru dengan URL https://api.indexalpha.id/mcp dan transport streamable-http.
3. Klien akan meminta Anda untuk masuk dengan Google saat pertama kali digunakan.

Klien MCP generik

Jika klien Anda mendukung spesifikasi MCP, konfigurasikan dengan:

• Transport: Streamable HTTP
• Endpoint: https://api.indexalpha.id/mcp
• Autentikasi: Google OAuth 2.0 (ditangani secara otomatis oleh server)

Alur autentikasi

1. Klien Anda mengirim permintaan ke endpoint MCP.
2. Server merespons dengan tantangan Google OAuth.
3. Klien Anda membuka jendela browser untuk Anda masuk dengan akun Google.
4. Setelah memberikan akses, server menerima Google ID token.
5. Server menyelesaikan akun Index Alpha Anda, memverifikasi langganan Anda aktif, dan menyiapkan API key khusus untuk akun Anda (hanya dipakai untuk akuntansi kuota).
6. Sesi ditetapkan dan tool tersedia.

Tidak ada API key yang disimpan atau dikirim ke klien. Server menggunakan identitas Google Anda untuk mencari akun Anda secara internal.

Tentang key MCP Anda. Terhubung ke endpoint MCP akan membuat key khusus di akun Anda, yang ditampilkan di dashboard di bawah "MCP Access". Key ini hanya dipakai oleh endpoint MCP untuk akuntansi kuota, tidak pernah ditampilkan ke klien mana pun, tidak dihitung dalam batas API key Anda, dan tidak dapat dihapus secara manual.

Tool yang tersedia (v1)

Server MCP remote mengekspos tiga tool:

get_broker_summary

Mengambil aktivitas broker yang diagregasi untuk simbol saham.

get_foreign_flow

Mengembalikan aktivitas beli, jual, dan net foreign yang diagregasi.

get_account_status

Mengembalikan plan, batas bulanan, dan tanggal berakhir periode Anda. Tidak memerlukan parameter.

Batas dan rate limiting

• Panggilan MCP berbagi batas rate yang sama dengan REST API.
• Saat kuota Anda habis, panggilan MCP mengembalikan pesan error yang menjelaskan situasinya.
• Tool get_account_status tidak pernah mengkonsumsi kuota.

Privasi dan keamanan

• Hanya Google OAuth. Autentikasi ditangani sepenuhnya melalui alur OAuth 2.0 Google. Index Alpha tidak pernah melihat atau menyimpan kata sandi Google Anda.
• Tidak ada paparan API key. API key Anda diselesaikan server-side dari akun Anda. Tidak pernah dikirim ke atau disimpan di klien.
• Terenkripsi dalam transit. Semua komunikasi menggunakan TLS.
• Data minimal. Server MCP hanya mengembalikan data yang Anda minta. Tidak ada ID internal, kueri SQL, atau stack trace yang diekspos.
• Pencatatan penggunaan. Panggilan MCP dicatat untuk akuntansi kuota dan pencegahan penyalahgunaan, identik dengan panggilan REST API.

Memutuskan dan mencabut akses

Memutuskan klien

Di klien MCP Anda (Claude Desktop, Cursor, dll.), hapus atau nonaktifkan entri server MCP index-alpha. Ini menghentikan klien dari melakukan permintaan lebih lanjut.

Mencabut akses Google OAuth

1. Buka Google Account → Security → Third-party apps.
2. Temukan Index Alpha dalam daftar aplikasi yang memiliki akses.
3. Klik Remove access.

Ini segera mengakhiri semua sesi MCP yang aktif. Untuk menghubungkan kembali, Anda perlu masuk lagi melalui alur OAuth.

Pemecahan masalah