Mac의 AI 앱에서 Vocatim 녹음 사용하기

먼저 Vocatim에서

Mac에서 설정 → 데이터 및 기기 → 이 Mac의 AI 앱을 열고 기능을 켜세요. AI 앱이 볼 수 있는 내용을 설명하는 화면을 읽은 다음 켜기를 클릭하세요. 그런 다음 사용하는 AI 앱에 맞는 단계를 따르세요.

Claude Desktop

1. Claude Desktop에 설치를 클릭하고 Vocatim.mcpb를 원하는 위치(예: 다운로드 폴더)에 저장하세요. 파일이 저장되면 Vocatim이 Vocatim 키를 복사합니다.
2. Vocatim.mcpb를 여세요. Claude Desktop에 Vocatim 확장 프로그램이 표시되고 설치할지 묻습니다.
3. Claude Desktop이 Vocatim 키를 요청하면 붙여 넣으세요. vocatim-mcp 프로그램은 그대로 두세요.
4. 새 채팅에서 예를 들어 “Vocatim에 있는 내 가장 최근 녹음에서 우리가 무엇을 결정했나요?”라고 물어보세요. Claude가 Vocatim 도구를 허용해 달라고 요청할 수 있습니다.

설정 파일을 직접 편집하고 싶다면 Claude Desktop용 설정 복사를 클릭하세요. Claude Desktop에서 macOS 메뉴 막대의 Claude 메뉴(Claude 창 안의 설정이 아님)를 열고 Settings… → Developer → Edit Config를 선택하세요. 파일에 아직 "mcpServers"가 없으면 파일 내용을 아래의 전체 예시로 바꾸세요. 이미 서버가 나열되어 있으면 "vocatim" 항목만 "mcpServers" 안에 붙여 넣고, 그 항목과 바로 앞 항목 사이에 쉼표를 넣으세요. 파일을 저장하고 Claude Desktop을 완전히 종료한 다음 다시 여세요.

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPT와 Codex

1. ChatGPT 및 Codex용 설정 복사를 클릭하세요.
2. 텍스트 편집기에서 ~/.codex/config.toml 파일을 열거나, 아직 없으면 새로 만드세요. ~/.codex는 홈 폴더에 있는 숨김 폴더입니다. Finder에서 이동 → 폴더로 이동…을 선택하고 ~/.codex를 입력하세요.
3. 파일에 [mcp_servers.vocatim] 섹션이 없으면 파일 끝의 새 줄에 설정을 붙여 넣으세요. 이전 설정으로 인해 이 섹션이 이미 있으면 그 섹션 전체를 새 섹션으로 바꾸세요. 파일에 이 섹션이 두 번 들어 있으면 안 됩니다.
4. 파일을 저장하고 ChatGPT 또는 Codex를 다시 시작하세요.
5. 새 채팅에서 예를 들어 “Vocatim에 있는 내 가장 최근 녹음에서 우리가 무엇을 결정했나요?”라고 물어보세요. ChatGPT에서는 일반 채팅이 아니라 Codex 대화에서 Vocatim을 사용하세요.

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp list는 Args 열에 Vocatim 키를 표시합니다. 이 키는 이 Mac의 앱이 Vocatim을 읽을 수 있게 할 뿐이며, 그것도 Vocatim이 열려 있는 동안에만 가능합니다. 이 출력은 공유하지 마세요. 이미 공유했다면 Vocatim에서 “키 재설정”을 사용하세요.

VS Code, Cursor, LM Studio

1. VS Code에 설치, Cursor에 추가 또는 LM Studio에 추가를 클릭하세요. Vocatim이 Vocatim 설정과 함께 해당 앱을 엽니다.
2. 해당 앱에서 Vocatim을 추가하겠다고 확인하세요.
3. VS Code에서는 Vocatim이 Vocatim 키를 복사합니다. VS Code가 Vocatim 키를 요청하면 붙여 넣으세요. Cursor와 LM Studio는 설정과 함께 키를 받아 자체 설정에 저장합니다.
4. 해당 앱의 AI 채팅에서 예를 들어 “Vocatim에 있는 내 가장 최근 녹음에서 우리가 무엇을 결정했나요?”라고 물어보세요.

