Ürün kılavuzu

mg CLI

Cihazları, alarmları, script’leri ve çalıştırmaları terminalden yönetin. Yapay zeka ajanınıza da SKILL.md ile aynı kontrolleri verin.

mg CLI Nedir#

mg, Moftgate Center’ın komut satırı arayüzüdür. macOS, Linux ve Windows için tek bir statik binary’dir ve Center’ınızla API üzerinden konuşur. Konsolda yaptığınız her işin (cihaz listeleme, alarm triajı, script çalıştırma, çalıştırma takibi) bir komut karşılığı vardır.

mg iki kitle için aynı anda tasarlandı: terminali tercih eden operatörler ve üretilen SKILL.md dosyası üzerinden aynı komutları kullanan AI ajanları.

shell

mg auth login
mg device list --group Servers --limit 3
mg alert list --severity critical

Kurulum ve Profiller#

Profiller sayesinde tek mg binary’si birden çok Center’la konuşur: üretim Center’ınız, bir staging ortamı ya da bir müşteri kiracısı. Her profil bir URL ve kendi kimlik bilgilerini saklar.

shell

mg --version
mg profile create prod https://center.example.local
mg profile use prod
mg profile list
mg profile delete staging

Profil silme

mg profile delete profili kaldırır ve önce mg auth logout çalıştırmanızı önerir; böylece token yalnızca yerelden silinmez, sunucuda da iptal edilir.

Kimlik Doğrulama#

1
Profili Center’ınıza gösterin
mg profile create <name> <url> ile Center URL’sini kaydedin, ardından mg profile use <name> ile seçin. Birden çok profil; üretim, staging veya müşteri kiracıları arasında geçiş sağlar.
2
Tarayıcıdan oturum açın
mg auth login tarayıcı onay akışını açar. Onayladıktan sonra CLI’ya bir token üretilir ve aktif profil altında yerel olarak saklanır.
3
Oturumu doğrulayın
mg auth status aktif oturumu ve token’ın ait olduğu organizasyonu gösterir.
4
İşiniz bitince çıkış yapın
mg auth logout token’ı Center’da iptal eder ve profilin yerel kimlik bilgilerini siler.

shell

mg auth login
mg auth status
mg auth logout

Cihaz Komutları#

Komut	Açıklama	Kapsam
mg device list	Cihazları listeler. Filtreler: --group, --tag, --status, --os.	Okuma
mg device inspect <id\|hostname>	Tek cihazın detayını gösterir: OS, ajan sürümü, son görülme, duruş puanı.	Okuma
mg device export	Cihaz envanterini raporlama veya başka araçlara aktarım için CSV olarak dışa aktarır.	Okuma

shell

mg device list --os "Ubuntu" --status online
mg device inspect web-01
mg device export --limit all

Alarm Komutları#

Komut	Açıklama	Kapsam
mg alert list	Alarmları listeler. Filtreler: --device, --severity, --status.	Okuma
mg alert inspect <id>	Tek alarmın detayını ve kanıtlarını gösterir.	Okuma
mg alert resolve <id>	Alarmı çözümlenmiş olarak işaretler. --yes geçilmedikçe onay ister.	Yazma

shell

mg alert list --device web-01 --status open
mg alert inspect a-4821
mg alert resolve a-4821 --yes

Script Komutları#

Komut	Açıklama	Kapsam
mg script list	Center script kütüphanesindeki kayıtlı script’leri listeler.	Okuma
mg script run --command "…" --device <id>	Tek cihazda ad-hoc komut çalıştırır.	Yazma
mg script run --script <name> --group <g> --wait	Kayıtlı script’i bir cihaz grubunda çalıştırır ve sonuçları bekler.	Yazma

shell

mg script list
mg script run --command "journalctl -u nginx --no-pager -n 50" --device web-01
mg script run --script "Restart nginx" --group Web --wait

Filoyu bekleyin

--wait flag’i, hedeflenen her cihaz sonuç bildirene kadar CLI’yı bağlı tutar; böylece grup çalıştırmaları kuyruğa alınmış bir iş değil, eksiksiz bir sonuç tablosu döndürür.

Çalıştırma Komutları#

Ad-hoc ya da kayıtlı her script çalıştırması bir run üretir. Run’lar neyin nerede ve hangi sonuçla çalıştığını gösteren denetim izidir.

Komut	Açıklama	Kapsam
mg run list	Aktif ve tamamlanmış çalıştırmaları listeler.	Okuma
mg run inspect <id>	Çalıştırma detayını aksiyon bazlı durumla gösterir.	Okuma
mg run cancel <id>	Devam eden bir çalıştırmayı iptal eder.	Yazma
mg run retry <id>	Çalıştırmanın başarısız aksiyonlarını yeniden dener.	Yazma

shell

mg run list --status failed
mg run inspect r-9042
mg run retry r-9042 --yes

Çıktı Formatları ve Global Flag’ler#

