DataFast MCP

Mulai dengan MCP

Hubungkan asisten AI Anda ke DataFast untuk menanyakan lalu lintas, pendapatan, dan tujuan kustom, atau mengelola operasi situs web yang Anda otorisasi. Anda memerlukan akun DataFast dengan akses API.

Pilih cara terhubung

Pilih satu metode. Keduanya menggunakan Streamable HTTP untuk berkomunikasi dengan DataFast.

• Masuk dengan OAuth — direkomendasikan untuk klien yang menawarkan masuk dengan OAuth, termasuk Codex dan Claude Code. Pilih situs web dan izin di DataFast; klien menangani token koneksinya secara otomatis. Anda tidak membuat atau menyalin kunci API.
• Gunakan token API — untuk klien yang meminta token Bearer. Buat token akun dengan cakupan tertentu di DataFast dan tambahkan ke konfigurasi klien Anda.

Kedua metode menawarkan alat DataFast yang sama. Izin OAuth memungkinkan Anda menyetujui analitik, administrasi situs web, tindakan akun, dan manajemen kredensial secara terpisah. Lihat referensi alat untuk mengetahui apa yang didukung setiap metode.

Terhubung dengan OAuth

1. Tambahkan DataFast ke klien Anda

Tambahkan server MCP jarak jauh dengan URL di bawah dan pilih OAuth atau Masuk.

https://datafa.st/api/mcp

Untuk Codex, tambahkan server dan selesaikan masuk melalui browser:

codex mcp add datafast --url https://datafa.st/api/mcp

Untuk masuk lagi nanti, jalankan codex mcp login datafast. Dokumen metadata klien dan registrasi dinamis didukung, termasuk callback loopback asli. Jika DataFast sudah dikonfigurasi dengan token Bearer, hapus kredensial tersebut dari konfigurasi DataFast klien sebelum beralih ke OAuth.

Untuk Claude Code, tambahkan server, lalu buka /mcp di dalam Claude Code dan autentikasi DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Masuk dan setujui akses

1. Masuk di datafa.st dengan akun DataFast Anda yang sudah ada.
2. Pilih situs web yang boleh diakses klien ini.
3. Tinjau izin yang diminta. Izin baca dipilih secara default; aktifkan tulis hanya jika Anda ingin klien melakukan perubahan tersebut.
4. Pilih Izinkan akses untuk kembali ke klien Anda.

DataFast menerbitkan token akses kepada klien untuk koneksi tersebut. Klien menyimpannya dan memperbaruinya secara otomatis selama koneksi tetap valid. Kata sandi DataFast Anda, sesi dasbor, dan kunci API yang ada tidak dibagikan dengan klien.

3. Coba

Mulai percakapan dengan DataFast diaktifkan dan tanyakan:

Daftarkan situs web saya yang tersedia, lalu tampilkan pengunjung dan pendapatan untuk situs web saya selama tujuh hari terakhir.

Konfirmasikan situs web dan rentang tanggal sebelum melanjutkan. Paket dan izin Anda tetap berlaku.

Kelola atau cabut koneksi di bawah Pengaturan → API / MCP → Aplikasi yang terhubung. Hubungkan kembali saat DataFast meminta Anda menyetujui akses lagi, atau saat Anda ingin membagikan situs web atau izin yang berbeda.

Terhubung dengan token API

Gunakan metode ini saat klien Anda meminta kunci API atau token Bearer. Untuk MCP, mulailah dengan token akses akun, yang diawali dengan dft_.

1. Buat token akun

1. Buka Pengaturan akun → API / MCP.
2. Di bawah Token akses baru, pilih Situs web tertentu untuk membatasi akses, atau Semua situs web jika itu yang dibutuhkan alur kerja Anda.
3. Pilih hanya izin yang Anda perlukan. Untuk koneksi analitik, mulailah dengan Situs web → Baca dan Analitik → Baca, dengan semua izin lainnya dinonaktifkan.
4. Beri nama yang mudah dikenali pada token, pilih Buat token, dan salin nilai dft_. Nilai ini hanya ditampilkan sekali.

2. Tambahkan token ke klien Anda

Gunakan https://datafa.st/api/mcp dan kirim token sebagai header Authorization: Bearer …. Simpan di pengaturan kredensial klien atau variabel lingkungan, di luar kontrol sumber dan pesan obrolan.

