SpeakPen 연결하기

음성 메모를 Obsidian으로 보내거나 AI 어시스턴트가 읽게 하세요. 아래에서 사용하는 도구를 고르세요.

코딩 에이전트를 쓰시나요? 이 문장을 붙여넣으세요:

Connect to my SpeakPen notes: read https://speakpen.app/connect and set it up.

AI 에이전트용

당신은 사용자가 음성 메모 앱 SpeakPen을 연결하도록 돕고 있습니다. MCP 서버는 https://speakpen.app/mcp 입니다(Streamable HTTP, 읽기 전용, OAuth 로그인). 어떤 클라이언트에서 실행 중인지 파악해 아래 해당 섹션을 따르고, 사용자가 브라우저에서 허용을(를) 클릭해야 할 때 알려 주세요.

이 페이지는 일반 Markdown으로도 제공됩니다: https://speakpen.app/connect.md

접근은 읽기 전용이며 메모만 해당하고 오디오는 포함되지 않습니다. 제한: 분당 도구 호출 60회.

도구: searchfetchlist_recent_notes

Claude Code

  1. 서버를 추가하세요:

    claude mcp add --transport http speakpen https://speakpen.app/mcp
  2. 그런 다음 Claude Code 안에서 /mcp를 실행하고 speakpen을 선택해 로그인하세요. 브라우저가 열립니다: SpeakPen에 로그인하고 허용을(를) 클릭하세요.

    /mcp
  3. 선택 사항: SpeakPen 스킬은 Claude Code가 언제 메모를 찾아봐야 하는지 알려 줍니다. 이 플러그인은 speakpen 서버도 함께 추가하므로, 위 명령 대신 설치할 수 있습니다:

    /plugin marketplace add Qumge/speakpen-skill
    /plugin install speakpen@speakpen

Codex CLI

  1. 서버를 추가하세요:

    codex mcp add speakpen --url https://speakpen.app/mcp
  2. 로그인하세요. 브라우저가 열립니다: SpeakPen에 로그인하고 허용을(를) 클릭하세요.

    codex mcp login speakpen

Cursor

  1. 이것을 ~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 추가하세요:

    {
      "mcpServers": {
        "speakpen": {
          "url": "https://speakpen.app/mcp"
        }
      }
    }
  2. Cursor가 speakpen에 로그인하라고 하면, 브라우저에서 SpeakPen에 로그인하고 허용을(를) 클릭하세요.

VS Code

  1. 이것을 워크스페이스의 .vscode/mcp.json에 추가하고, YOUR_TOKEN 자리에 토큰을 넣으세요:

    {
      "servers": {
        "speakpen": {
          "type": "http",
          "url": "https://speakpen.app/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_TOKEN"
          }
        }
      }
    }
  2. 토큰은 설정 → 연결 → 개발자에서 만드세요.

Gemini CLI

  1. 서버를 추가하세요:

    gemini mcp add --transport http speakpen https://speakpen.app/mcp
  2. 그런 다음 Gemini CLI 안에서 로그인하세요. 브라우저가 열립니다: SpeakPen에 로그인하고 허용을(를) 클릭하세요.

    /mcp auth speakpen

다른 MCP 클라이언트

원격 서버를 지원하는 MCP 클라이언트에서 이 주소로 원격(Streamable HTTP) 서버를 추가하고, 요청 시 로그인하세요:

https://speakpen.app/mcp

클라이언트가 OAuth로 로그인할 수 없다면 설정 → 연결 → 개발자에서 토큰을 만들어 모든 요청에 함께 보내세요:

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT와 Claude는 각 서비스의 설정에서 직접 설정해야 합니다. 에이전트가 대신 열 수 없습니다.

  1. ChatGPT에서 커스텀 MCP 서버를 추가하세요(위치는 ChatGPT 도움말에 나와 있으며, 일부 요금제와 워크스페이스에서는 허용되지 않습니다).

  2. 이 주소를 사용하고 OAuth 로그인을 선택하세요:

    https://speakpen.app/mcp
  3. SpeakPen에 로그인하고 허용을(를) 클릭하세요.

Claude.ai and Claude Desktop

  1. Customize → Connectors를 열고 + Add를 클릭한 다음 Add custom connector를 클릭하세요.

  2. 이름을 SpeakPen으로 정하고 이 주소를 붙여넣은 뒤 Continue를 클릭하세요. 로그인 설정은 그대로 두고 Continue를 한 번 더 클릭한 다음 Add를 클릭하세요:

    https://speakpen.app/mcp
  3. Claude가 로그인하라고 하면 SpeakPen에 로그인하고 허용을(를) 클릭하세요.

Claude Desktop에서도 단계는 같습니다.

Obsidian

  1. Obsidian에서: 설정 → 커뮤니티 플러그인 → 둘러보기 → "SpeakPen Sync" 검색 → 설치 및 활성화.

  2. SpeakPen에서 설정 → 연결을(를) 열고 Obsidian 카드의 "토큰 생성"을 클릭하세요. 토큰을 복사하세요: 한 번만 표시됩니다.

  3. Obsidian에서 SpeakPen Sync 설정을 열고 API token 필드에 토큰을 붙여넣으세요.

메모는 한 방향으로 동기화됩니다: SpeakPen에서 보관함으로.

음성 메모를 Obsidian으로 동기화하는 방법 →

작동 확인

어시스턴트에게 물어보세요:

내가 최근에 뭘 녹음했지?

연결 해제

설정 → 연결을(를) 여세요. 어시스턴트 옆의 "연결 해제"를 클릭하거나 개발자에서 토큰을 폐기하세요. 접근은 즉시 중단됩니다.

개인정보 보호

어시스턴트는 메모를 읽기만 할 수 있습니다. 아무것도 만들거나 바꾸거나 삭제할 수 없고, 오디오는 절대 받지 않습니다. 언제든 연결을 해제할 수 있습니다.