Deploy dan Kelola Aplikasi Orbit dengan Agen AI

Orbit menyertakan server Model Context Protocol untuk deployment dan operasi aplikasi yang terautentikasi. Hubungkan agen AI yang kompatibel, minta agen memeriksa atau mengelola aplikasimu, lalu setujui tindakan yang ingin kamu izinkan. Panduan ini menjelaskan alur koneksi, tool yang tersedia, model keamanan, dan alur kerja yang disarankan.

Apa yang dilakukan server MCP Orbit

Model Context Protocol, biasa disebut MCP, memberi klien AI cara standar untuk menemukan dan memanggil tool. Server MCP Orbit menyediakan kemampuan deployment dan manajemen yang sama dengan antarmuka Orbit melalui endpoint HTTP stateless di https://runonflux.com/apps/mcp.

  • Periksa: lihat daftar paket dan aplikasi milikmu, analisis repositori, periksa spesifikasi aplikasi yang sudah disanitasi, cek instance dan status deployment, ukur kapasitas jaringan, serta baca log terbatas.
  • Deploy: validasi spesifikasi aplikasi, daftarkan deployment, uji instalasi, dan buat checkout Stripe yang otoritatif saat pembayaran diperlukan.
  • Operasikan: picu build dan jalankan aksi yang sudah disetujui seperti start, stop, restart, pause, unpause, redeploy, atau hapus pada instance yang ditugaskan.
  • Pelihara: perbarui pengaturan aplikasi yang didukung, pertahankan sisa periode langganan, dan perpanjang aplikasi untuk durasi yang disetujui.

Hubungkan agenmu

Kamu memerlukan akun Orbit yang masuk dengan Google atau email, dan klien MCP yang mendukung Streamable HTTP plus header otorisasi kustom. Sesi dompet saja seperti ZelCore dan SSP saat ini tidak bisa membuat koneksi agen.

  • Masuk ke Orbit dengan Google atau email.
  • Buka Dashboard, lalu Hubungkan agen.
  • Pilih Buat konfigurasi koneksi.
  • Salin JSON yang dihasilkan ke konfigurasi klien MCP kamu.
  • Sambungkan ulang dengan konfigurasi baru yang dibuat setelah kredensial kedaluwarsa.
{
  "mcpServers": {
    "orbit": {
      "type": "http",
      "url": "https://runonflux.com/apps/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FIREBASE_ID_TOKEN"
      }
    }
  }
}

Perlakukan konfigurasi yang dihasilkan seperti kata sandi. Jangan commit, sertakan dalam pesan dukungan, tempel ke prompt, atau bagikan ke orang lain. Buat konfigurasi langsung di dashboard kamu sendiri.

Tool agen yang tersedia

KemampuanToolApa yang mereka lakukan
Penemuanlist_plans, analyze_repositoryBandingkan paket dan periksa repositori dengan aturan kompatibilitas Orbit.
Pemeriksaan aplikasilist_apps, get_app, get_instancesBaca aplikasi Orbit milikmu, spesifikasi yang sudah disanitasi, dan node yang ditugaskan.
Status dan kapasitasget_deployment_status, get_network_capacityPeriksa status registrasi, lokasi live, dan kapasitas Flux yang sesuai.
Deploymentvalidate_deployment, deploy_appPratinjau spesifikasi resmi, lalu daftarkan dan uji aplikasi yang sudah disetujui.
Pembayarancreate_stripe_checkoutBuat checkout Stripe dari transaksi Flux milikmu dan harga yang dihitung server.
Log dan buildget_logs, trigger_buildBaca log terakhir yang terbatas atau minta build Orbit baru.
Kontrol instancecontrol_instanceJalankan tindakan yang ada dalam daftar izin pada node yang ditugaskan ke aplikasi milikmu.
Pemeliharaanupdate_app, renew_appTerapkan perubahan terbatas atau perpanjang langganan aplikasi.

Alur kerja deployment yang aman

  • Mulai dengan analisis. Minta agen untuk menganalisis repositori dan menjelaskan runtime, port, branch, dan direktori proyek yang terdeteksi.
  • Validasi sebelum deployment. Gunakan validate_deployment untuk meninjau spesifikasi yang dihasilkan, resource yang dibutuhkan, dan harga jaringan resmi tanpa mendaftarkan apa pun.
  • Tinjau pemanggilan yang mengubah data. Wajibkan konfirmasi di klien MCP kamu untuk deploy_app, trigger_build, control_instance, update_app, dan renew_app.
  • Simpan ID transaksinya. Simpan ID transaksi yang dikembalikan oleh deployment, pembaruan, atau perpanjangan. ID ini mengidentifikasi operasi Flux yang dikirim dan bisa dipakai untuk cek status dan checkout.
  • Periksa hasilnya. Tanyakan status deployment dan instance setelah pendaftaran. Baca bagian akhir log dengan batas tertentu jika aplikasi tidak sehat.

