Claude 등 AI에게 Mac / Linux 보안 상태를 직접 물어보세요

1바이너리 위치

apt / rpm / AUR 패키지에 포함되어 있으며, 설치 시 자동으로 /usr/bin/roamswitch-mcp 에 배치됩니다. 별도의 다운로드나 빌드가 필요 없습니다(클라이언트 버전·Server Edition 공통).

/usr/bin/roamswitch-mcp

Server Edition(헤드리스 운영)에서도 동일한 바이너리와 설정 방법을 그대로 사용할 수 있습니다. 자세한 내용은 「운용 매뉴얼 (Linux Server)」의 「AI 에이전트 / MCP 연동 운영」장을 참고하세요.

2aClaude Desktop의 경우

Claude Desktop은 공식 Linux 버전이 제공되지 않습니다. 비공식 빌드(예: claude-desktop-debian 등)를 사용하는 경우 ~/.config/Claude/claude_desktop_config.json 의 "mcpServers" 에 아래 내용을 추가한 뒤 재시작하세요.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

2bClaude Code의 경우

터미널에서 아래 명령어를 한 번만 실행하면 됩니다.

claude mcp add roamswitch /usr/bin/roamswitch-mcp

2cOpenAI Codex CLI의 경우

~/.codex/config.toml에 아래 내용을 추가하거나, 터미널에서 아래 명령어를 실행하세요.

[mcp_servers.roamswitch]
command = "/usr/bin/roamswitch-mcp"

codex mcp add roamswitch -- /usr/bin/roamswitch-mcp

2dOpenCode의 경우

프로젝트 루트의 opencode.json(또는 전역 설정 ~/.config/opencode/opencode.json)에 다음을 추가하세요.

{
  "mcp": {
    "roamswitch": {
      "type": "local",
      "command": ["/usr/bin/roamswitch-mcp"]
    }
  }
}

💡 로컬 LLM 지원: Ollama나 LM Studio 등 로컬 모델과 연동 시, RoamSwitch가 위협 감지로 네트워크를 비상 차단한 상태에서도 완전 오프라인으로 즉시 안전 확인 및 조언 문의가 가능합니다.

2eAntigravity의 경우

~/.gemini/config/mcp_config.json(또는 워크스페이스 루트의 .agents/mcp_config.json)에 아래 내용을 추가하세요.

{
  "mcpServers": {
    "roamswitch": {
      "command": "/usr/bin/roamswitch-mcp"
    }
  }
}

* 참고: Antigravity CLI(agy) 등에서 도구 실행 시 Hook Failure 또는 텔레메트리 오류가 발생하는 경우, ~/.gemini/config/plugins/.../hooks.json 에서 "enabled": false 로 설정하여 훅을 비활성화하세요.