SpeechdashHelp Center

MCP 서버

Cursor, Claude Desktop, ChatGPT 또는 다른 MCP 클라이언트를 Speechdash 공용 API에 연결합니다.

Speechdash는 공식 Model Context Protocol (MCP) 서버를 제공합니다. 이 서버는 라이브러리와 음성 합성을 도구로 노출합니다. AI 어시스턴트가 문서 목록(완료된 전사본 포함), 텍스트 임포트, 번역 또는 내보내기, 지갑 확인, 또는 HTTP 호출을 직접 작성하지 않고 음성 합성을 수행하려면 이 서버를 사용합니다. 라이브러리에는 완료된 전사본(source=transcription)이 포함되어 있습니다. 전사본 도구는 없습니다: 이러한 작업을 문서 도구로 읽습니다. MCP는 음성 전사 작업을 시작하지 않습니다.

공용 REST API를 직접 curl 또는 자체 클라이언트로 호출할 수도 있습니다. MCP와 HTTP는 공통된 엔드포인트, 크레딧, 그리고 둘 다 존재하는 인터페이스의 레이트 제한을 공유합니다.

입력 (이 페이지): Speechdash의 공식 MCP인 mcp.speechdash.com은 외부 어시스턴트가 당신의 Speechdash 라이브러리를 호출할 수 있게 합니다.

출력 (앱 설정): 설정 → 커넥터는 제3자 MCP 서버를 앱 내 채팅 UI에 연결합니다. 이 기능이 활성화된 경우입니다. 이는 Speechdash의 공용 MCP 서버가 아닙니다.

공용 mcp.speechdash.com 배포판에 SPEECHDASH_API_KEY를 절대 설정하지 마세요. 각 클라이언트는 OAuth 또는 개인 sh_live_… 키를 Authorization 헤더에 인증해야 합니다.

시작하기 전에

Cursor, Claude Desktop 및 기타 베어러 키를 지원하는 클라이언트용 API 키를 앱의 설정 → API에서 생성합니다. MCP는 HTTP와 같은 sh_live_… 키를 사용합니다. API 개요를 참조하세요.

ChatGPT (OAuth)

ChatGPT는 OAuth 2.1 + PKCE를 요구하며, 복사된 API 키를 입력하지 마세요. ChatGPT 커넥터 UI에 API 키를 입력하지 마세요.

  1. MCP URL: https://mcp.speechdash.com/mcp
  2. OAuth 리소스: https://mcp.speechdash.com
  3. 보호된 리소스 메타데이터: https://mcp.speechdash.com/.well-known/oauth-protected-resource
  4. 인증 서버 (디스커버리): https://speechdash.com/.well-known/oauth-authorization-server

ChatGPT이 로그인 요청을 할 때 Speechdash 계정으로 로그인하세요. 토큰은 앱에서 발행되고 MCP 서버 및 공용 API에서 인증됩니다.

설정 가이드: Agents hub.

도구

각 MCP 도구는 하나의 REST 엔드포인트에 매핑됩니다:

MCP 도구REST
speechdash_get_accountGET /v1/me
speechdash_list_documentsGET /v1/documents
speechdash_get_documentGET /v1/documents/{document_id}
speechdash_create_documentPOST /v1/documents
speechdash_update_documentPUT /v1/documents/{document_id}
speechdash_translate_documentPOST /v1/documents/{document_id}/translate
speechdash_export_documentGET /v1/documents/{document_id}/export
speechdash_delete_documentDELETE /v1/documents/{document_id}
speechdash_list_voicesGET /v1/voices
speechdash_get_voiceGET /v1/voices/{voice_id}
speechdash_synthesize_speechPOST /v1/audio/speech

서버는 또한 리소스 speechdash://openapi (실시간 OpenAPI JSON)를 노출합니다.

MCP vs REST 기능

기능MCPREST
계정 스냅샷예 (speechdash_get_account)GET /v1/me
문서 CRUD (라이브러리, 완료된 전사본 포함)예예
음성 전사 작업 시작아니오 (앱 전용)아니오 (앱 전용)
비스트리밍 음성 (5k 문자)예POST /v1/audio/speech
스트리밍 음성 (20k 문자)아니오, REST 사용POST /v1/audio/stream
타임스탬프 포함 스트리밍아니오, REST 사용POST /v1/audio/stream/with-timestamps
번역예 (speechdash_translate_document)POST /v1/documents/{document_id}/translate
파일 내보내기예 (speechdash_export_document)GET /v1/documents/{document_id}/export
아카이브 / 복원예 (is_archived on speechdash_update_document)PUT /v1/documents/{document_id}
헬스 체크아니오GET /health
OpenAPI JSON리소스 speechdash://openapiGET /v1/openapi.json

청구

MCP 음성 합성은 REST 및 앱 내 클라우드 재생과 같은 크레딧 지갑을 차감합니다. MCP를 통해 문서를 생성하는 것은 크레딧을 소모하지 않지만, 앱과 REST API와 같은 일일 문서 한도를 포함합니다. 합성 전에 speechdash_get_account를 호출하여 잔액을 확인하세요.

speechdash_translate_document는 MP3 내보내기와 같은 크레딧 지갑을 사용합니다 (30초의 추정 음성당 0.5 크레딧). speechdash_export_document는 큰 파일 바이트를 반환할 수 있습니다: MCP에서 txt, csv, 또는 srt를 선호하세요. pdf와 docx는 이진 파일입니다. speechdash_update_document는 비공개 공유 페이지의 visibility와 문서 아카이브 또는 복원용 is_archived를 허용합니다.

Cursor 또는 Claude Desktop

호스팅된 MCP 서버에 스트리밍 HTTP를 사용하고 개인 API 키를 사용하세요. 예제 .cursor/mcp.json:

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_your_key_here"
      }
    }
  }
}

키를 앱의 설정 → API에서 생성하세요.

로컬 개발 (리포지토리 클론)

Speechdash 리포지토리 클론에서 작업 중이라면:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

선택사항: SPEECHDASH_API_BASE=http://localhost:3003/v1을 사용하여 로컬 API에 연결하세요. bun dev:api가 실행 중일 때.

Streamable HTTP (로컬)

로컬 개발 중인 HTTP MCP 클라이언트용:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

기본 엔드포인트: http://127.0.0.1:3010/mcp

변수목적
SPEECHDASH_API_KEYstdio에 필수; 클라이언트가 Authorization: Bearer를 보내는 로컬 HTTP 서버에서는 선택사항
SPEECHDASH_API_BASEAPI 기본 URL (기본값 https://api.speechdash.com/v1)
MCP_TRANSPORTstdio (기본값) 또는 http
MCP_HOSTHTTP 바인드 호스트 (기본값 127.0.0.1)
MCP_PORTHTTP 포트 (기본값 3010)

AI 크롤러용 문서

기계가 읽을 수 있는 제품 컨텍스트:

Agents hub (웹사이트)

agents.md

OpenAPI JSON

GitHub 예제

관련 정보

API 개요

API 키 및 MCP (사용자 가이드)

크레딧 지갑

커넥터 (앱 설정)

API 개요

자신의 애플리케이션에서 Speechdash를 호출하고, 이를 권한 부여하는 API 키를 생성합니다.

Account

Authenticated account and wallet.

On this page

시작하기 전에ChatGPT (OAuth)도구MCP vs REST 기능청구Cursor 또는 Claude Desktop로컬 개발 (리포지토리 클론)Streamable HTTP (로컬)AI 크롤러용 문서관련 정보