narrador

MCP 및 REST API

AI 에이전트용 텍스트 음성 변환 MCP 서버 및 API

AI 에이전트에 호스팅 텍스트 음성 변환 API와 MCP 서버를 제공하세요. OAuth 또는 API 키로 https://api.narrador.io/mcp에 연결하거나 https://api.narrador.io/docs의 REST 참조를 사용하세요.

  • narrador files로 문서 처리

    create_files_job 또는 POST /v1/files/generate. voiceId를 생략하면 문서 언어별 자동 목소리.

  • narrador X로 X 게시물

    generate_x_audio는 오디오만 반환해요. 동영상 내보내기는 앱에서만 가능해요.

  • 같은 크레딧, MCP 또는 REST

    Cursor, Claude Desktop, VS Code에서 OAuth로 연결하거나 nrd_files_ 또는 nrd_x_ 키를 사용하세요.

API 문서 열기

Cursor, Claude Desktop, VS Code

원격 MCP 설정 — API 문서와 같은 샘플. 원격 MCP OAuth를 지원하는 클라이언트(Cursor, Claude Desktop, VS Code 포함)는 URL만 있으면 됩니다. API 키 대안: narrador files 도구는 nrd_files_, narrador X는 nrd_x_.

프로젝트의 .cursor/mcp.json 또는 모든 프로젝트용 ~/.cursor/mcp.json에 추가하세요.

OAuth

클라이언트가 원격 MCP OAuth를 지원할 때 추천. URL만 — 그다음 로그인. 범위: narrador:files, narrador:x.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}

API 키

클라이언트와 스크립트용 대안이에요. 같은 URL에 Authorization Bearer 또는 x-api-key를 붙이세요.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": {
        "Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
      }
    }
  }
}

제한

요청 제한
API 키당 60초에 60회 요청이에요. 초과하면 HTTP 429를 반환해요.
파일 크기
narrador files 경로에서 파일 업로드·URL 다운로드당 최대 50MB예요.
일반 텍스트
POST /v1/files/generate 및 POST /v1/files/jobs 텍스트 필드 최대 500,000자.

자주 묻는 질문

MCP 서버란?
AI 클라이언트가 호출하는 원격 도구 호스트예요. narrador 텍스트 음성 변환 MCP 서버는 https://api.narrador.io/mcp의 io.narrador/narrador예요.
Claude Desktop, Cursor, VS Code에 어떻게 추가하나요?
클라이언트가 원격 MCP OAuth를 지원하면 https://api.narrador.io/mcp을 추가하고 로그인하세요. 그렇지 않으면 nrd_files_ 또는 nrd_x_ 키로 Authorization Bearer를 사용하세요. 샘플은 https://api.narrador.io/docs에 있어요.
API 비용이 따로 드나요?
아니요. API는 앱과 같은 크레딧·같은 가격을 써요.