キーボード・URL スキーム・トラブルシューティング

最終章は、FrontierStack が何をするかを既に分かっていて「もっと速くやりたい」とき、あるいは何かが赤くなって「最短で緑に戻したい」ときに開くリファレンスです。キーボードショートカット、frontierstack:// URL スキーム、アプリ自身のログの在りか、そして実際に起きる不具合の症状→対処表をまとめます。どれも必読ではありませんが、すべてが時間を節約します。

18.1キーボードショートカット

FrontierStack はネイティブ Mac アプリなので、既にご存じのシステムショートカット — ⌘W でウィンドウを閉じる、⌘, で設定、⌘Q で終了 — がすべて使えます。その上に、アプリは小さく意図的な独自セットを追加しています。方針は抑制です。ほとんどの操作は明確にラベル付けされたボタンにあり、ほぼすべてのダイアログは Return で確定・Esc でキャンセルという Mac の慣習に従うため、覚えることはまずありません。

残りの操作はメニューバーが担います。専用の Services・Locations・Monitors・Presets・Palettes メニューから、キーボードを離れずにサービス切り替え・ロケーション変更・モニタの切り替え・保存済みプリセットの適用・フローティングパレットの取り出しができます。これらは本物のメニューコマンドなので、macOS のシステム設定 ▸ キーボード ▸ キーボードショートカット ▸ アプリのショートカットから、任意のものに独自のキーを割り当てられます — FrontierStack を追加し、メニュー項目名を正確に入力してキーを選びます。

複数のウインドウやパレットが互いを隠している場合は、Palettes › Organize Windows & Palettes を選びます。FrontierStack は接続ディスプレイごとに、メニューバーと Dock を除いた領域へ、表示中でリサイズ可能なウインドウを並べます。通常ウインドウには主領域を割り当て、余裕があればフローティングパレットをサイド列に並べ、ミニパレットはコンパクトなままにします。ウインドウは現在のディスプレイに残り、確認、承認などの一時パネルは移動しません。整列後のパレット位置は、手動レイアウトと同様に現在の Setup へ保存されます。

18.2frontierstack:// URL スキーム

FrontierStack は frontierstack:// URL スキームを登録しており、任意のペイン・サーバ・サービスへ直接ディープリンクできます。そうした URL を開くとアプリが前面に出て遷移します — 該当するサイドバーグループを展開し、目的地までスクロールします。これにより、ノート内のリンク、ショートカットのアクション、スクリプトの一行が、あなた（やチームメイト）を的確な画面へ送り出せます。

Terminal からは open で起動し、ショートカットでは 「URL を開く」アクションを使い、ノートや Web ページでは普通のリンクになります。形式は次のとおりです。

実例をいくつか挙げます。

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 章）。

18.3アプリ自身のログを読む

Logs ペインはこの Mac だけでなく、どのマシンのログも読めます。上部のマシンピッカーで連携サーバに切り替えると、ログは SSH 経由、または FrontierStack モニタが入っていればそれ経由で取得されます（モニタは root で動作するため、特権ログにも sudo は不要）。ソースのメニューには、選んだマシンで実際に稼働しているサービス（Apache・Nginx・MySQL・PHP-FPM・PostgreSQL・Redis・Ollama）が先頭に並び、続いて見つかったその他のログファイル、最後にクラッシュレポートと診断 — Console が表示する .ips・.crash・.panic を、ユーザとシステム両方の DiagnosticReports フォルダから新しい順に — が表示されます。

サービスではなく FrontierStack 自身が何をしたかを知りたいときは、深さの順に 3 か所を見ます。

• 変更ログ（監査）。Logs ペインには、設定・構成のすべての変更を、実行した主体 — ユーザ、AI ハーネス、Web コントロールパネル、MCP、自動化 — とともに記録する変更ログがあります。サービスが停止した際、何が触れて誰／何が責任を負うのかを正確に教えてくれます — どんな障害でも最初に問うべき最速の質問です。
• アプリ内コンソール。インストールやシェルコマンドはアプリ内の本物のターミナルウィンドウ（PTY なのでパスワード入力や y/n の質問が機能します）で実行され、出力をライブで流します。アプリはコマンドの終了を把握するため、起動元のペインを更新します。コンソールのアクションバーから記録をエクスポートできます。配色は Overview の Terminal Style で変更します。
• ログファイル。FrontierStack は自身のログを ~/Library/Logs/FrontierStack に書き込みます。生の記録が欲しいときは、このフォルダを Finder で開くか Console.app で読みます — アプリの挙動を最も詳細に記録しています。自動エクスポート機能（Overview ▸ Settings）は、これらのログ・変更ログ・設定バックアップをスケジュールでフォルダへコピーできます。

