Ke referensi MCP

Dokumentasi MCP

Transkrip Anda di asisten AI.

Hubungkan klienLihat alat
Di halaman ini

Taption MCP

Hubungkan Taption ke klien MCP untuk mentranskripsikan dan menerjemahkan audio dan video, membaca transkrip dan terjemahan yang selesai, serta melihat pekerjaan terbaru langsung dari percakapan.

Model Context Protocol (MCP) memungkinkan asisten menggunakan alat Taption atas nama Anda. Koneksi khusus ini mendukung pembacaan transkrip serta pembuatan tugas transkripsi dan terjemahan baru.

Streamable HTTPOAuth 2.1

URL server

https://api.taption.com/mcp-custom

Gunakan URL lengkap ini saat menambahkan Taption sebagai server MCP jarak jauh.

Transport
Streamable HTTP
Autentikasi
OAuth 2.1

Persyaratan

  • Akun Taption, tanpa kewajiban langganan berbayar. Jika masuk dengan email dan kata sandi, verifikasi email sebelum menghubungkan.
  • Menit tersedia untuk membuat tugas transkripsi dan terjemahan. Batas akun dan paket Anda tetap berlaku.
  • Klien yang mendukung Streamable HTTP jarak jauh dan OAuth. Paket klien dan kebijakan organisasi dapat membatasi akses.

Sumber media yang didukung

Gunakan URL langsung audio atau video, file Google Drive publik, atau video YouTube. Server khusus juga menerima postingan publik Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili (bilibili.tv), serta video dan klip Twitch.

ChatGPT juga dapat menyediakan file audio atau video yang diunggah jika integrasi filenya tersedia. Klien lain dapat menggunakan URL media yang bisa diunduh.

Tautan harus dapat diakses Taption. Siaran langsung tidak didukung; gunakan rekaman yang sudah selesai.

Konfigurasi klien

Pilih aplikasi Anda untuk melihat panduan penyiapan langkah demi langkah.

Autentikasi

Taption memakai OAuth 2.1 dengan PKCE. Masuk dan setujui koneksi. Klien mengelola otorisasi dan memperbarui token akses yang berlaku satu jam secara otomatis.

MCP menggunakan token OAuth. Kunci REST API Taption tidak dapat mengautentikasi koneksi ini.

Gunakan /mcp-custom selama konfigurasi. Token untuk /mcp tidak dapat digunakan di /mcp-custom.

Untuk mencabut akses, buka Akun → Aplikasi terhubung di Taption dan putuskan klien. Hubungkan dan izinkan kembali untuk memulihkan akses.

Izin koneksi

transcripts:read
Membaca status dan isi transkrip serta menampilkan transkrip terbaru.
transcripts:write
Membuat tugas transkripsi dan terjemahan dengan menit akun Anda.

Alur kerja yang didukung

Berikan media dan hasil yang diinginkan. Asisten menggunakan alat Taption untuk menjalankan langkah berikut.

  1. Pilih media dan hasil

    Berikan tautan atau unggahan yang didukung, bahasa ucapan, dan tujuan: teks biasa, label pembicara, atau takarir. Asisten menanyakan pilihan yang belum ada sebelum memulai.

  2. Transkripsikan dan pantau

    transcribe langsung mengembalikan ID. get_transcript menunggu sebentar untuk tugas yang hampir selesai; jika masih diproses, tanyakan lagi sekitar satu menit kemudian. Jika notifikasi email aktif di Taption, Anda juga menerima email saat selesai.

  3. Baca, rangkum, dan ekspor

    Baca teks yang selesai atau minta asisten merangkumnya. Gunakan tautan SRT dan editor jika tersedia. Editor Taption menyediakan format ekspor lain.

Contoh permintaan ke asisten

Transkripsikan rekaman berbahasa Inggris ini dengan label untuk dua pembicara: [your media URL].
Buat takarir untuk video berbahasa Jepang ini: [your media URL]. Gunakan 16 karakter per baris.
Transkripsikan wawancara berbahasa Inggris ini sebagai takarir, lalu terjemahkan ke bahasa Jepang dan Spanyol: [your media URL].
Terjemahkan transkrip “Weekly sync” saya ke bahasa Mandarin Tradisional.
Cari transkrip Taption terbaru saya dan rangkum wawancara yang selesai. Sertakan tautan unduhan takarir dan editor jika tersedia.

Ganti [your media URL] dengan tautan Anda. Asisten membuat rangkuman dari transkrip. Pengaturan panjang takarir bergantung pada paket Taption.

transcribe

Membuat tugastranscripts:write

Memulai transkripsi latar belakang dengan media_url atau file. Bahasa dan tujuan harus dipilih pengguna. Jika belum ada, alat akan bertanya tanpa memulai tugas. Tambahkan translate_to untuk menerjemahkan transkrip secara otomatis setelah selesai.

Parameter

media_urlstringSatu sumber media

Tautan media yang didukung, maksimal 2.048 karakter. Gunakan ini atau file.

fileobjectSatu sumber media

Unggahan dari klien berisi download_url dan file_id. mime_type dan file_name opsional. URL harus bisa diunduh Taption.

languagestringDiperlukan saat mulai

Tag bahasa ucapan, misalnya en-US, zh-TW, ja-JP, atau es-ES. Tanyakan pengguna; jangan menebak dari nama file atau bahasa chat.

Lihat tag bahasa
purposestringDiperlukan saat mulai

transcript: teks dengan tanda baca; speakers: label pembicara; captions: segmen takarir pendek. Permintaan transkripsi saja belum memilih tujuan.

