키보드, URL 스킴 및 문제 해결

이 마지막 장은 FrontierStack으로 무엇을 할 수 있는지 이미 알고 있고 그 작업을 더 빨리 하고 싶을 때, 또는 무언가가 빨간색으로 표시되어 가장 빠르게 녹색으로 되돌리고 싶을 때 펼쳐 보는 참고 자료입니다. 키보드 단축키, frontierstack:// URL 스킴, 앱이 자체 로그를 보관하는 위치, 그리고 실제로 자주 발생하는 문제에 대한 증상별 해결 표를 모았습니다. 반드시 읽어야 하는 내용은 아니지만, 모두 시간을 절약해 줍니다.

18.1키보드 단축키

FrontierStack은 네이티브 Mac 앱이므로 이미 익숙한 시스템 단축키 — 윈도우를 닫는 ⌘W, 설정을 여는 ⌘,, 종료하는 ⌘Q — 가 모두 동작합니다. 여기에 앱 자체의 단축키가 소수 추가되어 있습니다. 기본 방침은 절제입니다. 대부분의 동작은 이름이 분명한 버튼에 있고, 거의 모든 대화상자가 Return으로 확인하고 Esc로 취소하는 Mac의 관례를 따르므로 따로 외울 것이 거의 없습니다.

나머지 기능은 메뉴 막대에서 다룹니다. 전용 Services, Locations, Monitors, Presets, Palettes 메뉴를 사용하면 키보드에서 손을 떼지 않고 서비스를 전환하고, 위치를 바꾸고, 모니터를 켜고 끄고, 저장된 프리셋을 적용하거나 플로팅 팔레트를 띄울 수 있습니다. 이들은 실제 메뉴 명령이므로 시스템 설정 ▸ 키보드 ▸ 키보드 단축키 ▸ 앱 단축키에서 원하는 단축키를 지정할 수 있습니다. FrontierStack을 추가하고 메뉴 항목의 정확한 이름을 입력한 다음 키를 고르십시오.

여러 윈도우나 팔레트가 서로를 가릴 때는 Palettes › Organize Windows & Palettes를 선택하십시오. FrontierStack은 연결된 각 디스플레이에서 보이는 크기 조절 가능한 윈도우를 메뉴 막대와 Dock을 제외한 영역에 디스플레이별로 따로 배치합니다. 일반 윈도우는 주 영역을, 플로팅 팔레트는 공간이 허락하면 옆쪽 레일을 사용하고, 미니 팔레트는 작은 크기를 유지합니다. 윈도우는 현재 디스플레이에 그대로 머물며, 확인·승인 패널 등 일시적인 패널은 이동하지 않습니다. 정리된 팔레트 위치는 수동으로 배치한 레이아웃과 마찬가지로 활성 셋업에 저장됩니다.

18.2frontierstack:// URL 스킴

FrontierStack은 frontierstack:// URL 스킴을 등록하여 어떤 패널, 서버, 서비스로든 바로 딥 링크할 수 있습니다. 이러한 URL을 열면 앱이 앞으로 나오고 해당 위치로 이동합니다. 알맞은 사이드바 그룹을 펼치고 목적지까지 스크롤합니다. 이 방식으로 메모 속 링크, 단축어 동작, 스크립트의 한 줄이 여러분(또는 팀원)을 정확히 필요한 화면으로 보낼 수 있습니다.

터미널에서는 open으로, 단축어에서는 URL 열기 동작으로 실행하며, 메모나 웹 페이지에서는 일반 링크로 사용합니다. 형식은 다음과 같습니다.

몇 가지 예시입니다.

open "frontierstack://pane/Security"
open "frontierstack://server/mac-mini-office"
open "frontierstack://website/example.com"

