⚠ 속기는 fill_document로 파일을 새로 만듭니다(원본은 수정하지 않습니다).
저장 경로를 확인하시고, 중요한 문서는 사본으로 먼저 시험해 보세요.
한컴오피스는 필요 없습니다. 읽기는 순수 파이썬 OLE 파서, 쓰기는 HWPX(ZIP+XML)라
윈도우·맥·리눅스 어디서나 라이선스 없이 동작합니다.
1단계 — uv 를 설치합니다. 심을 자동으로 내려받아 실행해 주는 도구입니다(1회).
Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
💡 터미널 여는 법 — 윈도우: 시작 메뉴에 cmd 입력 · 맥: 스포트라이트(⌘Space)에 터미널 입력
2단계 — 속기 심은 따로 설치하지 않습니다.
아래 등록 명령에 uvx 가 들어 있어, 실행할 때 자동으로 내려받아 돕니다.
심 패키지는 속기 서버가 직접 배포합니다 —
현재 배포판 확인. 아래 명령에 그 주소가 이미 들어 있으니 그대로 쓰시면 됩니다.
3단계 — 위 탭에서 여러분이 쓰는 도구를 골라 이어서 진행하세요.
터미널에서 아래 한 줄을 실행하면 끝입니다.
키를 연결하면 표시됩니다.
💡 --env 바로 뒤에 서버 이름을 두면 CLI가 이름을 환경변수로 잘못 읽습니다.
위 명령은 그 순서를 지켜 만들어져 있으니 그대로 복사해 쓰세요.
확인: 새 세션을 열고 /mcp 를 입력하면 sokgi 이 목록에 보입니다.
1) Claude 앱 좌측 하단의 내 이름(계정) 클릭 → 설정(Settings) 을 엽니다.
2) 왼쪽 목록에서 개발자(Developer) 를 고르고 설정 파일 편집(Edit Config) 을 누릅니다.
그러면 설정 파일이 있는 폴더가 열립니다.
버튼이 안 보이면 직접 파일을 여세요 —
Windows %APPDATA%\Claude\claude_desktop_config.json ·
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
3) claude_desktop_config.json 을 메모장(또는 텍스트 편집기)으로 열고 아래를 붙여넣습니다.
파일에 이미 내용이 있으면 mcpServers 안쪽에 sokgi 항목만 추가하세요.
키를 연결하면 표시됩니다.
4) 저장한 뒤 Claude를 완전히 종료했다가 다시 실행합니다.
창만 닫으면 반영되지 않습니다 — 윈도우는 작업표시줄 아이콘에서 종료, 맥은 ⌘Q 입니다.
확인: 대화창 하단의 도구/커넥터 아이콘에 sokgi 이 보이면 성공입니다.
터미널에서 아래를 실행합니다.
키를 연결하면 표시됩니다.
또는 ~/.codex/config.toml 을 직접 편집해도 됩니다.
키를 연결하면 표시됩니다.
확인: Codex 세션에서 /mcp 를 입력하면 연결 상태와 도구 목록이 나옵니다.
ChatGPT 데스크톱 앱은 로컬 MCP(STDIO)를 지원합니다. 앱에서 이렇게 등록하세요.
1) ChatGPT 앱 설정 → 플러그인 → MCP 탭 → 맞춤형 MCP에 연결
2) 각 칸에 아래 값을 입력합니다.
| 칸 | 넣을 값 |
|---|
| 이름 | sokgi |
| 유형 | STDIO 선택 |
| 실행 명령 | uvx |
| 인자 | 키를 연결하면 표시됩니다 |
| 환경 변수 | 키를 연결하면 표시됩니다 |
| 작업 중인 디렉토리 | 비워둠 |
3) 저장을 누르면 끝입니다. 대화에서 extract_documents 도구가 보이면 성공입니다.
참고: ChatGPT 웹사이트의 커넥터(개발자 모드)는 원격 HTTPS만 받아 속기를 등록할 수 없습니다 —
반드시 데스크톱 앱을 쓰세요.