View Categories

Cara Menginstal Query Streams Agent di macOS

Waktu baca 9 menit

logo macOS Agen Jaringan macOS

Instal Query Streams di macOS

Jalankan Query Streams Network Agent khusus keluar pada macOS 12 Monterey atau versi yang lebih baru. Satu skrip instalasi mendaftarkannya sebagai agen tingkat sistem. diluncurkan daemon — build asli untuk Apple Silicon (M1–M4) dan Intel. Gunakan dasbor Agen lokal di http://localhost:1823 untuk mendaftarkan Agen dan mengelola konektor data, kemudian membuat kueri tersimpan di portal Query Streams untuk Excel, Google Sheets, otomatisasi, REST API, MCP, dan Nova AI.

Pengaturan konektor lokal Tidak ada port firewall masuk. Berjalan sebagai layanan yang diluncurkan.
Terminal — zsh
%tar -xzf querystreams-agent_x.x.x_osx-arm64.tar.gz
%sudo bash install.sh|
>[4/4] Layanan sedang berjalan.
>Antarmuka Web: http://localhost:1823
com.querystreams.agent berlari
Menginstal di sistem operasi yang berbeda?
Windows Windows Linux Linux
Lihat semua yang dapat dilakukan Query Streams setelah macOS Agent online. Mulai Gratis
Konektor
SQL Server PostgreSQL MySQL MariaDB SQLite Microsoft Access Oracle BigQuery DuckDB
+ API
Microsoft Excel Lembar Kerja Google
Data Langsung

Jalankan SQL yang tersimpan langsung dari spreadsheet.

Excel Lembar
Nova AI
Analisis BI & AI

Ajukan pertanyaan kepada Nova melalui data yang terhubung.

Temui Nova
API REST
API REST Basis Data

Ubah kueri yang tersimpan menjadi titik akhir yang aman.

Membangun API
Airtable Lembar pintar Baserow + lagi
Otomatisasi

Jadwalkan sinkronisasi dan tampilkan hasil secara langsung.

Jelajahi
Stripe HubSpot Shopify Google Analytics + lagi
API ke SQL

Mengakses API SaaS dengan SQL

Jelajahi
MCP Claude Kursor ChatGPT
Basis Data AI MCP

Izinkan alat AI untuk melakukan kueri langsung ke konektor.

Hubungkan AI

Query Streams adalah platform akses data real-time yang aman yang memungkinkan pengguna Mac dan tim pengembang untuk menghubungkan basis data langsung ke Excel, Google Sheets, otomatisasi, alat AI yang kompatibel dengan MCP, dan API REST yang siap digunakan oleh mitra. Pelajari selengkapnya di QueryStreams.com dan Daftar gratis untuk menginstal Agen macOS pertama Anda.

Panduan ini membahas cara menginstal Agent di macOS. Paket ini mencakup sebuah skrip instalasi satu perintah yang menyalin file ke /usr/local/querystreams/agent/ dan mendaftarkan sebuah daemon launchd tingkat sistem — tersedia sebagai build native ARM64 (Apple Silicon M1–M4) dan native x64 (Intel). Tambahkan konektor data Anda di dalam dasbor Agen lokal, lalu gunakan portal Query Streams untuk membuat kueri tersimpan pertama Anda.

Sebelum Anda Mulai

Versi macOS yang didukung

macOS 12 Monterey atau versi yang lebih baru (Monterey, Ventura, Sonoma, Sequoia). Baik Apple Silicon maupun Intel didukung dengan binary bawaan.

Akses admin/sudo

Diperlukan. Skrip instalasi dijalankan sebagai root untuk menginstal ke /usr/lokal/ dan mendaftarkan LaunchDaemon sistem.

HTTPS keluar

Agen memerlukan akses HTTPS keluar pada port 443 ke layanan cloud Query Streams. Tidak diperlukan aturan firewall masuk.

