개발자를 위한 ScribeToAny

ScribeToAny는 원격 MCP 서버를 제공합니다. ChatGPT, Claude, Cursor 또는 기타 MCP 클라이언트에 연결하면, AI 앱이 로그인된 사용자 계정으로 전사 목록을 조회하고 텍스트나 자막으로 읽으며 링크를 통해 새로운 전사를 시작할 수 있습니다.

서버 URL

https://scribetoany.com/api/mcp

Streamable HTTP 전송, JSON 응답 방식의 상태 비저장(stateless) JSON-RPC를 사용합니다(SSE 스트림 및 session id 없음). API key는 필요하지 않으며, 클라이언트가 처음 연결할 때 OAuth를 통해 로그인합니다.

연결

ChatGPT

ScribeToAny는 ChatGPT 플러그인 디렉터리에 등록되어 있습니다: ChatGPT에 추가. 자세한 내용은 ChatGPT 페이지에서 확인하세요.

Claude

커스텀 커넥터로 추가(또는 Settings → Connectors → Add custom connector로 이동하여 서버 URL 붙여넣기). 자세한 내용은 Claude 페이지에서 확인하세요.

Claude Code

다음 명령어를 실행한 후 /mcp 명령어로 로그인하세요:

claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp

Cursor

원클릭으로 Cursor에 추가하거나 ~/.cursor/mcp.json에 다음 설정을 추가하세요:

{
  "mcpServers": {
    "scribetoany": {
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

Codex CLI

codex mcp add scribetoany --url https://scribetoany.com/api/mcp
codex mcp login scribetoany

Gemini CLI

다음 명령어를 실행한 후 /mcp auth scribetoany 명령어로 로그인하세요:

gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp

VS Code

.vscode/mcp.json 파일에 추가:

{
  "servers": {
    "scribetoany": {
      "type": "http",
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

앱에서 ScribeToAny가 열리면 로그인하고 '액세스 허용'을 선택하세요. 연결을 해제하려면 AI 앱 설정에서 ScribeToAny를 제거하세요. AI 앱 없이 서버를 사용해 보려면 npx @modelcontextprotocol/inspector를 실행하고 Streamable HTTP를 선택한 후 위 URL을 사용하세요.

에이전트가 직접 설정하도록 하기

코딩 에이전트(Claude Code, Codex, Gemini CLI, Cursor)를 사용 중이신가요? 다음 프롬프트를 붙여넣으면 에이전트가 알아서 서버를 추가해 줍니다.

여기에서 오디오와 비디오를 전사하고 전사본을 읽을 수 있도록 ScribeToAny를 설정해 줘.

1. "scribetoany"라는 이름으로 원격 MCP 서버 https://scribetoany.com/api/mcp(Streamable HTTP, OAuth, API key 필요 없음)을 추가해 줘. Claude Code의 `claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp`, Codex의 `codex mcp add scribetoany --url https://scribetoany.com/api/mcp`, Gemini CLI의 `gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp`처럼 해당 도구에 맞는 명령어를 사용해.
2. 로그인을 시작해 줘. 브라우저에서 ScribeToAny가 열리면 로그인하고 '액세스 허용'을 선택할게.
3. 연결되면 제대로 작동하는지 확인하기 위해 내 최근 전사본 목록을 불러와 줘.

컴퓨터의 파일 전사하기 (CLI)

ChatGPT 이외의 MCP 클라이언트는 컴퓨터의 파일을 전달할 수 없습니다. ScribeToAny 커맨드라인 도구는 가능합니다. 파일을 계정에 업로드하고 전사가 완료될 때까지 기다린 후 텍스트, SRT 또는 VTT로 저장합니다. 코딩 에이전트(Claude Code, Codex, Gemini CLI, Cursor)는 다른 명령어와 마찬가지로 이를 실행합니다. Node.js 20 이상이 필요합니다.

npm i -g scribetoany
scribetoany auth login
scribetoany transcribe meeting.m4a --format srt --speakers

에이전트가 명령어와 옵션을 인식할 수 있도록 agent skill을 추가하세요:

npx skills add scribetoany/skills --skill scribetoany

scribetoany auth login을 실행하면 브라우저에서 ScribeToAny가 열리며, 여기서 로그인하고 AI 앱과 동일하게 "ScribeToAny CLI"를 허용합니다. 결과는 stdout으로, 진행 상황은 stderr로 출력되며 기계 판독 가능한 출력을 원하면 --json을 추가하세요. 모든 옵션을 확인하려면 scribetoany --help를 실행하세요.

도구

도구	권한	기능
list_transcripts	읽기 전용	상태, 언어, 재생 시간과 함께 최신순으로 전사본 목록을 표시합니다. 선택적으로 검색어를 지정할 수 있습니다.
get_transcription_status	읽기 전용	전사 작업이 대기 중인지, 진행 중인지, 완료되었는지, 실패했는지 확인합니다.
get_transcript	읽기 전용	완료된 전사본을 텍스트(선택적 타임스탬프 및 화자 라벨 포함), SRT 또는 VTT로 읽습니다.
transcribe_link	쓰기	공개 링크(X, Twitch, Loom, Google Drive, Dropbox 또는 직접 연결되는 오디오/비디오 URL)를 전사합니다. YouTube, TikTok, Instagram 링크는 지원되지 않습니다.
transcribe_file	쓰기	ChatGPT 전용: 대화에 첨부된 오디오 또는 비디오 파일을 전사합니다.
get_upload_link	읽기 전용	파일을 전달할 수 없는 앱의 경우: 브라우저에서 ScribeToAny를 열어 로컬 파일을 업로드할 수 있는 링크를 가져옵니다.
get_usage	읽기 전용	현재 플랜과 남아 있는 전사 사용량을 표시합니다.

모든 결과에는 ScribeToAny 대시보드의 해당 전사본으로 연결되는 링크가 포함됩니다. 앱은 어떤 내용도 수정하거나 삭제할 수 없으며 결제 정보를 절대 볼 수 없습니다.

인증

클라이언트가 직접 등록할 수 있도록 PKCE(S256 전용) 및 dynamic client registration을 지원하는 OAuth 2.1 authorization code flow를 사용합니다. access token은 1시간, refresh token은 30일 동안 유효합니다.
인증되지 않은 요청은 보호된 리소스 메타데이터를 가리키는 WWW-Authenticate 헤더와 함께 401 응답을 받으며, 클라이언트는 이를 통해 authorization server를 찾습니다:

https://scribetoany.com/.well-known/oauth-protected-resource/api/mcp
https://scribetoany.com/.well-known/oauth-authorization-server

ScribeToAny 동의 화면에서 클라이언트를 승인한 후에만 액세스 권한이 부여되며, 인증된 계정만 연결할 수 있습니다.

제한 사항

AI 앱에서 시작된 전사도 다른 전사와 마찬가지로 플랜 사용량에 반영됩니다. 무료 플랜은 하루 2회의 전사와 월 100분을 제공하며, 유료 플랜에서는 두 한도 모두 늘어납니다.
get_transcript에서는 최대 120,000자까지 반환되며, 더 긴 전사본은 잘리고 전체 내용을 볼 수 있는 링크가 함께 제공됩니다.
JSON-RPC 배치 하나에 최대 10개의 메시지를 포함할 수 있습니다.
YouTube, TikTok 및 Instagram 링크는 지원되지 않습니다. 파일을 다운로드한 후 ScribeToAny에 업로드해 주세요.