Aģentu pieslēgšana MultiVoice MCP

Aģents pats neielogojas: ieraksta URL konfigurācijā; cilvēks veic OAuth pārlūkā.

Maksas darbībām vienmēr vajadzīgs servera piedāvājums un confirmation_handle. Aģentam jāparāda summa cilvēkam pirms execute_create.

MCP URL

Ko var pasūtīt caur MCP

• Klasiskā audiogrāmata order_type_id 1 — Profesionāla audiogrāmata ar daudzbalsu MI ierunāšanu krievu, vācu, angļu, franču vai latviešu valodā. Rezultāts — audio pa nodaļām.
• Subtitri order_type_id 4 — Automātiski subtitri no audio vai video. language_from jābūt no get_create_options languages[]: af am ar as az ba be bg bn bo br bs ca cs cy da de el en es et eu fa fi fo fr gl gu ha he hi hr ht hu hy id is it ja jv ka kk km kn ko la lb ln lo lt lv mg mi mk ml mn mr ms mt my nb ne nl nn no oc pa pl ps pt ro ru sa sd si sk sl sn so sq sr su sv sw ta te tg th tk tl tr tt uk ur uz vi yi yo zh. Citi ISO (sm, zu, …) tiek noraidīti kā invalid_create_payload. Kad atpazīšana gatava (statuss 3/3), lejupielādējiet sešus oriģinālās celiņa failus caur get_artifacts / prepare_download: vienkāršie, pēc runātājiem un pilnie × SRT un VTT (artifact_type_id 115–120).
• Transkripcija order_type_id 5 — Telefona zvanu, lekciju, sapulču un vebināru transkripcija. Tas pats language_from katalogs kā subtitriem: af am ar as az ba be bg bn bo br bs ca cs cy da de el en es et eu fa fi fo fr gl gu ha he hi hr ht hu hy id is it ja jv ka kk km kn ko la lb ln lo lt lv mg mi mk ml mn mr ms mt my nb ne nl nn no oc pa pl ps pt ro ru sa sd si sk sl sn so sq sr su sv sw ta te tg th tk tl tr tt uk ur uz vi yi yo zh.
• Dublāža order_type_id 7 — Dublēts audio vai video. language_from (runa filmā) jābūt vienam no: af am ar as az ba be bg bn bo br bs ca cs cy da de el en es et eu fa fi fo fr gl gu ha he hi hr ht hu hy id is it ja jv ka kk km kn ko la lb ln lo lt lv mg mi mk ml mn mr ms mt my nb ne nl nn no oc pa pl ps pt ro ru sa sd si sk sl sn so sq sr su sv sw ta te tg th tk tl tr tt uk ur uz vi yi yo zh. languages_to tikai de en fr lv ru (vācu, angļu, franču, latviešu, krievu).

Subtitrus un dublāžu var pasūtīt divos režīmos: pilnīgi automātiski bez cilvēka pārbaudes (human_check netiek sūtīts vai "self"; ātrāk un lētāk) vai ar dzimtās valodas runātāja pārbaudi (human_check = avota valoda, human_translation_check = mērķvalodas; dārgāk un ilgāk). Aģentam jājautā cilvēkam, kuru režīmu izvēlēties; cenu rāda piedāvājums.

Lejupielāde — 4. tipa subtitri

Kad runas atpazīšana gatava (statuss 3, apakšstatuss 3), saraksts — orders.get_artifacts, saite — orders.prepare_download (scope artifacts:download). Tikai oriģinālā celiņa; tukšās rindas un SyntOriginal tiek izlaistas. HTTP Range netiek atbalstīts.

• 115 export_srt_simple — SRT vienkāršie
• 116 export_vtt_simple — VTT vienkāršie
• 117 export_srt_speaker — SRT pēc runātājiem
• 118 export_vtt_speaker — VTT pēc runātājiem
• 119 export_srt_full — SRT pilnie (runātājs, dzimums, loma)
• 120 export_vtt_full — VTT pilnie (runātājs, dzimums, loma)

Cilvēka pieprasījumu piemēri

• «Izveido daudzbalsu audiogrāmatu latviešu valodā no manas grāmatas un atsūti nodaļas.»
• «Lejupielādē vienkāršos, pēc runātājiem un pilnos SRT/VTT manam gatavajam subtitru pasūtījumam.»
• «Transkribē vebināra ierakstu no Google Drive.»
• «Transkribē šo vietējo MPEG/audio failu no datora. Vispirms parādi cenu.»
• «Dublē šo video vācu un franču valodā ar dzimtās valodas runātāja pārbaudi. Vispirms parādi cenu.»