Akses jaringan basis data

Instal Agen pada Mac yang berada di jaringan, VPN, atau lingkungan yang dapat diakses yang sama dengan basis data atau sumber API Anda.

Langkah 1: Unduh macOS Agent

1
2
3
4
5
  1. Masuk ke my.querystreams.com/download.
  2. Memilih macOS dari opsi unduhan Agen.
  3. Memilih ARM64 (Apple Silicon — periksa) Menu Apple > Tentang Mac Ini(jika menampilkan “Apple M1/M2/M3/M4”, gunakan ini) atau x64 (Intel Core) dan unduh .tar.gz arsip.
  4. Salin kunci otentikasi organisasi Anda dari halaman unduhan yang sama. Anda akan menggunakannya saat dasbor Agen lokal terbuka.

Langkah 2: Jalankan Skrip Instalasi

2
3
4
5

Membuka Terminal (Aplikasi > Utilitas > Terminal) dan jalankan:

Terminal — zsh
# Ekstrak arsip tar -xzf querystreams-agent_x.x.x_osx-arm64.tar.gz # Opsional (ditandatangani & dilegalisir, biasanya tidak diperlukan): hapus karantina, lalu jalankan skrip instalasi xattr -dr com.apple.karantina . sudo bash instal.sh

Itu instal.sh Skrip ini secara otomatis menjalankan empat langkah: menyalin file ke /usr/local/querystreams/agent/, mengatur izin yang benar, menginstal plist launchd ke /Library/LaunchDaemons/com.querystreams.agent.plist sebagai daemon di seluruh sistem, dan memuat layanan melalui launchctl load — menjalankannya segera dan setiap kali komputer dinyalakan.

Ditandatangani & Dilegalisir: Agen Query Streams macOS telah ditandatangani secara digital dan disahkan oleh Apple, sehingga berjalan normal di bawah Gatekeeper — tidak diperlukan langkah tambahan bagi sebagian besar pengguna. Dalam kasus yang jarang terjadi, jika muncul prompt saat pertama kali dijalankan (misalnya, jika arsip disalin antar mesin setelah flag karantina diterapkan kembali), hapus atribut karantina dengan xattr -dr com.apple.quarantine qs-agent/ dan dijalankan ulang sudo bash install.sh.

Setelah layanan berjalan, dasbor lokal tersedia di http://localhost:1823 di Mac. Ini digunakan untuk memasukkan kunci otentikasi Anda dan mengelola konektor data lokal. Kredensial basis data Anda tetap berada di mesin Agen dan tidak dikirim ke cloud Query Streams.

Langkah 3: Hubungkan Agen ke Akun Anda

3
4
5
  1. Di dasbor Agen lokal di http://localhost:1823, tempelkan kunci otentikasi Query Streams Anda.
  2. Simpan kunci tersebut dan tunggu hingga Agen mendaftar ke organisasi Anda.
  3. Konfirmasikan bahwa layanan tersebut berfungsi dengan baik: sudo launchctl list | grep querystreams.
  4. Memilih Tambahkan Sumber Data untuk membuka wizard koneksi lokal.

Langkah 4: Tambahkan Sumber Data Pertama Anda di Agen Lokal

4
5

Jangan menambahkan atau mengedit konektor dari portal Query Streams. Pengaturan konektor dilakukan di dasbor Network Agent lokal di http://localhost:1823Di sinilah Anda dapat menambahkan, mengedit, menguji, dan menghapus konektor basis data atau API seperti PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation, atau iTick.

  1. Buka browser di mesin macOS Agent dan kunjungi http://localhost:1823.
  2. Klik Tambahkan Sumber Data atau buka area koneksi Agen.
  3. Pilih jenis basis data atau konektor API Anda.
  4. Masukkan detail koneksi yang valid dari mesin macOS Agent.
  5. Pilih ranah data jika diminta.
  6. Uji koneksi, lalu simpan.
  7. Untuk konektor basis data yang didukung, biarkan Schema Intelligence tetap diaktifkan agar klien Query Builder, Nova AI, dan MCP mendapatkan konteks tabel dan kolom yang lebih kaya.