다른 앱: Cursor, LM Studio, JetBrains AI Assistant, Junie

1. 다른 앱용 설정 복사를 클릭하세요.
2. 앱의 MCP 설정을 여세요. Cursor에서는 ~/.cursor/mcp.json 파일, LM Studio에서는 해당 앱의 mcp.json, JetBrains AI Assistant에서는 Settings → Tools → AI Assistant → MCP와 Add, Junie에서는 ~/.junie/mcp/mcp.json 파일입니다.
3. 아직 "mcpServers"가 없으면 설정 전체를 붙여 넣으세요. 이미 서버가 나열되어 있으면 "vocatim" 항목만 "mcpServers" 안에 추가하거나, 이 항목으로 기존 "vocatim" 항목을 바꾸세요. 같은 항목이 두 번 들어가면 안 됩니다.
4. 저장한 다음 앱을 다시 시작하세요.

Zed

1. Zed용 설정 복사를 클릭하세요.
2. Zed에서 zed: open settings file을 실행하세요.
3. "context_servers" 부분을 그 파일의 가장 바깥쪽 중괄호 안에 넣으세요. "context_servers"가 이미 있으면 그 안에 "vocatim" 항목만 추가하거나, 이 항목으로 기존 "vocatim" 항목을 바꾸세요. 같은 항목이 두 번 들어가면 안 됩니다.
4. 파일을 저장한 다음 Zed를 다시 시작하세요.

터미널에서 Vocatim 사용하기(명령줄)

이 Mac의 터미널에서도 AI 앱이 사용하는 것과 같은 네 가지 읽기 전용 도구, 즉 목록, 검색, 음성 기록, 요약으로 녹음을 읽을 수 있습니다. 명령줄은 AI 앱과 같은 스위치와 같은 Vocatim 키를 사용하며, Vocatim이 열려 있고 스위치가 켜져 있을 때만 작동합니다.

1. 이 명령어를 복사하여 터미널 창에 붙여 넣되, 아직 Return 키는 누르지 마세요:

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. Vocatim에서 CLI 명령어 복사를 클릭하세요. Vocatim은 한 줄을 복사합니다. macOS의 기본 셸인 zsh용으로 vocatim이라는 이름을 붙인 별칭입니다.
3. 터미널로 돌아가 Return 키를 누르세요. 이 명령어는 복사한 줄을 ~/.zshrc 끝에 추가합니다. zsh는 터미널 창을 열 때마다 이 파일을 읽습니다. alias vocatim=으로 시작하는 줄만 추가하므로 클립보드의 다른 내용은 파일에 들어가지 않습니다.
4. 새 터미널 창을 열고 vocatim list를 입력하세요. 별칭은 3단계 이후에 연 창에서 작동합니다.

네 가지 명령어:

• vocatim list는 최근 녹음 20개를 한 줄에 하나씩 보여 줍니다(ID, 날짜와 시간, 길이, 제목). vocatim list --limit 50은 최대 50개를 보여 줍니다.
• vocatim search 예산은 제목, 음성 기록, 요약, 메모 또는 번역에 “예산”이 들어 있는 녹음을 찾습니다. 공백이 있는 검색어는 따옴표로 묶으세요: vocatim search "주간 검토". 결과는 최대 10개이며, --limit 20을 붙이면 최대 20개입니다.
• vocatim transcript <id>는 녹음 하나의 음성 기록 전체를 출력합니다. ID는 vocatim list와 vocatim search의 첫 번째 열에 있습니다.
• vocatim summary <id>는 그 녹음의 요약을 출력합니다.

어떤 명령어에든 --json을 붙이면 직접 만든 스크립트에서 쓸 수 있는 JSON을 받을 수 있습니다. vocatim help는 명령어 목록을 보여 줍니다.

