속기 Sokgi 콘솔

⚠ 속기는 fill_document로 파일을 새로 만듭니다(원본은 수정하지 않습니다). 저장 경로를 확인하시고, 중요한 문서는 사본으로 먼저 시험해 보세요.

한컴오피스는 필요 없습니다. 읽기는 순수 파이썬 OLE 파서, 쓰기는 HWPX(ZIP+XML)라 윈도우·맥·리눅스 어디서나 라이선스 없이 동작합니다.

설치할 것이 없습니다. 파일 하나만 내려받으면 됩니다 — 파이썬도, 다른 도구도 필요 없습니다.

⬇ 속기 프로그램 내려받기 (Windows · 파일 정보 확인 중)

파일 크기와 SHA-256을 서버에서 확인하는 중입니다.

내려받은 파일은 실행하는 게 아니라 클로드가 부르는 프로그램입니다. 편한 곳에 두시고(예: C:\sokgi\sokgi-mcp.exe) 경로만 기억해 두세요.

⚠ 처음 실행할 때 윈도우가 "PC를 보호했습니다" 경고를 띄울 수 있습니다. 추가 정보 → 실행을 누르면 됩니다. (배포자 서명 전이라 뜨는 경고입니다.)

맥·리눅스를 쓰시거나, 개발 도구가 이미 있으시면 아래 방법이 더 간단합니다 — uv가 깔려 있다면 등록 명령 한 줄로 끝나고, 갱신도 자동입니다.

Windows:  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
macOS/Linux:  curl -LsSf https://astral.sh/uv/install.sh | sh

💡 터미널 여는 법 — 윈도우: 시작 메뉴에 cmd 입력 · 맥: 스포트라이트(⌘Space)에 터미널 입력 · 배포판 목록

다음 — 위 탭에서 여러분이 쓰는 도구를 골라 이어서 진행하세요.

터미널에서 아래 한 줄을 실행하면 끝입니다.

키를 연결하면 표시됩니다.

💡 --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만 받아 속기를 등록할 수 없습니다 — 반드시 데스크톱 앱을 쓰세요.