Codex: buat token Anda tersedia sebagai variabel lingkungan DATAFAST_TOKEN, lalu jalankan:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: ganti dft_xxx dengan token Anda:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: tambahkan entri ini ke mcp.json Anda. Buat DATAFAST_TOKEN tersedia di lingkungan Cursor; Cursor memperluas variabel lingkungan saat terhubung.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

Klien lain: masukkan URL server dan token Bearer di pengaturan MCP jarak jauh mereka. Klien yang hanya mendukung server stdio lokal memerlukan jembatan seperti mcp-remote.

3. Coba dan kelola akses

Minta klien Anda untuk mendaftarkan situs web yang tersedia, lalu minta pengunjung dan pendapatan untuk satu situs web selama tujuh hari terakhir.

Kelola token di bawah Token akses Anda di Pengaturan akun → API / MCP. Gunakan Edit izin untuk mengubah apa yang dapat dilakukan, Putar untuk mengganti rahasianya, atau Hapus untuk mencabutnya. Setelah memutar token, perbarui nilai di klien Anda.

Sudah memiliki kunci API situs web df_? Titik akhir MCP umum juga menerima kunci tersebut, dengan akses terikat ke situs web itu. Periksa Autentikasi API untuk operasi yang didukungnya. Anda juga dapat membatasi token akun ke satu situs web menggunakan Situs web tertentu di atas.

Bagaimana akses dibatasi

Kedua metode memberikan kredensial rahasia kepada klien. OAuth mengotomatiskan penerbitan dan pembaruan kredensial tersebut setelah persetujuan Anda; token API adalah kredensial yang Anda buat dan konfigurasikan sendiri.

DataFast memeriksa kredensial, tindakan yang diizinkan, akses situs web, keanggotaan saat ini, dan batasan akun atau paket yang berlaku di server. ID situs web dalam permintaan alat adalah target untuk diperiksa, bukan bukti akses. Misalnya, koneksi OAuth yang disetujui untuk membaca Situs Web A tidak dapat membaca Situs Web B atau mengedit Situs Web A.

Koneksi OAuth hanya mengakses situs web yang disetujui. Situs web yang dibuat melalui alat OAuth yang disetujui ditambahkan ke koneksi tersebut; situs web yang ditambahkan di tempat lain tidak dibagikan secara otomatis. Token OAuth kedaluwarsa setelah satu jam, diperbarui secara otomatis hingga 30 hari sejak penerbitan, dan memerlukan persetujuan baru setelah paling lambat 90 hari. Token akun yang dibuat di dasbor tetap valid hingga Anda memutar atau menghapusnya, tergantung pada akses dan izin akun Anda. Kunci API dan token akun yang diterbitkan melalui OAuth juga bergantung pada koneksi asli yang tetap valid.

Token OAuth hanya berfungsi di titik akhir MCP tempat token tersebut diterbitkan. Token tersebut tidak dapat ditempel ke REST API publik atau digunakan untuk masuk ke dasbor DataFast. Token akun juga berfungsi dengan titik akhir REST API yang didukung.

Keamanan

• Mulai dengan akses terbatas. Berikan klien hanya situs web dan izin yang dibutuhkannya. Tindakan akun, manajemen kredensial, dan detail pengunjung lengkap memerlukan izin OAuth terpisah yang nonaktif secara default.
• Tinjau perubahan. Alat tulis OAuth memerlukan konfirmasi dan kunci percobaan ulang. Alat token API memerlukan konfirmasi untuk operasi sensitif seperti menghapus data atau menerbitkan kredensial. Pemeriksaan ini melengkapi UI konfirmasi klien; pemeriksaan ini tidak menggantikan pemilihan klien yang tepercaya.
• Jaga kerahasiaan kredensial. Kedua metode menggunakan token Bearer: seseorang yang mendapatkan token valid dapat menggunakan akses yang diizinkan hingga kedaluwarsa atau dicabut. Jangan pernah menaruh kredensial di URL, kontrol sumber, atau pesan obrolan.
• Putuskan koneksi saat diperlukan. Mencabut koneksi OAuth memblokir permintaan dan pembaruan berikutnya. Permintaan yang sedang berjalan mungkin selesai, dan data yang sudah dibagikan dengan aplikasi lain tidak dihapus oleh pencabutan.
• Operasi khusus dasbor tetap di dasbor. MCP tidak dapat menghapus situs web atau menghubungkan/memutuskan penyedia pembayaran.