딥 링크는 FrontierStack 자동화를 이어 주는 연결 조직입니다. 프리셋에는 해당 대시보드로 이동하는 링크를 넣을 수 있고, Notes의 런북은 각 단계를 그 작업을 수행하는 패널에 연결할 수 있으며, 알림 메시지는 장애가 난 서비스를 가리킬 수 있습니다. 같은 스킴은 MCP 서버가 공개하는 AI용 읽기 전용 리소스 두 가지 — frontierstack://capabilities와 frontierstack://health — 의 이름으로도 쓰입니다(14장 참조).

18.3앱 자체 로그 읽기

Logs 패널은 이 Mac뿐 아니라 어떤 기기의 로그든 읽습니다. 상단의 Machine 선택기로 연결된 서버로 전환하면 그 서버의 로그를 SSH로 가져옵니다. 해당 서버에 FrontierStack 모니터가 설치되어 있다면 모니터를 통해 가져오며, 모니터는 root로 실행되므로 sudo 없이도 권한이 필요한 로그에 접근합니다. 소스 메뉴에는 선택한 기기에서 실제로 실행 중인 서비스(Apache, Nginx, MySQL, PHP-FPM, PostgreSQL, Redis, Ollama)가 먼저 나오고, 이어서 발견된 그 밖의 로그 파일, 마지막으로 충돌 보고서 및 진단 정보가 나옵니다. 이는 콘솔이 보여 주는 .ips, .crash, .panic 파일로, 사용자 및 시스템 DiagnosticReports 폴더 양쪽에서 최신순으로 표시됩니다.

서비스가 아니라 FrontierStack 앱 자체가 무엇을 했는지 알아야 할 때는 살펴볼 곳이 세 군데 있으며, 아래로 갈수록 자세합니다.

• 변경 로그(감사). Logs 패널에는 모든 설정 및 구성 변경을 책임 주체와 함께 기록하는 변경 로그가 있습니다. 주체는 User, AI 하네스, Web 제어판, MCP, Automation 중 하나입니다. 서비스가 중단되었을 때 무엇이 그 서비스를 건드렸고 누가 또는 무엇이 책임이 있는지 정확히 알려 주므로, 어떤 장애에서든 가장 먼저 확인할 곳입니다.
• 앱 내 콘솔. 설치와 셸 명령은 앱 안의 실제 터미널 윈도우(PTY이므로 암호 입력 요청과 y/n 질문도 동작)에서 실행되며 출력이 실시간으로 표시됩니다. 앱은 명령이 끝나는 시점을 알기 때문에 명령을 실행한 패널을 새로 고칩니다. 콘솔의 동작 막대에서 기록을 내보낼 수 있습니다. 테마는 Overview의 Terminal Style에서 설정합니다.
• 로그 파일. FrontierStack은 자체 로그를 ~/Library/Logs/FrontierStack에 기록합니다. 원본 기록이 필요할 때는 Finder에서 이 폴더를 열거나 Console.app에서 읽으십시오. 앱이 무엇을 하고 있었는지 가장 자세히 알 수 있는 기록입니다. 자동 내보내기 기능(Overview ▸ 설정)을 사용하면 이 로그와 변경 로그, 설정 백업을 일정에 따라 폴더로 복사할 수 있습니다.

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 항목을 모두 그대로 두고 소유자 전용 브리지만 설치하며, Bearer 토큰은 클라이언트 구성이 아니라 키체인에 보관됩니다. Amp 설정은 Amp의 원격 스레드나 터미널 기능을 활성화하지 않습니다. 네트워크에 공개하는 MCP는 별도의 명시적인 선택이며, 페어링되고 범위가 지정된 호출자에게만 TLS로 제공됩니다.

