MDMでGnistaを、
プロファイル1つで。
チームプランがあれば、IT部門は構成プロファイルでGnistaのキーを配布し、設定を固定できます。カスタムプロファイルをインストールできるMDMなら、どれでも。ここにあることはすべて任意です。MDMのないチームは、キーを共有するだけで使えます。
更新：
仕組み
Gnistaは自分のドメインsh.gnista.Gnistaの管理対象の設定を読みます。これはcom.apple.ManagedClient.preferencesペイロードを含む構成プロファイルで配布されます（MDMによってはカスタム設定や環境設定ファイルと呼ばれます）。プロファイルが管理する設定には、Gnista内で「組織によって管理されています」と表示され、そこでは変更できません。
管理対象の設定は、チームのキーでのみ有効です。LicenceKeyはどのキーでも使えます。個人のキーの場合、Gnistaはほかの設定を無視し、設定に「一元管理にはチームプランが必要です。」と表示します。プロファイルにキーと設定の両方がある場合、Gnistaはまずキーをアクティベートし、それから設定を適用します。
LicenceKeyとDisplayMode以外のキーは、テンプレートのように、プロファイルが「Forced」で強制した場合にだけ有効です。どのキーも任意です。Gnistaが知らないキーは無視されます。
キー
| キー | 型 | 役割 |
|---|---|---|
LicenceKey | 文字列（String） | 誰もキーを入力せずにGnistaをアクティベートします。Macにライセンスがない間は、起動のたびに試みます。どのキーでも使えます。 |
EnabledAgents | 文字列の配列（Array） | Gnistaに接続できるのは、ここにあるエージェントだけになり、表示されるのもそのセッションだけです。名前は下の表を参照。 |
ApprovalsAllowed | ブール値（Boolean） | falseにすると、Gnistaでの応答そのものをオフにします。どのエージェントも、自身の確認画面で確認を求めます。 |
ApprovalAgents | 文字列の配列（Array） | Gnistaで応答してよいエージェント。 |
CrashReportsMode | 文字列（String） | クラッシュレポートの扱い：ask（クラッシュの後に確認する）、always、never。 |
AutomaticUpdates | ブール値（Boolean） | trueにすると自動アップデートがオンになり、スイッチがロックされます。falseにすると、Gnistaは自分でアップデートを確認しなくなり、展開をIT部門で行えます。 |
RemoteMachinesAllowed | ブール値（Boolean） | falseにすると、リモートマシンがオフになります。GnistaはSSHトンネルを閉じ、設定からサーバを接続できなくなります。 |
RemoteConnection | 文字列（String） | リモートマシンの接続方法：automatic（Gnista 自身の ssh で転送）、relay（Gnista 自身の ssh で転送なし。通常のコマンド）、manual（Gnista 自身の ssh なし。ssh 設定の 1 行で、利用者自身のセッションが運ぶ）。 |
ListSummaryAllowed | ブール値（Boolean） | falseにすると、「エージェントの作業を説明」がオフになります。これらのMacでは、Apple Intelligenceが行の説明を書くことはありません。 |
DisplayMode | 文字列（String） | Gnistaの表示場所：notch、menuBar、both。強制すれば固定され、テンプレートのように一度だけ設定すれば、利用者が変更できる初期値になります。 |
エージェントの名前
EnabledAgentsとApprovalAgentsでは、Gnistaのヘルパーと同じ名前でエージェントを指定します：
| 名前 | エージェント |
|---|---|
claude | Claude Code |
cowork | Claude Cowork |
codex | Codex |
gemini | Gemini CLI |
copilot | GitHub Copilot |
opencode | OpenCode |
devin | Devin |
qwen | Qwen Code |
qwenwork | QwenWork |
qoder | Qoder CLI |
qoder-cn | Qoder CN |
qoderwork | QoderWork |
droid | Factory Droid |
cursor | Cursor |
antigravity | Antigravity |
vibe | Mistral Vibe |
codebuddy | CodeBuddy |
workbuddy | WorkBuddy |
kimi | Kimi Code |
kilo | Kilo Code |
mimocode | MiMoCode |
zcode | ZCode |
amp | Amp |
auggie | Auggie |
goose | Goose |
pi | Pi |
omp | Oh My Pi |
openhands | OpenHands |
grok | Grok Build |
trae | Trae |
trae-cn | Trae CN |
codewhale | Codewhale |
aider | Aider |
dsh | DeepSeek Harness |
VS CodeのCopilotはcopilotになります。カスタムエージェントは、そのファイルの名前で指定します。Gnistaでの応答は、claude、codex、devin、opencode、qwen、qoder、qoder-cn、codebuddy、workbuddy、droid、kilo、mimocode、zcode、kimi、ompで使えます。ApprovalAgentsにほかの名前を入れても、何も変わりません。
プロファイル
すべてのキーを含む完全なプロファイルです。テンプレートも同じ内容で、各キーにコメントがついています。管理したいキーを残し、キーを入れ、2つのPayloadUUIDの値を自分のものに変えてください（ターミナルでuuidgenを実行）。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>PayloadDisplayName</key>
<string>Gnista</string>
<key>PayloadDescription</key>
<string>Gnista's licence key and settings for your team.</string>
<key>PayloadIdentifier</key>
<string>sh.gnista.Gnista.profile</string>
<key>PayloadOrganization</key>
<string>Your organisation</string>
<key>PayloadScope</key>
<string>System</string>
<key>PayloadType</key>
<string>Configuration</string>
<key>PayloadUUID</key>
<string>00000000-0000-4000-8000-000000000001</string>
<key>PayloadVersion</key>
<integer>1</integer>
<key>PayloadContent</key>
<array>
<dict>
<key>PayloadDisplayName</key>
<string>Gnista settings</string>
<key>PayloadIdentifier</key>
<string>sh.gnista.Gnista.profile.preferences</string>
<key>PayloadType</key>
<string>com.apple.ManagedClient.preferences</string>
<key>PayloadUUID</key>
<string>00000000-0000-4000-8000-000000000002</string>
<key>PayloadVersion</key>
<integer>1</integer>
<key>PayloadContent</key>
<dict>
<key>sh.gnista.Gnista</key>
<dict>
<key>Forced</key>
<array>
<dict>
<key>mcx_preference_settings</key>
<dict>
<key>LicenceKey</key>
<string>GNISTA-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</string>
<key>EnabledAgents</key>
<array>
<string>claude</string>
<string>codex</string>
</array>
<key>ApprovalsAllowed</key>
<true/>
<key>ApprovalAgents</key>
<array>
<string>claude</string>
</array>
<key>CrashReportsMode</key>
<string>never</string>
<key>AutomaticUpdates</key>
<false/>
<key>RemoteMachinesAllowed</key>
<true/>
<key>RemoteConnection</key>
<string>relay</string>
</dict>
</dict>
</array>
<key>Set-Once</key>
<array>
<dict>
<key>mcx_data_timestamp</key>
<date>2026-10-15T00:00:00Z</date>
<key>mcx_preference_settings</key>
<dict>
<key>DisplayMode</key>
<string>notch</string>
</dict>
</dict>
</array>
</dict>
</dict>
</dict>
</array>
</dict>
</plist>ユーザではなく、Mac（テンプレートと同じくデバイスレベル）を対象にしてください。
Jamf Pro
- Jamf ProでComputers、Configuration Profilesの順に進み、Uploadを選びます。編集した
gnista.mobileconfigを選んでください。 - Generalペイロードを確認します。レベルはComputer、配布方法はInstall Automatically。
- Gnistaを使うコンピュータかスマートグループを対象にして、保存します。
Jamfの中で作りたい場合は、新しいプロファイルを作成し、Application & Custom Settingsを追加して、キーだけを書いたプロパティリストをアップロードし、環境設定ドメインにsh.gnista.Gnistaを指定します。
Kandji
- KandjiでLibraryを開き、Custom Profileを追加します。
- 編集した
gnista.mobileconfigをアップロードし、Macにインストールされる設定になっていることを確認します。 - Gnistaを使うMacのBlueprintsに割り当てて、保存します。
Microsoft Intune
- Intune管理センターでDevices、macOS、Configurationの順に進み、新しいポリシーを作成します。
- プロファイルの種類にTemplatesを選び、次にCustomを選びます。
- 名前をつけ、デバイスチャネルを選んで、編集した
gnista.mobileconfigをアップロードします。 - Gnistaを使うMacのデバイスグループに割り当てて、作成します。
IntuneのPreference fileテンプレートでもかまいません。環境設定ドメインにsh.gnista.Gnistaを指定し、キーだけを書いたプロパティリストをアップロードします。
Mosyle
- MosyleでManagement、Custom Profilesの順に進み、新しいプロファイルを追加します。
- 編集した
gnista.mobileconfigをアップロードします。 - Gnistaを使うデバイスかデバイスグループに割り当てて、保存します。
Macで確かめる
プロファイルは、システム設定 ▸ 一般 ▸ デバイス管理に表示されます。設定はMacの管理対象の環境設定に入ります：
defaults read "/Library/Managed Preferences/sh.gnista.Gnista"Gnistaの設定では、管理対象の設定に「組織によって管理されています」と表示され、設定 ▸ 情報 ▸ ライセンスにはチームのライセンスが表示されます。展開する前にプロファイルを試すには、テスト用のMacでダブルクリックし、システム設定でインストールしてください。