PostgreSQL
PostgreSQLHost, port, basis data, SSL
MySQL
MySQL / MariaDBHost, port, basis data, SSL
SQL Server
SQL ServerServer, basis data, nama pengguna, kata sandi
DuckDB
File lokalSQLite, DuckDB
Stripe
konektor APIKredensial, jadwal sinkronisasi, ranah data
MCP
Siap MCPKlien AI dapat melakukan kueri konektor secara langsung.
Model jaringan
# Manajemen konektor Dasbor Agen Lokal: http://localhost:1823 # Agen macOS Berjalan sebagai daemon launchd, menyimpan kredensial secara lokal, terhubung keluar. # Basis data/API Anda Koneksi jaringan pribadi dari Agen # Kueri Streams cloud Menerima metadata konektor dan mengarahkan permintaan kueri.

Langkah 5: Buat dan Simpan Kueri Pertama Anda

5

Setelah konektor dan basis data dikonfigurasi di Agen, buka portal Query Streams dan gunakan Query Builder untuk membuat kueri tersimpan pertama Anda. Kueri tersimpan inilah yang dapat dijalankan oleh Excel, Google Sheets, otomatisasi, titik akhir REST API yang aman, dan pengguna bersama tanpa harus melihat SQL mentah atau kredensial basis data Anda.

  1. Membuka Pembuat Kueri di portal Query Streams.
  2. Pilih konektor data dan basis data yang telah Anda konfigurasi di Agen lokal.
  3. Tulis atau buat kueri SQL dan jalankan pratinjau.
  4. Simpan kueri dengan nama yang jelas dan filter apa pun yang ingin Anda izinkan pengguna untuk menyesuaikan.
  5. Jalankan kueri yang tersimpan dari Microsoft Excel, Google Sheets, otomatisasi, REST API, atau dasbor bersama.
1

Agen Lokal

Tambahkan, edit, uji, dan hapus konektor di localhost:1823.

2

Pembuat Kueri

Pilih konektor, pilih basis data, tulis SQL, pratinjau, dan simpan.

3

Alat pengguna

Kueri yang tersimpan akan tersedia di Excel, Google Sheets, otomatisasi, dan API.

4

Akses MCP

Klien MCP juga dapat melihat konektor yang tersedia dan melakukan kueri basis data secara langsung melalui Agen.

Referensi Manajemen Layanan

Terminal — manajemen peluncuran
# Hentikan layanan sudo launchctl unload /Library/LaunchDaemons/com.querystreams.agent.plist # Mulai layanan sudo launchctl load /Library/LaunchDaemons/com.querystreams.agent.plist # Periksa status berjalan sudo launchctl list | grep aliran kueri # Lihat log langsung ekor -f /usr/local/querystreams/agent/logs/agent-stdout.log # Lihat log kesalahan ekor -f /usr/local/querystreams/agent/logs/agent-stderr.log

Menghapus instalasi Agen

Paket tersebut mencakup sebuah uninstall.sh Skrip yang menghentikan dan membongkar layanan launchd, menghapus file plist dari /Pustaka/LaunchDaemons/, dan menghapus direktori instalasi.

Terminal — hapus instalasi
sudo bash /usr/local/querystreams/agent/uninstall.sh

Skrip penghapusan instalasi akan menampilkan pesan: “Simpan konfigurasi dan log? (y/N)” - memasuki y untuk menjaga milik Anda appsettings.json dan log/ folder, atau N untuk menghapus semuanya.

Penyelesaian Masalah