Vocatim 키. ~/.zshrc의 vocatim 줄에는 Vocatim 키가 들어 있습니다. 이 줄을 터미널에 직접 붙여 넣으면 키가 터미널 기록에도 남습니다. 이 키는 이 Mac의 앱이 Vocatim을 읽을 수 있게 할 뿐이며, 그것도 Vocatim이 열려 있는 동안에만 가능합니다. 이 줄이나 파일은 공유하지 마세요. 이미 공유했다면 Vocatim에서 “키 재설정”을 사용하세요.

“키 재설정” 후나 Vocatim에 “설정이 바뀌었습니다. AI 앱을 다시 설정하세요.”라고 표시되면 이전 줄은 더 이상 작동하지 않습니다. 1~4단계를 다시 하세요. ~/.zshrc에서는 가장 최근의 vocatim 줄이 적용되며, 이전 줄은 삭제해도 됩니다.

명령어를 실행하면 Vocatim 설정의 이 Mac의 AI 앱에 AI 앱 이름처럼 vocatim-cli가 표시됩니다.

명령줄은 이 Mac의 Vocatim과만 통신하며 결과를 터미널 창에 출력합니다. 이 결과를 다른 곳, 예를 들어 온라인 AI 서비스에 넘기면 결과는 그곳으로 갑니다.

제거하려면 ~/.zshrc에서 vocatim 줄을 모두 삭제하세요. 1~4단계를 반복했다면 여러 줄일 수 있습니다. Vocatim에서 스위치를 끄거나 “키 재설정”을 해도 명령줄이 작동하지 않게 됩니다.

작동하지 않는 경우: Vocatim 명령줄의 메시지는 vocatim-mcp:로 시작합니다.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings.(이 Mac에서 Vocatim이 열려 있지 않거나 Vocatim 설정에서 AI 앱의 접근이 꺼져 있습니다): Vocatim을 열고 스위치를 확인하세요. “키 재설정” 후나 “설정이 바뀌었습니다”가 표시된 후에는 1~4단계를 다시 하세요. 그 위에 줄이 있으면 기술적인 원인이 나와 있습니다. 예: vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: 새 터미널 창을 여세요. 그래도 같은 메시지가 나오면 ~/.zshrc에 alias vocatim=으로 시작하는 줄이 있는지 확인하고, 없으면 1~4단계를 다시 하세요. echo $SHELL이 /bin/zsh를 표시하는지도 확인하세요.
• vocatim-mcp 경로와 함께 표시되는 zsh: no such file or directory: 그 줄이 Vocatim이 더 이상 없는 위치를 가리키고 있습니다. 예를 들어 앱을 옮긴 경우입니다. 1~4단계를 다시 하세요.
• vocatim-mcp: Too many requests, try again in a moment.(요청이 너무 많습니다. 잠시 후 다시 시도하세요): 잠시 기다린 후 명령어를 다시 실행하세요.
• 명령어 없이 실행한 vocatim(예: vocatim 또는 vocatim --json)은 아무것도 표시하지 않고 기다립니다: Control-C를 누른 다음 vocatim list 같은 명령어를 입력하세요.

스크립트에서 사용할 때: 데이터는 명령어가 성공했을 때만 전부 표준 출력으로 나가고, 메시지는 표준 오류로 나갑니다. --json을 붙이면 Vocatim의 응답 하나가 JSON 한 줄이므로, 긴 음성 기록에서는 transcript가 페이지마다 한 줄씩 출력합니다. 출력을 하나의 JSON 문서로 읽지 말고 한 줄씩 읽으세요. 종료 코드: 0 완료, 1 기타 오류, 2 잘못된 명령어 또는 옵션, 3 Vocatim이 열려 있지 않거나 접근이 꺼져 있음, 4 요청이 너무 많음.

Mac 밖으로 나가는 것

AI 앱이 녹음에 접근하는 기능은 기본적으로 꺼져 있습니다. 음성 기록을 이 Mac의 AI 앱과 공유하기로 결정한 경우에만 Vocatim 설정에서 직접 켭니다.