Kanoniskie parametri

Cursor

1. Settings → MCP → Add HTTP server.
2. URL: https://db.multivoice.ai/mcp, name: multivoice.
3. Or project .cursor/mcp.json:

{
  "mcpServers": {
    "multivoice": {
      "url": "https://db.multivoice.ai/mcp"
    }
  }
}

Connect → browser OAuth (human login). Do not put API keys or JWTs in JSON. First smoke: multivoice.account.get.

Codex

codex mcp add multivoice --url https://db.multivoice.ai/mcp
codex mcp login multivoice

Noteikumi aģentiem

• Neizmantojiet GET uz /mcp kā transportu (405 ir norma). POST atbilde var būt JSON vai SSE.
• Nestartējiet stdio/npx ietinējus. Nezvaniet LLM/sintēzei MCP vietā.
• Klienta konfigurācijā rakstiet tikai URL. Nekad neievietojiet tokenus, paroles, CLIENT_API_KEY.
• Apstājieties un lūdziet cilvēkam Connect / codex mcp login.
• Pārdodiet tikai pasūtījumu tipus 1, 4, 5 un 7. Tipi 2 un 3 caur MCP ir aizvērti.
• Pasūtījumi: orders.get_create_options → URL: sources.inspect; vietējais fails: sources.prepare_upload (nosaukums + izmērs + ilgums, bez ceļa) → orders.prepare_create → parādiet summu cilvēkam → orders.execute_create ar quote_id, confirmation_handle un jaunu operation_id. Vietējam failam pēc execute augšupielādējiet 10 MiB MD5 gabalus uz /mcp-uploads (uploads:write tiek piešķirts kopā ar orders:create), tad uploads.get_status. Atkārtojums ar to pašu operation_id neveido otru maksājumu.
• 4. tipa subtitrus lejupielādējiet ar orders.get_artifacts, tad orders.prepare_download. Seši oriģinālās celiņa faili: 115 SRT vienkāršie, 116 VTT vienkāršie, 117 SRT pēc runātājiem, 118 VTT pēc runātājiem, 119 SRT pilnie, 120 VTT pilnie. Gatavs atpazīšanas statusā 3/3. Tulkotās celiņas šajā katalogā nav.
• Nezvaniet prepare_action / execute_action (izslēgti).
• Maka papildināšana: billing.prepare_topup ar topup_amount (EUR). Parādiet summu cilvēkam; atgrieziet checkout_url. Maksā cilvēks pārlūkā. Tas nav orders.execute_create un nav tērēšana no maka.
• Valodu ID tikai no get_create_options languages[], mazie burti (ru, ne RU). Kodi kā sm tiek noraidīti.
• Rīku nosaukumi, JSON atslēgas un komandas paliek angļu valodā.

Rīki

Piemēri

// 1) Smoke
multivoice.account.get

// 2) Audiobook (type 1)
multivoice.orders.get_create_options { "order_type_id": 1 }
multivoice.orders.prepare_create { "order_type_id": 1, "book": { ... } }

// 3) Subtitles (type 4), URL source
multivoice.sources.inspect { "source_type_id": ..., "source_url": "https://www.youtube.com/watch?v=..." }
multivoice.orders.prepare_create {
  "order_type_id": 4,
  "source_handle": "...",
  "language_from": "ru",           // must be from get_create_options languages[]
  "human_check": "self"            // or "<language.id>" for native-speaker review
}

// 4) Transcription (type 5), local file — never send a filesystem path
multivoice.sources.prepare_upload {
  "source_type_id": 12,
  "file_name": "meeting.mpeg",
  "file_size_bytes": 12861888,
  "duration_seconds": 1607.7
}
multivoice.orders.prepare_create { "order_type_id": 5, "source_handle": "...", "language_from": "ru" }

// show total to human, then:
multivoice.orders.execute_create {
  "quote_id": "...",
  "confirmation_handle": "...",
  "operation_id": "<new UUID; reuse on retry>"
}
// local file only: POST /mcp-uploads/init|chunk|complete (10 MiB + MD5), poll uploads.get_status

// 5) Download type-4 subtitles when status is 3/3
multivoice.orders.get_artifacts { "order_code": "SO-…" }
multivoice.orders.prepare_download { "order_code": "SO-…", "artifact_type_id": 115 }
// 115 simple SRT · 116 simple VTT · 117 speaker SRT · 118 speaker VTT · 119 full SRT · 120 full VTT

Also see /llms.txt for crawlers and agents.