1. 당신의 AI와 대화
평소 쓰던 Claude에게 말로 시키면 됩니다.
분석·글쓰기 같은 “생각”은 전부 당신의 AI가 합니다.
이력서·자기소개서·지원 현황을 이 컴퓨터 안에서 관리하세요.
분석과 글쓰기는 평소 쓰던 AI가, 데이터 보관은 CareerMate가 맡습니다.
CareerMate는 내 컴퓨터에서 도는 로컬 도구예요. 그래서 Claude Desktop · Claude Code · Codex처럼 내 컴퓨터의 프로그램을 띄울 수 있는 AI에서 동작합니다.
설치를 마쳤다면 대시보드 http://127.0.0.1:4319에서 내 데이터를 확인하세요.
CareerMate 안에는 AI가 들어 있지 않습니다.
생각하는 일은 당신의 AI가, 데이터 보관은 CareerMate가 맡습니다.
평소 쓰던 Claude에게 말로 시키면 됩니다.
분석·글쓰기 같은 “생각”은 전부 당신의 AI가 합니다.
표준 프로토콜 MCP가 AI와 CareerMate를 잇는 “USB-C” 역할을 합니다.
AI가 24개 도구로 당신의 커리어 DB를 읽고 씁니다.
모든 데이터는 로컬 SQLite(~/.careermate)에만 저장됩니다.
외부 서버로 전송하지 않습니다. 대시보드로 눈으로 확인하세요.
프로필 정리부터 면접 준비까지, AI와 대화만으로 이어집니다.
모든 기록은 이 컴퓨터의 대시보드(127.0.0.1:4319)에 모입니다. 아래는 실제 화면입니다.
빈 폴더 잡고 한 문장이면 끝.
터미널이 익숙하면 한 줄 설치, 싫으면 파일 하나로 — 무료도 있습니다.
Claude 데스크톱의 “Code” 탭처럼 폴더를 잡고 작동하는 AI 앱이면 별도 터미널 없이 앱 안에서 끝납니다(Codex는 CLI 권장 — 데스크톱 앱은 등록이 사라지는 버그가 있어요). 작업 폴더 하나를 정하고 아래 문장만 주면, 에이전트가 공개 안내(careermate.life/llms-install.txt)를 읽고 그 폴더 안에 설치·연결합니다 — 데이터까지 그 폴더에 모여(.cm/data) 백업·이동이 폴더 하나로 끝.
Claude 데스크톱 → Code 탭에서 빈 폴더를 작업 폴더로 선택(Pro 이상 구독, Windows는 Git 먼저). Codex는 빈 폴더에서 codex(CLI, ChatGPT Plus 이상)로 실행하세요 — 데스크톱 앱은 현재 등록이 사라지는 버그(openai/codex#24718)가 있어 권하지 않습니다.
https://careermate.life/llms-install.txt 를 읽고, 그 안내대로 CareerMate를 이 폴더에 설치하고 연결해줘. 데이터도 이 폴더의 .cm/data 안에 저장하고, Node 설치처럼 시스템에 바꿀 게 있으면 실행 전에 먼저 알려줘. 설치가 끝나면 앱 재시작 방법과 이력서를 주는 법, 대시보드 주소(http://127.0.0.1:4319)도 알려줘.
준비물은 Node.js 22.5 이상 하나뿐. 없으면 에이전트가 먼저 확인하고 설치를 도와줍니다. 데이터는 작업 폴더의 .cm/data에만 저장됩니다. (Codex CLI는 설치 단계에서 네트워크 허용을 한 번 물을 수 있어요 — 허용하면 됩니다.)
AI 앱을 완전히 종료했다 다시 켜고(처음 한 번 승인을 물으면 허용), “get_onboarding_status 호출해서 확인해줘”로 점검하세요. Codex는 /mcp로도 확인됩니다.
준비물은 Node.js 22.5 이상 하나. 감지된 AI 앱(Claude Desktop·Codex·Cursor)의 MCP 설정에 CareerMate를 자동 등록합니다.
터미널(Windows는 PowerShell)에 붙여넣고 실행하세요. 클론도 빌드도 필요 없습니다. node --version이 22.5 미만이면 nodejs.org에서 LTS를 먼저 설치하세요.
npx -y careermate init
특정 클라이언트만 등록하려면 npx -y careermate init --client cursor, 설정 JSON·명령만 보고 직접 붙여넣으려면 npx -y careermate init --print. (클라이언트: claude · claude-code · codex · cursor)
연결한 AI 앱을 완전히 종료했다 다시 켜고, “get_onboarding_status 호출해서 연결됐는지 확인해줘”라고 말해 결과가 돌아오면 정상입니다.
내 데이터를 눈으로 보려면 npx -y careermate start 실행 → http://127.0.0.1:4319. 종료는 Ctrl+C.
.mcpb 설치 파일로 추가 (터미널 없이)터미널·Node 없이 파일 하나로 끝나지만, Claude Desktop 내장 Node 버전에 따라 불안정할 수 있어요. 잘 안 되면 위 에이전트가 직접 설치 또는 터미널 한 줄을 쓰세요.
Claude Desktop → Settings(설정) → Extensions(확장)에서 Advanced settings(고급 설정)를 누르면 나오는 Install extension…으로 내려받은 careermate.mcpb를 선택하세요.
더블클릭·드래그는 Windows에서 파일 연결이 안 잡혀 반응이 없을 수 있으니, 위 설정 메뉴 경로를 쓰세요. (확장을 처음 설치하면 Advanced settings를 먼저 눌러야 버튼이 보입니다.)
Claude Desktop을 완전히 종료했다 다시 켜고, “get_onboarding_status 호출해서 확인해줘”로 점검하세요.
npx -y careermate init --print로 설정 JSON·명령만 출력해 클라이언트에 직접 추가할 수 있습니다. 클라이언트별 설정 파일 위치는 아래 탭을 참고하세요.
Windows: %APPDATA%\Claude\claude_desktop_config.json · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
(Settings → Developer → Edit Config 로도 열 수 있습니다. npx -y careermate init이 이 파일을 자동으로 수정합니다.)
프로젝트별: .cursor/mcp.json · 전역: ~/.cursor/mcp.json — Cursor·Cline·Windsurf 등 대부분 같은 형식입니다. 추가 후 클라이언트를 다시 시작하세요.
4319가 막히면 자동으로 다음 빈 포트로 옮겨갑니다. 터미널에 출력된 실제 주소를 사용하거나, CAREERMATE_PORT 환경변수로 고정하세요.
① npx -y careermate init이 정상 종료됐는지 ② node --version이 22.5 이상인지 ③ 클라이언트를 완전히 종료 후 재시작했는지 확인하세요. 폴더를 옮기거나 이름을 바꿨다면 등록된 경로가 깨질 수 있으니 init을 다시 실행하세요.
진단을 실행하면 Node 버전·데이터 폴더·DB 상태를 점검합니다.
npx -y careermate doctor
기본 위치는 ~/.careermate/careermate.sqlite(Windows: %USERPROFILE%\.careermate). CAREERMATE_DATA_DIR로 변경 가능. 완전 초기화는 careermate.sqlite 삭제 후 재실행(백업 권장)입니다.
대시보드 서버는 127.0.0.1(이 컴퓨터)에만 바인딩되어 외부에서 접근할 수 없고,
MCP 서버는 네트워크 호출을 하지 않습니다. 분석·글쓰기는 당신이 직접 고른 AI가 수행합니다.
~/.careermate/careermate.sqlite~/.careermate/exports로