클라이언트가 “connection refused”를 보고하거나 FrontierStack 브리지를 시작하지 못하는 경우(~/Library/Application Support/FrontierStack/mcp-bridge).브리지 자체에는 문제가 없습니다. FrontierStack이 종료되어 있고 백그라운드 서비스도 실행되지 않아 MCP 포트에서 응답하는 프로세스가 없었던 것입니다. 이제 브리지는 첫 호출 시 FrontierStack을 숨긴 상태로 시작하고 기다리므로, 재시작 후 첫 요청은 최대 1분까지 걸릴 수 있습니다. MCP 패널에 백그라운드 서비스를 시작할 수 없다는 경고가 표시되면 Repair Background Service를 클릭하십시오. macOS가 서비스가 등록된 앱 사본에서 실행하기를 거부하고 있었던 것이며, 이는 다시 빌드하거나 앱을 옮긴 뒤에 발생합니다. 이제 각 클라이언트 행에 개별 복구 결과가 표시되며, 설치되지 않은 클라이언트에는 Install…이 표시됩니다.

MCP 패널에 “Address already in use”가 표시되는 경우. 다른 프로세스가 아직 MCP 포트를 점유하고 있습니다. 대개 충돌했거나 멈춘 FrontierStack(이전 빌드 또는 멈춰 버린 백그라운드 서비스)이 포트를 해제하지 않은 경우입니다. FrontierStack은 먼저 몇 초 동안 다시 시도합니다. 그래도 포트가 사용 중이면 Restart 옆의 Free Port…를 클릭하십시오. 해당 프로세스를 찾아 아직 응답하는지 확인합니다. 더 이상 응답하지 않는 FrontierStack 사본이면 확인 대화상자에 이름을 표시한 뒤 중지하고, 해제된 포트에서 MCP를 재시작합니다. 아직 응답하는 사본이나 FrontierStack이 아닌 프로그램은 절대 중지하지 않습니다. 패널에 그 이름이 표시되므로 직접 종료하거나 다른 포트를 선택하십시오.

이는 앱 전체에 걸친 작은 설계 원칙과 연결됩니다. MCP 서버, 앱 단축키, AI 등 외부 접점이 변경을 거부할 때는 단순히 “안 됩니다”라고만 말하지 않습니다. 이유와 어디에서 켜야 하는지를 알려 줍니다. 예를 들어 거부 메시지는 “변경이 꺼져 있습니다 — AI 관리자에서 활성화하십시오”라고 하거나, MCP의 경우 Remote Control & Lock ▸ MCP에서 활성화하십시오라고 안내합니다. 스위치를 직접 켜 주겠다고 제안하는 대신 앱으로 안내하는 이유가 바로 신뢰 모델의 핵심입니다. 원격 에이전트는 요청할 수 있지만, 허가할 수 있는 것은 이 Mac 앞에 있는 여러분뿐입니다. 따라서 거부는 결코 막다른 길이 아니라, 막힌 곳을 풀어 줄 토글 하나를 가리키는 이정표입니다.

18.6메일 문제 해결: 클라이언트가 메일을 보낼 수 없는 경우

메일 장애는 겹겹이 쌓입니다. 인증서 문제가 TLS 문제를 가리고, TLS 문제가 로그인 문제를 가리며, 로그인 문제가 발신자 문제를 가립니다. 순서대로 해결하고, 서버를 조사하기 전에 클라이언트가 이미 가지고 있는 증거부터 읽으십시오.

클라이언트 자체의 기록부터 확인하십시오. Apple Mail에서 윈도우 › 연결 진단 › 세부사항 보기를 선택하십시오. 연결 로깅을 켜 두면 Mail은 모든 기록을 ~/Library/Containers/com.apple.mail/Data/Library/Logs/Mail/에 서버 및 계정별 파일로 보관하므로, 한 시간 전에 실패한 전송도 읽을 수 있습니다. 중요한 줄은 RCPT TO 다음의 응답입니다.

서버 쪽은 FrontierStack이 대신 처리합니다. 읽기 전용 Scripts 프리셋 Mail: why modern clients can't send (legacy Server.app)은 서버 측 결함을 모두 수정 순서대로 점검하고, 서버의 Mail Server Policy 섹션은 SMTP 정책 전체를 감사하며, AI 관리자는 서버의 로그인 실패를 읽고 위의 수정 사항을 적용할 수 있습니다. 각 변경은 승인 카드를 거칩니다.