18.4よくある問題と対処

FrontierStack の不具合のほとんどは、小さく見慣れた一群のいずれかで、アプリは通常その対処を面倒な作業ではなくボタンとして提供します。下表は、目にする症状を、緑へ戻る最短経路に対応づけます。

18.5MCP オンボーディングと「行動につながる拒否」

機会を得た最初の一度だけ、アプリは — 一度だけ — 外部の AI ツールから FrontierStack を使えるよう MCP サーバを起動するか尋ねます。プロンプトはモデルを率直に説明します。サーバは localhost のみで、既定で読み取り専用です。Start MCP server で有効化し、同じシート上の任意のトグルでその場で変更を許可できます。Not now は単に「尋ねられたこと」を記録します。サーバは、あなたが選ぶまでオフのままです（第 14 章）。

MCP ペインの Detected AI clients は Amp・Grok・Codex CLI・Cursor・Gemini CLI・Claude Code・Claude Desktop・Xcode を認識します。クライアントを個別に設定するか、Set Up Detected を使うか、起動時の設定を有効にします。FrontierStack は無関係な MCP エントリをすべて保持し、自身の所有者専用ブリッジだけを導入します。ベアラートークンはクライアント設定ではなく Keychain に残ります。Amp のリモートスレッドやターミナル機能は有効にしません。ネットワーク公開 MCP は別の明示的な選択で、TLS 上のペアリング済み・スコープ設定済み呼び出し元に限ります。

クライアントが「connection refused」を報告する、または FrontierStack のブリッジ（~/Library/Application Support/FrontierStack/mcp-bridge）の起動に失敗する。ブリッジ自体は正常で、FrontierStack が閉じていてバックグラウンドサービスも動いていなかったため、MCP ポートに応答するものがありませんでした。現在のブリッジは最初の呼び出しで FrontierStack を非表示で起動して待つため、再起動後の最初のリクエストには最大 1 分ほどかかることがあります。MCP ペインがバックグラウンドサービスを起動できないと警告する場合はバックグラウンドサービスを修復をクリックします。macOS が登録元のアプリのコピーからの起動を拒否していた状態で、再ビルドやアプリの移動のあとに起きます。各クライアントの行には修復の結果が表示され、未インストールのクライアントには Install… があります。

MCP ペインに「Address already in use」と表示される。別のプロセスがまだ MCP ポートを占有しています。多くはクラッシュまたはハングした FrontierStack（以前のビルドや、固まったバックグラウンドサービス）がポートを解放しなかったものです。FrontierStack はまず数秒間再試行します。それでも空かない場合は、再起動の横のポートを解放…をクリックします。ポートを使っているプロセスを探し、まだ応答するかを確認します。応答しなくなった FrontierStack は確認画面で名前を示したうえで停止し、空いたポートで MCP を再起動します。まだ応答するコピーや FrontierStack 以外のプログラムは決して停止しません。ペインに名前が表示されるので、自分で終了するか別のポートを選んでください。

これは、アプリ全体を貫く小さな設計思想につながります。外部の面 — MCP サーバ、App Shortcut、AI — が変更を拒否するとき、ただ「いいえ」とは言いません。理由とどこで有効化するかを伝えます。拒否はたとえば「変更がオフです — AI 管理者で有効にしてください」、あるいは MCP なら「Remote Control & Lock ▸ MCP で有効にしてください」と読めます。自分で切り替えるのではなくアプリへ誘導するのは、信頼モデルの核心です — リモートのエージェントは依頼できても、許可できるのはこの Mac の前にいるあなただけです。ゆえに拒否は決して行き止まりではなく、あなたを前へ進める唯一のトグルへの道標です。

18.6メールのトラブルシューティング：クライアントから送信できない

メールの障害は積み重なります。証明書の問題が TLS の問題を隠し、それがログインの問題を、さらに差出人の問題を隠します。順番に確認し、サーバを調べる前にクライアントがすでに持っている証拠を読みましょう。

まずクライアント自身の記録から。Apple Mail でウインドウ › 接続診断 › 詳細を表示を選びます。接続のログを有効にしていれば、Mail はすべての記録を ~/Library/Containers/com.apple.mail/Data/Library/Logs/Mail/ にサーバとアカウントごとのファイルで残すので、1 時間前に失敗した送信も読めます。大事なのは RCPT TO の次の応答です。

サーバ側は FrontierStack が引き受けます。読み取り専用のスクリプトプリセットMail: why modern clients can't send (legacy Server.app) がサーバ側の障害を修正順にすべて確認し、サーバのメールサーバポリシーセクションが SMTP ポリシー全体を監査します。AI 管理者はサーバのログイン失敗を読み、上の対処を行えます — 変更はすべて承認カードを通ります。