Autentikasi, kepemilikan, dan penyimpanan data

Setiap permintaan memverifikasi bearer credential Firebase, menurunkan identitas Flux pengguna melalui FluxCore, dan membuat sesi yang dibatasi permintaan tersebut. Transport MCP bersifat stateless. Orbit tidak membuat database pengguna MCP terpisah atau menyimpan sesi agen yang berumur panjang.

Firebase, FluxCore, blockchain Flux, dan jembatan pembayaran Stripe tetap menjadi sistem pencatatan utama. Orbit memeriksa kepemilikan aplikasi sebelum mengembalikan detail aplikasi atau menghubungi node yang ditugaskan. Kredensial repositori, secret pengelolaan, plaintext Enterprise, dan URL yang memuat kredensial disembunyikan dari hasil tool.

Token ID Firebase berumur pendek. Alur koneksi saat ini tidak menyertakan kredensial refresh, jadi agen tidak bisa memperpanjang akses secara diam-diam. Buat konfigurasi baru dari dashboard saat token kedaluwarsa.

Pemecahan masalah

  • Tidak diizinkan: buat konfigurasi baru, pastikan seluruh header Authorization sudah tersalin, dan pastikan akun menggunakan login Google atau email.
  • Tool tidak ditemukan: sambungkan ulang klien MCP agar melakukan penemuan tool terhadap versi server saat ini.
  • Aplikasi tidak tercantum: pastikan aplikasi tersebut milik identitas Flux yang terhubung dengan akun Firebase yang sedang masuk, dan bahwa aplikasi itu adalah deployment Orbit.
  • Repositori tidak bisa dianalisis: pastikan URL repositori, branch, subdirektori, dan kredensial repositori privat sudah benar.
  • Pembayaran diperlukan: gunakan ID transaksi yang dikembalikan oleh panggilan mutasi untuk membuat checkout Stripe yang otoritatif.
  • Timeout: coba ulang panggilan hanya-baca satu kali. Jangan ulangi panggilan yang mengubah data kecuali kamu lebih dulu memeriksa ID transaksi atau status deployment yang dikembalikan.

Pertanyaan yang sering diajukan

Klien AI mana yang bisa digunakan dengan server MCP Orbit?
Klien MCP apa pun yang mendukung koneksi Streamable HTTP dan header Authorization kustom bisa terhubung. Tambahkan JSON yang dihasilkan menggunakan metode konfigurasi yang didokumentasikan klienmu.
Apakah Orbit menyimpan akun agen atau database agen terpisah?
Tidak. Endpoint MCP bersifat stateless dan menggunakan akun Firebase, identitas Flux, catatan blockchain, dan alur pembayaran Stripe yang sudah kamu miliki. Orbit tidak menambahkan database terpisah untuk pengguna agen atau deployment.
Bisakah agen deploy tanpa persetujuan kamu?
Itu bergantung pada kebijakan persetujuan di klien MCP kamu. Orbit menandai tool yang mengubah data sebagai destruktif atau non-read-only jika sesuai. Atur klienmu agar meminta konfirmasi sebelum deployment, build, kontrol instance, pembaruan, perpanjangan, dan pembayaran.
Bisakah kamu memakai ZelCore atau SSP untuk menghubungkan agen?
Belum saat ini. Koneksi MCP memerlukan sesi Firebase yang dibuat lewat login Google atau email, karena penandatanganan permintaan di sisi agen bergantung pada Firebase SSO.
Berapa lama koneksi agen bertahan?
Koneksi yang dihasilkan memakai token ID Firebase yang berumur pendek. Waktu kedaluwarsanya ditampilkan di halaman Hubungkan agen. Buat konfigurasi baru setelah kedaluwarsa.
Apakah agen bisa melihat token repositori atau secret aplikasimu?
Orbit menerima kredensial repositori privat sebagai input rahasia bila diperlukan, tetapi tidak mengembalikannya. Respons tool menyembunyikan kredensial repositori, secret pengelolaan, plaintext Enterprise, dan variabel lingkungan rahasia yang diketahui.