macOS mengatakan “tidak dapat dibuka karena pengembang tidak dapat diverifikasi” +
Hapus atribut karantina Gatekeeper dari folder yang diekstrak sebelum menjalankan skrip instalasi: xattr -dr com.apple.quarantine qs-agent/lalu jalankan kembali sudo bash install.shAtau, kunjungi Pengaturan Sistem > Privasi & Keamanan lalu klik “Tetap Izinkan Saja” setelah upaya pertama yang diblokir.
Agen tersebut tidak muncul secara online. +
Periksa log: tail -50 /usr/local/querystreams/agent/logs/agent-stdout.logPenyebab umum: kunci otentikasi yang salah dimasukkan di antarmuka web lokal. http://localhost:1823; port keluar 443 diblokir oleh proxy (uji dengan curl -v https://my.querystreams.com); Gatekeeper masih memblokir (konfirmasi bahwa atribut karantina telah dihapus sebelum instalasi).
Pengujian koneksi basis data gagal. +
Lakukan pengujian dari Mac tempat Agent diinstal. Agent harus dapat terhubung langsung ke host dan port database. Pastikan juga nama pengguna database memiliki akses baca ke tabel atau tampilan yang akan Anda kueri.
Apakah saya sebaiknya menggunakan ARM64 atau x64? +
Pergi ke Menu Apple > Tentang Mac IniJika chip tersebut bertuliskan “Apple M1/M2/M3/M4”, gunakan ARM64Jika menampilkan “Intel Core”, gunakan x64Menggunakan versi build yang salah masih tetap berfungsi melalui Rosetta 2, tetapi versi build asli yang sesuai selalu lebih diutamakan.
Apakah saya perlu membuka port firewall masuk? +
Tidak. Agen membuat koneksi terenkripsi keluar ke Query Streams. Permintaan kueri melewati koneksi tersebut, sehingga Anda tidak mengekspos PostgreSQL, MySQL, SQL Server, atau basis data lainnya ke internet publik. Tidak diperlukan perubahan pada macOS Firewall.
Di mana kredensial basis data disimpan? +
Kredensial basis data disimpan di /usr/local/querystreams/agent/appsettings.json pada mesin Agen. Query Streams cloud tidak memerlukan kata sandi basis data mentah Anda untuk mengarahkan permintaan kueri melalui Agen.
Di mana saya dapat menambahkan, mengedit, atau menghapus konektor? +
Gunakan dasbor lokal Agen Jaringan di http://localhost:1823Portal Query Streams adalah tempat Anda membuat kueri tersimpan dan berbagi akses setelah Agen mengkonfigurasi konektor.
Bagaimana cara kerja pembaruan otomatis di macOS? +
Agen memeriksa portal untuk rilis baru yang sesuai dengan platform Anda (osx-arm64 atau osx-x64). Bila tersedia, ia akan membongkar plist launchd, mencadangkan appsettings.json, mengekstrak biner baru, memulihkan konfigurasi, dan memuat ulang layanan — sepenuhnya otomatis, tanpa tindakan pengguna.

Memulai

Instal macOS Agent dan hubungkan sumber data pertama Anda.

Jalankan skrip instalasi satu perintah, konfigurasikan konektor secara lokal di localhost:1823, lalu simpan kueri yang dapat digunakan kembali untuk Excel, Google Sheets, otomatisasi, MCP, REST API, dan Nova AI.

Unduh Agen macOS

Panduan terkait: Instal Agen Query Streams di Windows | Instal Agen Query Streams di Linux | Instal Add-on Query Streams untuk Google Sheets | Menggunakan Query Streams dengan Microsoft Excel

Kategori: Pengaturan

Tag: macOS, Query Streams Agent, Network Agent, Setup, Database Connector, launchd

Deskripsi Meta: Instal Query Streams Agent di macOS dan hubungkan basis data langsung dengan aman sebagai daemon launchd.

Updated on 2 Juli 2026

What are your Feelings

  • Happy
  • Normal
  • Sad

Powered by BetterDocs