Liste komutları varsayılan olarak renkli ve okunaklı bir tablo basar. Makinenin okuyacağı çıktı için -o json, alanları doğrudan seçmek için --jq kullanın. --jq kullanınca çıktı JSON olur. mg device export CSV üretir.

shell

mg device list -o json
mg device list --jq '.list[] | {id, hostname, status}'
mg device list --limit all --jq '.list | length'

Flag	Açıklama
--version	mg CLI sürümünü basar ve çıkar. Kurulumu doğrulamak veya sorun bildirmek için kullanın.
--profile <name>	Komutu varsayılan yerine belirli bir profille çalıştırır.
-o, --output <fmt>	Çıktı formatı: json veya table. Varsayılan table’dır.
--jq <filter>	Çıktıya jq filtresi uygular. JSON çıktısını ima eder.
--limit <n\|all>	Sayfa başına öğe sayısı. Varsayılan: 100. Tüm sonuç kümesi için all kullanın.
--page <n>	Sayfalı liste komutları için sayfa numarası.
--yes	Riskli yazma işlemlerinde etkileşimli onayı atlar.
--ca-bundle <path>	On-premises self-signed sertifikalar için özel CA bundle kullanır.
--insecure	TLS doğrulamasını kapatır. Yalnızca geliştirme içindir. Üretimde kullanmayın.

AI Ajanlarıyla Kullanım#

mg, yerleşik bir skill üreteciyle gelir. SKILL.md, .agents/skills kuralını okuyan kodlama ajanlarına (Claude Code, Codex, Gemini ve diğerleri) kimlik doğrulamayı, mevcut komutları ve kullanılacak flag’leri öğretir.

Komut	Açıklama
mg skill show	SKILL.md’yi kurmadan stdout’a basar.
mg skill install	Kullanıcı seviyesindeki ajanlar için SKILL.md’yi ~/.agents/skills/moftgate/SKILL.md dosyasına yazar.
mg skill install --project	SKILL.md’yi mevcut projenin ./.agents/skills/moftgate/SKILL.md dosyasına yazar.
mg skill describe <command>	Tek komutun detayını gösterir: kullanım, flag’ler, örnekler, jq tarifleri.

shell

mg skill install            # user level: ~/.agents/skills/moftgate/SKILL.md
mg skill install --project  # repo level: ./.agents/skills/moftgate/SKILL.md
mg skill describe script run

Bir token, iki kullanıcı

Ajanınız ayrı bir kimlik bilgisi almaz. Aynı profildeki mg auth login token’ını kullanır. Ajanın yaptığı her yazma işlemi Center denetim kaydında size atfedilir.

Güvenlik ve TLS#

Token’lar tarayıcı onay akışıyla profil bazında üretilir ve mg auth logout ile iptal edilir.
Yazma işlemleri (alarm çözme, script çalıştırma, çalıştırma iptal/yeniden deneme) token’ı üreten kullanıcıda yazma yetkisi ister.
Riskli işlemler etkileşimli onay ister; --yes, CI ve otomasyon için prompt’u atlar.
Self-signed sertifikalı on-premises Center’lar için doğrulamayı kapatmak yerine --ca-bundle <path> kullanın.
--insecure, TLS doğrulamasını tamamen kapatır. Geliştirme içindir. Asla üretim Center’ına yöneltmeyin.

Üretimde doğrulamayı asla kapatmayın

TLS doğrulamasını atlayan bir CLI, saldırganın sunucusuna yönlendirilebilir ve ona geçerli bir token teslim eder. --insecure’i yalnızca yerel geliştirme kaçışı olarak görün.

Sık Sorulan Sorular#

mg hangi platformlarda çalışır?

mg; macOS, Linux ve Windows için tek bir statik binary’dir. Moftgate Center’ınızla API üzerinden konuşur; ek sunucu veya gateway gerekmez.

mg ayrı lisans gerektirir mi?

Hayır. mg, mg auth login ile aldığı token üzerinden mevcut Center’ınıza bağlanır. İlk yıl 200 endpoint ücretsiz katmanı CLI kullanımında da geçerlidir.

CI hatlarında mg’yi nasıl script’lerim?

Etkileşimli onayları atlamak için --yes, makine okunur çıktı için -o json (veya --jq) kullanın. Etkileşimsiz shell’lerde prompt gösterilmez.

AI ajanı hangi yetkiyi alır?

Token’ı üreten kullanıcının yetkisini. Token kullanıcının rolünü miras alır: salt-okuma token’ları listeleyip inceleyebilir; alarm çözme veya script çalıştırma gibi işlemler yazma yetkisi ister.

mg self-signed sertifikalı on-premises Center’a bağlanabilir mi?

Evet. --ca-bundle <path> ile özel CA’nızı gösterin. --insecure flag’i doğrulamayı tamamen kapatır ama yalnızca geliştirme ortamında tutun.