transcriptspeakerscaptions
speaker_countinteger

Perkiraan pembicara untuk speakers: 2–10. Default: 2.

max_charactersinteger

1–200 karakter per baris untuk captions pada paket berbayar yang memenuhi syarat. Default: 16 untuk zh/ja/ko/yue, selain itu 65.

translate_tostring[]

Opsional. 1–5 bahasa tujuan terjemahan setelah transkripsi selesai, seperti en, ja, atau zh-TW. Tiap bahasa memakai tambahan menit sepanjang durasi media.

extensionstring

Ekstensi unggahan jika tidak dapat dideteksi. Tidak diperlukan untuk tautan. Audio dan format video yang didukung diterima; 3gp tidak didukung.

namestring

Nama transkrip, maksimal 200 karakter. Jika diabaikan, memakai nama file sumber.

Contoh argumen alat

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

Nilai contoh: ganti URL atau ID transkrip dengan milik Anda.

Mengembalikan ID dan status. Setiap pembuatan yang berhasil memulai tugas baru dan memakai menit, ditambah menit sepanjang durasi media untuk setiap bahasa translate_to. Gunakan ID yang sama untuk memeriksa progres, bukan mengirim ulang.

get_transcript

Hanya bacatranscripts:read

Memeriksa progres atau membaca hasil sebagai teks bertanda waktu, SRT, atau VTT. Berikan language untuk membaca terjemahan. Halaman pertama menyertakan download_url dan editing_url jika tersedia, serta terjemahan transkrip beserta statusnya.

Parameter

idstringWajib

ID dari transcribe atau list_transcripts: 1–128 huruf, angka, garis bawah, atau tanda hubung.

languagestring

Terjemahan yang dibaca, berdasarkan kode bahasanya, seperti ja. Kosongkan untuk membaca transkrip asli.

formatstring

Format keluaran. Default: text.

textsrtvtt
offsetinteger

Posisi frasa mulai dari 0. Default: 0. Gunakan next_offset untuk melanjutkan.

limitinteger

1–500 frasa per halaman. Default: 200.

Contoh argumen alat

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

Nilai contoh: ganti URL atau ID transkrip dengan milik Anda.

Kirim next_offset sebagai offset untuk halaman berikutnya. Maksimal 30.000 karakter per halaman; MCP hanya membaca 2.000 frasa pertama. Transkrip lengkap ada di Taption. Tanpa ucapan, hasilnya total_phrases: 0.

translate_transcript

Membuat tugastranscripts:write

Menerjemahkan transkrip yang sudah selesai ke hingga lima bahasa. Jika Anda menyebut transkrip berdasarkan nama, asisten mencarinya dengan list_transcripts dan meminta Anda memilih bila tidak ada kecocokan yang jelas. Bahasa tujuan harus berasal dari pengguna.

Parameter

idstringWajib

ID dari transcribe atau list_transcripts: 1–128 huruf, angka, garis bawah, atau tanda hubung.

target_languagesstring[]Wajib

1–5 kode bahasa terjemahan, seperti en, ja, es, atau zh-TW. Transkrip tidak dapat diterjemahkan ke bahasanya sendiri.

overwriteboolean

true mengganti terjemahan yang ada, termasuk suntingan di Taption. Hanya setelah pengguna setuju.

Contoh argumen alat

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

Nilai contoh: ganti URL atau ID transkrip dengan milik Anda.

Mengembalikan bahasa yang masuk antrean dan menit yang dipakai tiap bahasa, sama dengan durasi media. Terjemahan yang ada mungkin berisi suntingan Anda dan hanya diganti dengan overwrite setelah Anda setuju. Baca hasilnya dengan get_transcript dan language.

list_transcripts

Hanya bacatranscripts:read

Menampilkan transkrip menurut perubahan terbaru, dengan ID, nama, status, bahasa, terjemahan, dan waktu perubahan. Berikan query untuk mencari transkrip berdasarkan nama. Gunakan ID dengan get_transcript untuk membaca isinya.

Parameter

limitinteger

1–50 transkrip. Default: 10.

querystring

Bagian nama transkrip yang dicari di antara 100 transkrip terbaru Anda, tanpa membedakan huruf besar-kecil.

Contoh argumen alat

{
  "query": "weekly sync",
  "limit": 10
}

Nilai contoh: ganti URL atau ID transkrip dengan milik Anda.

Mengembalikan array transcripts kosong jika tidak ada rekaman. Hanya jumlah hasil yang dibatasi; tidak ada paginasi.

Pemecahan masalah

Kesalahan koneksi atau izin

Hubungkan ulang dengan OAuth dan berikan izin yang diminta. Pastikan URL berakhir dengan /mcp-custom.

Media tidak dapat diunduh

Pastikan file atau postingan publik, didukung, dan bukan siaran langsung. Aktifkan akses tautan di Google Drive.

Menit tidak cukup atau tugas terlalu banyak

Periksa menit Taption Anda. Jika mencapai batas frekuensi atau tugas bersamaan, tunggu tugas selesai dan coba lagi setelah jeda yang ditentukan.

Masih diproses atau transkripsi gagal

Saat diproses, periksa ID yang sama sekitar setiap menit. Jika status error, baca pesan dan perbaiki penyebabnya sebelum membuat tugas baru.

Format ekspor lainnya

Buka transkrip di Taption untuk mengekspor TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON, atau video dengan takarir tertanam. Tidak ada alat ekspor MCP terpisah.

Baca dokumentasi REST API