18.7メールのパスワード総当たりを遮断する

インターネット上のメールサーバは、IMAP・POP・SMTP でパスワードを推測するボットに昼夜を問わず狙われます。対策は fail2ban で知られる方法です。ログインの失敗を監視し、失敗を繰り返すアドレスを遮断します。肝心なのは、しきい値を正しく決めることと、自分たちの利用者を決して遮断しないことです。

遮断する前に測る。AI 管理者にサーバのログイン失敗を読ませます。古い Apple Server.app ホストでは /Library/Logs/Mail/mail-err.log にあり、Postfix が Dovecot でパスワードを確認するため 3 つのプロトコルすべてを網羅します。多くはゆっくりした分散型で、100 以上のアドレスがそれぞれ 5〜30 分おきにしか試しません。fail2ban の通常のルール（10 分間に 5 回）ではほとんど捕まらないため、24 時間単位で数えます。

プリセットはメールサーバを対象にし、root で実行をオンにします。最初はドライランで、遮断する予定のアドレスをすべて一覧するだけで何も変更しません。一覧を読んだら MODE を install に変えてもう一度実行します。遮断は pf のアンカーに置くため /etc/pf.conf は編集せず、バックグラウンドのジョブが毎分確認するので再起動しても元に戻りません。システムの Python を使い、Homebrew は不要です。

遮断しないアドレスもあります。プライベートアドレス（社内ネットワーク、VPN、Tailscale）、/var/db/mailguard/ignore に書いたもの、過去 14 日以内にログインに成功したアドレスです。自宅でパスワードを打ち間違えた利用者は遮断されません。

実際の通信で確かめる。10 分ほど後、遮断したアドレスから新しい失敗が出ていないことを確認します。残る失敗はまだ見ていないアドレスからだけのはずです。普段は sudo /usr/local/mailguard/mailguard.py status で遮断の一覧、unban で解除、/var/log/mailguard.log に判断の記録が残ります。遮断したアドレスは受信メールを含むすべてのポートで遮断されます。ボットはポート 25 でもログインするためです。遮断はすべて期限で解除されます。AI 管理者のスキルMail Password-Guessing Block がこの手順を案内します。

18.8ほかでは開くのに、ここだけ開かないサイト

DNS は応答するのにサイトが開かないとき、原因は自分、ISP、途中のネットワーク、サイトのホストのいずれにもありえます。推測では半日かかりますが、場所を変えて結果を比べれば 1 分で決着します。ツールの接続プローブがそれを行います（AI 管理者に「なぜサイトが開かないか」と尋ねても同じです）。

判定は、接続がどこで止まり、なぜか、次に何をすべきかを示し、宛先側の問題であればそのネットワークの NOC や abuse の連絡先も挙げます。ルータの内側の機器はすべて 1 つのグローバルアドレスを共有するため、ブロックの原因は 1 台の機器の行動であることがよくあります。ログイン失敗の繰り返し、大量のクロール、頻繁すぎる監視などです。

18.9ヘルプを得る

即時性の順に、3 つのリソースがあなたを支えます。

• アプリ内ヘルプウィンドウ。⌘? を押すかヘルプ ▸ FrontierStack Help を選ぶと、AI 機能を先頭に、すべてのペインとサービスを網羅した内蔵ドキュメントが開きます。多くのペインには該当セクションでヘルプを開く ? ボタンもあります。ヘルプの「アプリで開く」リンクは、説明対象のペインへ直接ジャンプします — ヘルプは開いたまま、メインウィンドウが前面に出ます。
• ウェブのヘルプと FAQ。frontierstack.app/help はアプリ内ドキュメントを閲覧しやすい形で映し、FAQ は新規ユーザが最もよく尋ねる質問に答えます。移行ガイドは frontierstack.app/migrate にあります。
• サポートとフィードバック。frontierstack.app/support の 2 つの短いフォームがチームに直接届きます。不具合のときはサポート依頼（macOS のバージョンを添えてください）、改善案には機能リクエスト。どちらもアプリを作る人々へ直接届きます。

これでマニュアルは閉じます。あなたは FrontierStack を、コントロールパネルとして、監視システムとして、AI 管理者として知りました。Web スタックを立ち上げ、フリートを連携し、境界を堅牢化し、アラートを配線し、そして — 慎重に、あなたの条件で — サーバを把握し修正できるアシスタントに鍵を委ねました。あとは実践あるのみです。アプリ内ヘルプには ⌘? をいつも近くに、最新情報は frontierstack.app へ、そして次に欲しいものはサポートからお聞かせください。FrontierStack でサーバを運用してくださり、ありがとうございます。