Dokumentasi MCP — 60 Tool dan Batas Izinnya
Halaman ini adalah rujukan teknis konektor MCP Kinetic Family: bentuk endpoint, cara mendaftarkannya di Claude Code maupun Codex, daftar lengkap tool beserta status baca atau tulisnya, batas izin per tool, batas laju, dan cara mencabut akses. Semua yang tertulis di sini mencerminkan perilaku server apa adanya — termasuk hal-hal yang sengaja tidak kami sediakan.
Ringkasan endpoint
| Aspek | Nilai |
|---|---|
| Alamat | https://kineticfamily.id/api/mcp |
| Metode | POST saja. GET dan DELETE dijawab penolakan metode karena endpoint bekerja tanpa sesi. |
| Transport | MCP HTTP jarak jauh, jawaban dalam bentuk JSON per permintaan |
| Autentikasi | X-Relay-Token: kfru_... |
| Alternatif autentikasi | Authorization: Bearer kfru_... |
| Sesi | Tanpa sesi. Setiap permintaan membuat sesi baru lalu menutupnya. |
| Instalasi di komputer Anda | Tidak ada. Tidak ada kode yang diunduh maupun dijalankan di mesin Anda. |
| Syarat akun | Kelas community ke atas. Akun member biasa ditolak saat mengambil token. |
| Jumlah tool | 60, dalam satu daftar tunggal untuk semua jalur sambungan |
Konfigurasi klien
Claude Code
claude mcp add --transport http kf-chart "https://kineticfamily.id/api/mcp" --header "X-Relay-Token: kfru_TOKEN_PRIBADI_ANDA"
Panduan langkah demi langkah beserta cara mengujinya ada di halaman MCP Claude.
Codex
[mcp_servers.kf-chart]
url = "https://kineticfamily.id/api/mcp"
http_headers = { "X-Relay-Token" = "kfru_TOKEN_PRIBADI_ANDA" }Blok tersebut ditempelkan pada berkas config.toml di folder .codex. Pada Codex versi lama diperlukan satu baris penanda tambahan di atas blok server; rinciannya ada di halaman MCP Codex.
Daftar tool dan status izinnya
Kolom Baca/Tulis menjelaskan efek tool: Baca tidak mengubah apa pun; Tulis tampilan hanya mengubah tampilan chart milik Anda; Tulis simulasi hanya mengubah akun latihan kertas; Tulis catatan menyimpan ringkasan pelajaran analisis. Kolom Izin menjelaskan syaratnya: Community berarti terbuka untuk akun kelas community; Community + konfirmasi berarti selain syarat akun, klien AI Anda meminta persetujuan Anda sebelum menjalankannya; Pemilik platform berarti ditolak server untuk token pengguna.
Kerangka berpikir & materi edukasi
Dokumen diambil dari server per panggilan, bukan dari berkas di komputer Anda.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| trading_os | Dokumen kerangka analisis utama beserta urutan langkahnya | Baca | Community |
| list_skills | Daftar materi skill analisis yang tersedia beserta versinya | Baca | Community |
| skill | Isi satu materi skill analisis secara mendalam | Baca | Community |
| drive_protocol | Protokol baku urutan kerja saat menyetir chart | Baca | Community |
| at_language | Spesifikasi bahasa strategi sederhana untuk uji historis | Baca | Community |
| engine_language | Kontrak modul mesin strategi tingkat lanjut | Baca | Community |
Data pasar
Murni membaca. Tidak ada satu pun yang mengubah data akun Anda.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| read_chart | Candle OHLCV per simbol dan timeframe | Baca | Community |
| read_ticks | Riwayat tick mentah untuk analisis mikrostruktur | Baca | Community |
| read_live_tick | Snapshot bid, ask, dan spread terkini | Baca | Community |
| read_macro | Ringkasan makro: bank sentral, likuiditas, aliran dana, inflasi | Baca | Community |
| read_news | Berita pasar terkini berdasarkan kata kunci | Baca | Community |
| read_calendar | Kalender ekonomi rilis berdampak tinggi | Baca | Community |
Pemindaian teknikal
Rating indikator dan penyaringan pasar dari penyedia data pemindai.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| technical_analysis | Rating indikator lengkap satu simbol pada satu timeframe | Baca | Community |
| mtf_analysis | Keselarasan rating lintas timeframe untuk satu simbol | Baca | Community |
| multi_analysis | Rating ringkas untuk banyak simbol sekaligus | Baca | Community |
| market_scan | Penyaringan pasar berdasarkan kondisi indikator | Baca | Community |
| top_movers | Daftar penggerak terbesar naik atau turun per pasar | Baca | Community |
State chart & catatan memori
Dikunci ke kotak data milik email pemegang token.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| read_report | State chart Anda: status tersambung, timeframe, mode Replay, posisi simulasi | Baca | Community |
| memory_recall | Membaca catatan pelajaran dari analisis sebelumnya | Baca | Community |
| memory_save | Menyimpan catatan pelajaran dari sebuah analisis | Tulis catatan | Community + konfirmasi |
Uji historis (backtest)
Komputasi atas data historis. Tidak mengirim order ke mana pun.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| backtest_at | Menguji satu strategi sederhana atas data historis dan mengembalikan statistiknya | Baca + komputasi | Community |
| backtest_at_visual | Sama seperti di atas, sekaligus menggambar tiap transaksi uji di chart Anda | Tulis tampilan | Community + konfirmasi |
| compare_strategies | Membandingkan beberapa strategi contoh bawaan atas rentang yang sama | Baca + komputasi | Community |
| walk_forward | Menguji ketahanan strategi di periode yang tidak dipakai merancangnya | Baca + komputasi | Community |
| export_mql5 | Mengubah strategi sederhana menjadi berkas .mq5 untuk Anda kompilasi sendiri | Baca + komputasi | Community |
Menggambar di chart Anda
Semuanya objek tampilan pada chart Anda sendiri, dan bisa dihapus sekaligus.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| draw_zone | Menggambar kotak zona antara dua titik waktu dan harga | Tulis tampilan | Community + konfirmasi |
| draw_line | Menggambar garis tren antara dua titik | Tulis tampilan | Community + konfirmasi |
| draw_hline | Menggambar garis horizontal pada satu harga | Tulis tampilan | Community + konfirmasi |
| draw_ray | Menggambar garis menerus satu arah | Tulis tampilan | Community + konfirmasi |
| draw_position | Menggambar kotak rencana posisi beserta batas rugi dan batas target | Tulis tampilan | Community + konfirmasi |
| draw_fib | Menggambar retracement fibonacci dari dua titik jangkar | Tulis tampilan | Community + konfirmasi |
| draw_channel | Menggambar kanal paralel dari tiga titik | Tulis tampilan | Community + konfirmasi |
| draw_vline | Menggambar garis vertikal penanda waktu, sesi, atau rilis data | Tulis tampilan | Community + konfirmasi |
| draw_text | Menaruh label teks pada titik waktu dan harga tertentu | Tulis tampilan | Community + konfirmasi |
| draw_volume_profile | Menggambar profil volume rentang tetap beserta area nilainya | Tulis tampilan | Community + konfirmasi |
| draw_shape | Menggambar bentuk lain yang didukung chart secara generik | Tulis tampilan | Community + konfirmasi |
| draw_clear | Menghapus seluruh gambar di chart Anda | Tulis tampilan | Community + konfirmasi |
| chart_say | Menampilkan banner narasi singkat di chart Anda | Tulis tampilan | Community + konfirmasi |
Mode Replay (belajar historis)
Menggerakkan pemutaran historis di layar Anda. Tidak menyentuh akun apa pun.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| replay_seek | Melompat ke tanggal atau waktu tertentu dalam mode Replay | Tulis tampilan | Community + konfirmasi |
| replay_tf | Mengganti timeframe pemutaran Replay | Tulis tampilan | Community + konfirmasi |
| replay_transport | Menjalankan, menjeda, atau melangkah satu bar | Tulis tampilan | Community + konfirmasi |
| replay_speed | Mengatur kecepatan pemutaran | Tulis tampilan | Community + konfirmasi |
| replay_exit | Keluar dari mode Replay kembali ke candle berjalan | Tulis tampilan | Community + konfirmasi |
| autotest_toggle | Mengaktifkan atau menonaktifkan uji otomatis di dalam Replay | Tulis tampilan | Community + konfirmasi |
Simulasi kertas (paper) di mode Replay
Angka latihan. Tidak ada order sungguhan, tidak ada dana, tidak ada broker.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| sim_market | Membuka posisi simulasi pada harga berjalan di Replay | Tulis simulasi | Community + konfirmasi |
| sim_pending | Menempatkan order simulasi tertunda pada harga tertentu | Tulis simulasi | Community + konfirmasi |
| sim_close | Menutup satu posisi simulasi berdasarkan id | Tulis simulasi | Community + konfirmasi |
| sim_modify | Mengubah batas rugi atau batas target posisi simulasi | Tulis simulasi | Community + konfirmasi |
| sim_flatten | Menutup seluruh posisi simulasi | Tulis simulasi | Community + konfirmasi |
| sim_reset | Mengembalikan saldo dan posisi simulasi ke keadaan awal | Tulis simulasi | Community + konfirmasi |
Khusus pemilik platform
Token pengguna akan ditolak server dengan pesan akses khusus pemilik. Penolakan terjadi di server, bukan di tampilan.
| Tool | Fungsi | Baca/Tulis | Izin |
|---|---|---|---|
| compile_source | Memvalidasi dan menyimpan versi kode mesin strategi | Tulis | Pemilik platform |
| stream_draft | Mengirim draf kode ke editor untuk pratinjau langsung | Tulis | Pemilik platform |
| list_versions | Daftar versi kode mesin strategi yang tersimpan | Baca | Pemilik platform |
| get_source | Membaca teks kode satu versi tertentu | Baca | Pemilik platform |
| run_backtest | Menjalankan uji historis sisi server berdasarkan versi kode | Tulis | Pemilik platform |
| poll_job | Memeriksa status pekerjaan uji historis sisi server | Baca | Pemilik platform |
| lab_open | Membuka atau menutup panel laboratorium kode di chart | Tulis | Pemilik platform |
| lab_load_version | Memuat satu versi kode ke editor dan chart | Tulis | Pemilik platform |
| lab_diff | Menampilkan perbandingan antar versi kode di editor | Tulis | Pemilik platform |
| lab_run_backtest | Menjalankan penguji strategi visual di chart | Tulis | Pemilik platform |
Perlu ditegaskan sekali lagi: tidak ada satu pun tool untuk mengirim order sungguhan, menyentuh dana, atau membaca kredensial broker. Kemampuan itu tidak ada di daftar, dan daftar inilah satu-satunya pintu yang dimiliki asisten AI Anda.
Kode respons yang mungkin Anda temui
| Situasi | Arti | Tindakan |
|---|---|---|
| Token relay tidak valid | Token tidak dikenal atau sudah dicabut | Ambil token terbaru dari app MCP Connector |
| Akses khusus pemilik | Tool berada di luar daftar putih token pengguna | Gunakan tool setara yang terbuka |
| Verifikasi akun dibutuhkan | Akun belum berada di kelas community | Selesaikan verifikasi akun di dashboard |
| Permintaan terlalu banyak | Salah satu batas laju tersentuh | Beri jeda lalu ulangi dengan lebih jarang |
| Metode tidak didukung | Endpoint bekerja tanpa sesi dan hanya menerima POST | Normal. Biarkan klien MCP yang menanganinya. |
| Perintah tidak dikenal | Perintah chart di luar daftar putih tertutup | Pakai tool resmi yang terdaftar di halaman ini |
Batas dan perlindungan
- Batas laju global pada kanal relay, untuk mencegah pembanjiran permintaan.
- Batas uji historis per pengguna per menit, karena uji historis memakan komputasi.
- Batas penulisan catatan memori per pengguna per menit, agar penyimpanan tidak dibanjiri satu klien.
- Daftar putih perintah chart yang bersifat tertutup: perintah di luar daftar ditolak.
- Isolasi kotak data per email: token pengguna tidak bisa menunjuk akun lain.
- Log audit sisi server untuk setiap pemanggilan tool.
- Tanpa sesi yang menempel: setiap permintaan berdiri sendiri.
Mencabut akses
- Buka app MCP Connector di dashboard Kinetic Family.
- Tekan Ganti Token dan setujui konfirmasinya.
- Seluruh token lama milik email Anda ditandai dicabut di server; klien AI yang masih memakainya akan ditolak pada permintaan berikutnya.
- Bila Anda ingin berhenti sepenuhnya, hapus juga entri server MCP dari konfigurasi Claude Code atau Codex Anda.
Penjelasan konsep dan model izinnya ada di hub MCP, sedangkan gambaran praktis pemakaiannya ada di MCP Trading Dashboard. Dokumen legal yang berlaku: Risk Disclosure · Terms · Privacy.
ADA PERTANYAAN TEKNIS?
Butuh klarifikasi soal batas izin atau perilaku endpoint? Tanyakan langsung di grup komunitas kami.
Pertanyaan Teknis yang Sering Diajukan
Apa alamat endpoint MCP Kinetic Family?
Endpoint resmi berada di alamat https://kineticfamily.id/api/mcp dan hanya menerima metode POST. Autentikasi dilakukan lewat header X-Relay-Token yang berisi token pribadi Anda; sebagai alternatif, header Authorization bertipe Bearer juga diterima dan diverifikasi oleh validator yang sama.
Ada berapa tool yang tersedia?
Ada 60 tool dalam satu daftar tunggal yang dipakai bersama oleh semua jalur sambungan, sehingga tidak ada daftar tool tersembunyi di jalur lain. Dari jumlah itu, sepuluh di antaranya dikunci khusus untuk pemilik platform dan akan ditolak bila dipanggil dengan token pengguna.
Kenapa ada tool yang ditolak dengan pesan akses khusus pemilik?
Daftar jalur yang boleh diakses token pengguna bersifat daftar putih dengan prinsip default menutup. Apa pun yang tidak terdaftar akan ditolak, termasuk kemampuan internal baru yang ditambahkan kemudian. Ini disengaja agar penambahan fitur di masa depan tidak otomatis terbuka untuk token pengguna.
Apakah ada batas jumlah permintaan?
Ada tiga lapis pembatasan wajar: batas permintaan relay per menit secara global, batas uji historis per pengguna per menit, dan batas penulisan catatan memori per pengguna per menit. Bila salah satunya tersentuh, server menjawab dengan pesan bahwa permintaan terlalu banyak dan Anda cukup memberi jeda sebentar.
Apakah panggilan tool saya dicatat?
Ya. Setiap pemanggilan tool dicatat di log audit sisi server berisi waktu, nama tool, status, dan potongan argumen. Pencatatan ini dipakai untuk keperluan keamanan dan penelusuran masalah, dan berjalan di server kami — bukan di komputer Anda.
Bagaimana isolasi antar pengguna bekerja?
Token terikat pada satu email. Untuk token kelas pengguna, server memaksa kotak data ke email pemilik token dan mengabaikan upaya menunjuk pengguna lain, sehingga satu token tidak dapat membaca maupun menyetir chart akun lain. Selain itu setiap permintaan MCP membuat sesi baru lalu menutupnya, sehingga tidak ada state sesi yang bertahan antar klien.
Bagaimana cara mencabut token saya?
Buka app MCP Connector di dashboard lalu tekan Ganti Token. Seluruh token lama milik email Anda ditandai dicabut di server dan satu token baru diterbitkan. Klien AI mana pun yang masih memakai token lama akan ditolak pada permintaan berikutnya dengan pesan token tidak valid.
Apakah ada tool untuk mengirim order sungguhan?
Tidak ada, dan ini bukan sekadar pembatasan izin. Daftar perintah chart yang diterima server bersifat daftar putih tertutup yang tidak memuat perintah order sungguhan, dan kanal MCP tidak memiliki jalur ke sistem eksekusi, ke dana, maupun ke kredensial broker. Menghubungkan asisten AI tidak membuatnya melakukan trading otomatis.
Baca juga
Disclaimer Edukasi & Risiko
Kinetic Family adalah dashboard edukasi trading — bukan penasihat keuangan, bukan broker, dan bukan pengelola dana. Konektor MCP adalah alat bantu pencatatan dan analisis mandiri; keputusan serta risikonya sepenuhnya berada pada Anda. Trading forex dan emas berisiko tinggi dan Anda dapat kehilangan seluruh modal. Hasil uji historis adalah simulasi atas data masa lalu dan bukan gambaran hasil di masa depan. Seluruh konten bersifat edukatif, bukan nasihat keuangan maupun ajakan bertransaksi. Kinerja masa lalu tidak menjamin hasil di masa depan. Baca Risk Disclosure, Terms, dan Privacy sebelum memakai fitur ini.