第 18
キーボード・URL スキーム・トラブルシューティング
速い道と安全網。ショートカット、ディープリンク、アプリ自身のログ、そしてまれに起きる不具合への落ち着いた対処。
最終章は、FrontierStack が何をするかを既に分かっていて「もっと速くやりたい」とき、あるいは何かが赤くなって「最短で緑に戻したい」ときに開くリファレンスです。キーボードショートカット、frontierstack:// URL スキーム、アプリ自身のログの在りか、そして実際に起きる不具合の症状→対処表をまとめます。どれも必読ではありませんが、すべてが時間を節約します。
18.1キーボードショートカット
FrontierStack はネイティブ Mac アプリなので、既にご存じのシステムショートカット — ⌘W でウィンドウを閉じる、⌘, で設定、⌘Q で終了 — がすべて使えます。その上に、アプリは小さく意図的な独自セットを追加しています。方針は抑制です。ほとんどの操作は明確にラベル付けされたボタンにあり、ほぼすべてのダイアログは Return で確定・Esc でキャンセルという Mac の慣習に従うため、覚えることはまずありません。
| ショートカット | 動作 | メニュー相当 |
|---|---|---|
| ⌘F | 検索パレットを開く — あらゆるサービス・ツール・ペイン・アクションを名前で見つけて直接ジャンプ。 | ツールバーの虫眼鏡ボタン |
| ⌘? | アプリ内ヘルプウィンドウを開く。 | ヘルプ ▸ FrontierStack Help |
| ⌘⌥⇧W | すべてのフローティングパレットを閉じる。 | Palettes ▸ Close All Palettes |
| Return | シートの既定ボタン(保存・OK・追加・インストール…)を確定。 | 強調表示されたボタン |
| Esc | 現在のシートやパレットをキャンセル/閉じる。 | キャンセル/完了ボタン |
残りの操作はメニューバーが担います。専用の Services・Locations・Monitors・Presets・Palettes メニューから、キーボードを離れずにサービス切り替え・ロケーション変更・モニタの切り替え・保存済みプリセットの適用・フローティングパレットの取り出しができます。これらは本物のメニューコマンドなので、macOS のシステム設定 ▸ キーボード ▸ キーボードショートカット ▸ アプリのショートカットから、任意のものに独自のキーを割り当てられます — FrontierStack を追加し、メニュー項目名を正確に入力してキーを選びます。
18.2frontierstack:// URL スキーム
FrontierStack は frontierstack:// URL スキームを登録しており、任意のペイン・サーバ・サービスへ直接ディープリンクできます。そうした URL を開くとアプリが前面に出て遷移します — 該当するサイドバーグループを展開し、目的地までスクロールします。これにより、ノート内のリンク、ショートカットのアクション、スクリプトの一行が、あなた(やチームメイト)を的確な画面へ送り出せます。
Terminal からは open で起動し、ショートカットでは 「URL を開く」アクションを使い、ノートや Web ページでは普通のリンクになります。形式は次のとおりです。
| URL | 移動先 |
|---|---|
frontierstack://server/<名前または id> | そのフリートホストのペイン(不明な場合は Local Health にフォールバック)。 |
frontierstack://website/<ドメイン> | Sites ペイン。 |
frontierstack://container/<名前> | Docker ペイン。 |
frontierstack://pane/<名前> | 表示名による任意のペイン。例:pane/Security・pane/Apache・pane/Alerts。空白は URL エンコード(%20)。 |
frontierstack://service/<カタログ id> | id によるカタログサービス。 |
frontierstack://kube/<context> | Kubernetes コンテキスト(引数なしなら Clusters ペイン)。 |
frontierstack://security · ://alerts · ://health | Security・Alerts・Local Health ペインへのショートカット。 |
frontierstack://device/<id> · ://wifi/<ssid> · ://zone/<id> | 発見されたデバイス、Wi-Fi ネットワーク、Cloudflare ゾーン。 |
frontierstack://open?sel=<raw> | 厳密なエスケープハッチ:内部の選択値を正確に往復します。 |
実例をいくつか挙げます。
open "frontierstack://pane/Security"
open "frontierstack://server/mac-mini-office"
open "frontierstack://website/example.com"
ディープリンクは FrontierStack における自動化の結合組織です。プリセットはそのダッシュボードへ飛ぶリンクを含められます。Notes 内のランブックは各手順を、実施するペインへリンクできます。アラートメッセージは故障中のサービスを指し示せます。同じスキームは AI 向けの 2 つの読み取り専用リソース — frontierstack://capabilities と frontierstack://health — も名付けており、これらは MCP サーバが公開します(第 14 章)。
frontierstack:// URL はウィンドウを前面に出してロック解除を促しますが、遷移はしません — 外部の自動化がロック画面の裏でアプリを動かすことはできません。18.3アプリ自身のログを読む
サービスではなく FrontierStack 自身が何をしたかを知りたいときは、深さの順に 3 か所を見ます。
- 変更ログ(監査)。Logs ペインには、設定・構成のすべての変更を、実行した主体 — ユーザ、AI ハーネス、Web コントロールパネル、MCP、自動化 — とともに記録する変更ログがあります。サービスが停止した際、何が触れて誰/何が責任を負うのかを正確に教えてくれます — どんな障害でも最初に問うべき最速の質問です。
- アプリ内コンソール。インストールやシェルコマンドはアプリ内の本物のターミナルウィンドウ(PTY なのでパスワード入力や y/n の質問が機能します)で実行され、出力をライブで流します。アプリはコマンドの終了を把握するため、起動元のペインを更新します。コンソールのアクションバーから記録をエクスポートできます。配色は Overview の Terminal Style で変更します。
- ログファイル。FrontierStack は自身のログを
~/Library/Logs/FrontierStackに書き込みます。生の記録が欲しいときは、このフォルダを Finder で開くか Console.app で読みます — アプリの挙動を最も詳細に記録しています。自動エクスポート機能(Overview ▸ Settings)は、これらのログ・変更ログ・設定バックアップをスケジュールでフォルダへコピーできます。
read_log ツールは source に "frontierstack"(~/Library/Logs/FrontierStack を追尾)、"os"(システムログ)、あるいは "nginx" や "postfix" のようなサービス名を受け付けます。連携サーバでは SSH 経由で読み、出力はクラウドモデルに届く前に上限が設けられ秘密情報が伏せられます(第 13 章)。18.4よくある問題と対処
FrontierStack の不具合のほとんどは、小さく見慣れた一群のいずれかで、アプリは通常その対処を面倒な作業ではなくボタンとして提供します。下表は、目にする症状を、緑へ戻る最短経路に対応づけます。
| 症状 | 考えられる原因 | 対処 |
|---|---|---|
| サービスが起動しない。 | ポートが使用中、バイナリ未インストール、または設定が不正。 | そのサービスのペインを開いて状態の詳細を読みます。Ports in Use で競合を見つけ、Homebrew でインストール/修復し、Web サーバは再読込前に設定を検証します。AI 管理者の repair_service は、あなたの承認のもとで一般的なケースを診断・修正します。 |
| 連携サーバの状態ドットが赤:「Permission denied (publickey)」。 | サーバ再インストール、ホストキー変更、またはアプリの SSH キーが未導入。 | Repair SSH access(AI の repair_ssh_access ツール、第 8 章)を実行します。古いホストキーを消去し、ボールトの秘密として保存された一回限りのログインパスワードを使ってアプリの管理キーを再導入します — パスワードはローカルで読まれ、モデルには決して送られません。成功するとドットが緑になります。 |
| アラートが届かない。 | チャネルの設定ミス:誤ったトークン、未確認の送信者、不正な webhook。 | Alerts を開きます。送信ごとの配信エラーセクションが、どのチャネルがなぜ失敗したかを正確に示します。資格情報を直して配信エラーをクリアし、頼る前にテスト送信で確認します(第 11 章)。 |
| AI が操作を拒否する。 | 既定で読み取り専用、または特定のサーバトグルがオフ。 | AI 管理者で変更を許可(スクリプト実行を求める場合はスクリプトを許可も)、または該当するサーバごとのトグルを有効にします。拒否メッセージが該当設定を名指しします — 下記参照。 |
| Homebrew がない。 | 多くのサービスが依存するパッケージマネージャが未インストール。 | Homebrew ペイン(Overview)を開きます。アプリが Homebrew をインストールでき、その後は各サービスのペインからフォーミュラをワンクリック導入できます。 |
| 証明書が信頼されない。 | システムがまだ信頼していない自己署名/ローカル証明書。 | ローカル開発では、信頼されたローカル CA を導入する mkcert で発行します。公開サイトには Let's Encrypt を使います。どちらも Certificates と Sites ▸ TLS タブで管理します(第 7 章・第 10 章)。 |
18.5MCP オンボーディングと「行動につながる拒否」
機会を得た最初の一度だけ、アプリは — 一度だけ — 外部の AI ツール(Claude Code・Cursor・Claude Desktop)が FrontierStack を操作できるよう MCP サーバを起動するか尋ねます。プロンプトはモデルを率直に説明します:サーバは localhost のみ、トークン保護、そして既定で読み取り専用です。Start MCP server で有効化し、同じシート上の任意のトグルでその場で変更を許可できます。Not now は単に「尋ねられたこと」を記録します。サーバは、あなたが選ぶまでオフのままです(第 14 章)。
これは、アプリ全体を貫く小さな設計思想につながります。外部の面 — MCP サーバ、App Shortcut、AI — が変更を拒否するとき、ただ「いいえ」とは言いません。理由とどこで有効化するかを伝えます。拒否はたとえば「変更がオフです — AI 管理者で有効にしてください」、あるいは MCP なら「Remote Control & Lock ▸ MCP で有効にしてください」と読めます。自分で切り替えるのではなくアプリへ誘導するのは、信頼モデルの核心です — リモートのエージェントは依頼できても、許可できるのはこの Mac の前にいるあなただけです。ゆえに拒否は決して行き止まりではなく、あなたを前へ進める唯一のトグルへの道標です。
18.6ヘルプを得る
即時性の順に、3 つのリソースがあなたを支えます。
- アプリ内ヘルプウィンドウ。⌘? を押すかヘルプ ▸ FrontierStack Help を選ぶと、AI 機能を先頭に、すべてのペインとサービスを網羅した内蔵ドキュメントが開きます。多くのペインには該当セクションでヘルプを開く ? ボタンもあります。ヘルプの「アプリで開く」リンクは、説明対象のペインへ直接ジャンプします — ヘルプは開いたまま、メインウィンドウが前面に出ます。
- ウェブのヘルプと FAQ。frontierstack.app/help はアプリ内ドキュメントを閲覧しやすい形で映し、FAQ は新規ユーザが最もよく尋ねる質問に答えます。移行ガイドは frontierstack.app/migrate にあります。
- サポートとフィードバック。frontierstack.app/support の 2 つの短いフォームがチームに直接届きます。不具合のときはサポート依頼(macOS のバージョンを添えてください)、改善案には機能リクエスト。どちらもアプリを作る人々へ直接届きます。
これでマニュアルは閉じます。あなたは FrontierStack を、コントロールパネルとして、監視システムとして、AI 管理者として知りました。Web スタックを立ち上げ、フリートを連携し、境界を堅牢化し、アラートを配線し、そして — 慎重に、あなたの条件で — サーバを把握し修正できるアシスタントに鍵を委ねました。あとは実践あるのみです。アプリ内ヘルプには ⌘? をいつも近くに、最新情報は frontierstack.app へ、そして次に欲しいものはサポートからお聞かせください。FrontierStack でサーバを運用してくださり、ありがとうございます。
FrontierStack ユーザマニュアル · バージョン 1.0.0 · 第 18