18.7메일 암호 추측 공격 차단

인터넷에 노출된 메일 서버는 IMAP, POP, SMTP로 암호를 추측하는 봇에게 24시간 내내 공격을 받습니다. 해법은 fail2ban으로 널리 알려진 방식입니다. 로그인 실패를 감시하다가 계속 실패하는 주소를 차단하는 것입니다. 중요한 것은 임계값을 올바르게 정하고, 자기 쪽 사람은 절대 차단하지 않는 것입니다.

차단하기 전에 측정하십시오. AI 관리자에게 서버의 로그인 실패 기록을 읽도록 요청하십시오. 오래된 Apple Server.app 호스트에서는 /Library/Logs/Mail/mail-err.log에 있으며, Postfix가 Dovecot을 통해 암호를 확인하므로 세 프로토콜이 모두 기록됩니다. 느린 분산 공격을 예상하십시오. 백 개 이상의 주소가 각각 5분에서 30분마다 한 번씩만 시도합니다. fail2ban의 일반적인 규칙인 10분 내 5회 실패로는 거의 잡히지 않으므로, 24시간 기준으로 집계하십시오.

프리셋을 사용하려면 메일 서버를 대상으로 지정하고 Run as root를 켜십시오. 처음에는 시험 실행으로 동작합니다. 차단할 주소를 모두 나열할 뿐 아무것도 변경하지 않습니다. 그 목록을 읽은 다음 MODE를 install로 바꾸고 다시 실행하십시오. 차단 목록은 pf 앵커에 들어가므로 /etc/pf.conf는 전혀 편집되지 않으며, 백그라운드 작업이 1분마다 다시 확인하므로 재부팅해도 차단이 풀리지 않습니다. 시스템 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도움 받기

다음 세 가지 자료가 여러분을 지원하며, 바로 이용할 수 있는 순서로 나열했습니다.

• 앱 내 도움말 윈도우. ⌘?를 누르거나 도움말 ▸ FrontierStack 도움말을 선택하면 내장 설명서가 열립니다. AI 기능을 먼저 소개하고 모든 패널과 서비스를 다룹니다. 많은 패널에는 도움말의 해당 섹션을 여는 ? 버튼도 있습니다. 도움말의 “앱에서 열기” 링크를 누르면 설명하는 패널로 바로 이동하며, 도움말은 열린 채로 주 윈도우가 앞으로 나옵니다.
• 웹사이트 도움말 및 FAQ. frontierstack.app/help는 앱 내 설명서를 탐색하기 쉬운 형태로 제공하며, FAQ는 새 사용자가 가장 많이 묻는 질문에 답합니다. 마이그레이션 가이드는 frontierstack.app/migrate에 있습니다.
• 지원 및 피드백. frontierstack.app/support에서 두 가지 간단한 양식으로 팀에 직접 연락할 수 있습니다. 문제가 있을 때는 지원 요청(macOS 버전을 기재하십시오)을, FrontierStack을 더 좋게 만들 아이디어가 있을 때는 기능 요청을 보내십시오. 둘 다 앱을 만드는 사람들에게 바로 전달됩니다.

이것으로 이 설명서를 마칩니다. 여러분은 FrontierStack을 제어판으로, 모니터링 시스템으로, 그리고 AI 관리자로 만나 보았습니다. 웹 스택을 구축하고, 플릿을 연결하고, 경계를 강화하고, 알림을 연결했으며, 서버를 보고 고칠 수 있는 어시스턴트에게 — 신중하게, 여러분의 조건으로 — 열쇠를 넘겨주었습니다. 나머지는 실천입니다. 앱 내 도움말을 위해 ⌘?를 가까이 두고, 최신 정보가 필요하면 frontierstack.app을 방문하고, 다음에 원하는 기능이 있으면 지원을 통해 알려 주십시오. FrontierStack으로 서버를 운영해 주셔서 감사합니다.