문서

StudioCat 시작하기

StudioCat은 웹용 ChatGPT를 Mac의 프로젝트에 연결합니다. 무엇을 할지는 ChatGPT가 정하고, StudioCat이 로컬에서 실행합니다. 모든 호출을 설정한 권한과 대조하고, 모든 변경 사항을 워크벤치에 표시합니다.

요구 사항

macOS 14 이상의 Mac.
웹에서 개발자 모드를 사용할 수 있는 ChatGPT 계정. iPhone, iPad, Android용 ChatGPT는 아직 사용자 지정 MCP 서버를 호출할 수 없습니다.
터널과 API 키를 만들 수 있는 OpenAI Platform 조직. 모델 API 요금은 발생하지 않습니다.
프로젝트에서 이미 쓰고 있는 툴체인(Go, Swift, Node 등). StudioCat은 이를 실행할 뿐 포함하지는 않습니다.

설치

서명과 공증을 거친 DMG를 내려받아 열고, StudioCat을 ‘응용 프로그램’ 폴더로 끌어다 놓으세요. StudioCat은 자동으로 업데이트되며, 설치 전에 확인을 요청합니다. 비공개 베타 기간에는 홈페이지에서 참여를 신청하세요.

처음 실행하면 설정 지원이 다음 세 단계를 안내합니다. 나중에 상단 막대의 터널 상태나 StudioCat → 설정 지원…에서 언제든지 다시 열 수 있습니다.

1 · 터널 만들기

Platform → Tunnels를 열어 터널을 만들고 Tunnel ID(tunnel_…)를 복사합니다.
Platform → API keys를 열어 키를 만듭니다. Restricted를 선택하고 Tunnels: Read와 Use만 켭니다.
계정이 여러 조직(예: 개인 조직과 회사 조직)에 속해 있다면, 터널을 소유한 조직의 ID(org-…, Settings → Organization에 있음)를 적어 둡니다.

2 · StudioCat 연결

Tunnel ID와 API 키, 필요하면 조직 ID를 설정 지원(또는 설정 → 일반 → 터널 자격 증명)에 붙여 넣고 저장 후 연결을 선택합니다. 자격 증명은 macOS 키체인에 저장됩니다. 연결되면 상단 막대의 터널 상태가 초록색으로 바뀝니다. Mac은 나가는 HTTPS 연결만 하며, StudioCat은 포트를 열지 않습니다.

3 · ChatGPT에 MCP 서버 추가

데스크톱 브라우저에서 chatgpt.com/plugins를 엽니다. 추가하는 곳이 보이지 않으면 먼저 ChatGPT 고급 설정에서 개발자 모드를 켜세요.
이름이 StudioCat인 MCP 서버를 추가합니다. Connection에서 Tunnel을 선택하고 터널을 고릅니다(또는 Tunnel ID를 붙여 넣습니다).
저장하고 새로 고친 다음, StudioCat을 켠 새 채팅을 시작합니다. 이렇게 보내 보세요: “StudioCat을 사용해 내 프로젝트 루트에 있는 파일을 나열해 주세요.”

나중에 다른 터널로 바꾸면 ChatGPT의 MCP 서버도 새 터널을 가리키도록 바꾸세요. 그렇지 않으면 터널 클라이언트가 연결되지 않았다는 오류가 납니다.

프로젝트와 권한

StudioCat은 파일 → 프로젝트 열기…(⌘O)로 연 프로젝트 안에서만 작업합니다. 프로젝트를 열 때 무엇을 허용할지 정합니다.

읽기, 검색, 편집, 패치, 체크포인트, 코드 인텔리전스는 프로젝트 안에서 기본적으로 허용됩니다.
터미널(명령 실행)과 커밋은 기본적으로 꺼져 있습니다. 프로젝트별로 켜거나, ChatGPT가 처음 요청할 때 승인하세요.
위험한 패턴과 일치하는 명령은 Mac에서 확인을 요청합니다. 거부하면 그것으로 끝이며 아무것도 실행되지 않습니다.

확인이 두 번인 것은 의도된 설계입니다. ChatGPT는 호출을 보낼지 묻고, StudioCat은 위험한 호출을 실행하기 전에 묻습니다. 어느 쪽도 다른 쪽을 대신하지 않습니다.

검토와 되돌리기

워크벤치에 호출이 그 자리에서 표시되고, 출력에는 명령 출력이 표시됩니다.
모든 편집은 변경 검토의 카드가 됩니다. 되돌리기는 이름 변경과 파일 모드까지 포함해 파일을 복원합니다. 이후 파일이 다시 바뀌었다면, 오래된 카드는 새 편집을 덮어쓰지 않고 되돌리기를 거부합니다.
체크포인트는 프로젝트 스냅숏을 숨겨진 git ref에 저장합니다. 브랜치, HEAD, 인덱스, stash는 전혀 건드리지 않습니다.

체크포인트는 백업이 아닙니다. 터미널에서 rm -rf로 삭제했고 git이 무시하는 파일(build/ 등)은 복구할 수 없습니다.

여러 프로젝트 동시 작업

ChatGPT 대화는 처음 작업한 프로젝트에 연결됩니다. 워크벤치에 표시할 프로젝트를 바꿔도 대화는 백그라운드에서 자기 프로젝트의 작업을 계속합니다. 대화에서 (명시적인 경로로) 다른 프로젝트를 열면 그 대화가 그쪽으로 옮겨집니다.

문제 해결

“API Key가 올바르지 않습니다”: 키 전체를 다시 복사하거나 새로 만드세요. 취소된 키는 즉시 작동을 멈춥니다.
“이 키로는 터널을 사용할 수 없습니다”(tunnel_use_forbidden): 키에 Tunnels Read와 Use 권한을 부여하세요. 새 권한이 적용되기까지 몇 분 걸릴 수 있습니다.
“조직 ID가 필요합니다”(tunnel_active_organization_required): 키가 여러 조직에 속해 있습니다. 설정에서 터널의 조직 ID를 입력하고 다시 연결하세요.
ChatGPT가 터널 클라이언트가 연결되지 않았다고 합니다: 상단 막대에 터널이 연결됨으로 표시되는지, ChatGPT의 MCP 서버가 StudioCat과 같은 터널을 사용하는지 확인하세요.
웹에서는 되는데 휴대폰에서는 안 됩니다: 예상된 동작입니다. ChatGPT 모바일 앱은 아직 사용자 지정 MCP 서버를 호출할 수 없습니다.
OpenAI에 연결할 수 없습니다: 네트워크를 확인하세요. 프록시를 사용한다면 시스템 프록시가 켜져 있는지 확인하세요. StudioCat은 그 설정을 따르며 스스로 다시 시도합니다.

데이터와 제거

설정, 권한, 로그, 로컬 감사 로그는 ~/.cache/StudioCat/에 저장됩니다.
터널 자격 증명은 키체인 항목 StudioCat.mcp-tunnel에 저장됩니다. 설정 → 제거로 삭제할 수 있습니다.
제거하려면 StudioCat을 종료하고 휴지통으로 옮긴 다음 ~/.cache/StudioCat/를 삭제하세요. ChatGPT에서 MCP 서버를 제거하고 Platform에서 API 키를 취소하세요.