Vocatim 자체는 아무것도 보내지 않습니다. AI 앱이 온라인 모델을 사용하는 경우(Claude Desktop, ChatGPT, Codex는 보통 그렇습니다), Vocatim에서 읽은 내용은 당신의 계정으로 해당 회사(Anthropic 또는 OpenAI)에 전송됩니다. 그 내용을 채팅에 직접 붙여 넣은 것과 마찬가지입니다.

중지하려면

Vocatim에서 스위치를 끄세요. 키 재설정을 하면 지금까지 복사한 모든 키와 붙여 넣은 모든 설정을 더 이상 사용할 수 없게 됩니다. 다시 연결하려면 AI 앱을 다시 설정하세요. Claude Desktop 확장 프로그램의 경우 Vocatim에서 Claude Desktop에 설치를 다시 클릭하고 파일을 저장한 다음 여세요. 파일이 저장되면 Vocatim이 새 키를 복사합니다. Claude Desktop이 키를 요청할 때 붙여 넣거나, Claude Desktop에 있는 Vocatim 확장 프로그램의 Vocatim 키 필드에 붙여 넣으세요. Cursor와 LM Studio의 경우 Cursor에 추가 또는 LM Studio에 추가를 다시 클릭하세요. 붙여 넣은 설정의 경우 설정을 다시 복사해 기존 항목이나 섹션 위에 붙여 넣으세요. 그런 다음 AI 앱을 완전히 종료했다가(창을 닫는 것만으로는 충분하지 않습니다) 다시 여세요. 그때까지 AI 앱은 이전 키를 계속 사용합니다. AI 앱에서 Vocatim을 제거할 수도 있습니다. Claude Desktop의 Vocatim 확장 프로그램, Claude Desktop 설정 파일이나 다른 앱의 MCP 설정 또는 Zed 설정 파일에 있는 "vocatim" 항목, 또는 ~/.codex/config.toml의 [mcp_servers.vocatim] 섹션을 제거하면 됩니다.

작동하지 않는 경우

• “이 Mac에서 Vocatim이 열려 있지 않거나 Vocatim 설정에서 AI 앱의 접근이 꺼져 있습니다.”라는 메시지가 나타나면 Vocatim을 열고 스위치를 확인하세요. “키 재설정” 후에는 AI 앱을 다시 설정한 다음 완전히 종료했다가(창을 닫는 것만으로는 충분하지 않습니다) 다시 여세요.
• Vocatim에 “설정이 바뀌었습니다. AI 앱을 다시 설정하세요.”라고 표시되면 위의 방법대로 기존 항목이나 섹션 위에 각 AI 앱을 다시 설정하고 다시 시작하세요.
• Vocatim에 “앱이 열리지 않았습니다. 이 Mac에 설치되어 있나요?”라고 표시되면 해당 앱을 이 Mac에 설치하세요. Cursor와 LM Studio에서는 다른 앱용 설정 복사를 사용할 수도 있습니다.
• 설정을 두 번째로 붙여 넣은 후 ChatGPT 또는 Codex가 작동하지 않거나 config.toml에 오류가 있다고 알리면, 파일에 [mcp_servers.vocatim] 섹션이 두 개 있는 것입니다. 가장 최근 것만 남기세요.
• Codex에 Vocatim 도구가 없다고 나오면 폴더가 이 Mac에 있는 프로젝트에서 새 대화를 시작하세요(다른 컴퓨터에서 동기화된 프로젝트는 이 Mac에 폴더가 없을 수 있습니다).
• Vocatim보다 AI 앱을 먼저 열었다면 Vocatim을 연 상태에서 AI 앱을 다시 시작하세요.
• 녹음이 보이지 않는 경우: 휴지통의 녹음과 샘플 녹음은 표시되지 않으며, 새 녹음은 음성 기록이 끝나거나 중단된 후에야 나타납니다. 음성 기록이 완전히 끝나지 않은 녹음은 목록에 표시되지만, 음성 기록이 끝날 때까지 그 음성 기록과 요약은 사용할 수 없습니다.