Server MCP Transcript Dock

Server MCP memberi agen AI API yang sama dengan kunci Anda: agen bisa mencari video, mentranskripsikannya, dan membaca hasilnya di tengah percakapan. Penggunaannya memotong kredit Anda. Tidak ada yang perlu dipasang: arahkan klien ke server jarak jauh, https://www.transcriptdock.com/mcp.

Hubungkan#

Claude (claude.ai, Desktop, seluler)#

• Buka Customize, Connectors lalu pilih Add custom connector.
• Beri nama Transcript Dock dan tempel https://www.transcriptdock.com/mcp sebagai URL server. Biarkan pengaturan lanjutan kosong.
• Pilih Add, lalu Connect. Masuk ke Transcript Dock dan pilih Allow access.

Tidak ada kunci API yang terlibat: konektor masuk dengan akun Anda dan bisa membaca serta mengirim tugas dan membaca transkrip, tetapi tidak pernah kunci, penagihan, atau pengaturan akun. Di paket Team dan Enterprise, Owner menambahkannya sekali di Organization settings, Connectors, lalu setiap anggota menghubungkannya.

Claude Code#

Tambahkan server, lalu jalankan /mcp di Claude Code dan pilih Authenticate untuk masuk.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

Untuk CI dan skrip, kirim kunci API alih-alih masuk:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor dan klien lain#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

Windsurf memakai serverUrl alih-alih url, dan VS Code mencantumkan server di bawah servers dengan "type": "http". Halaman klien di bawah memuat file yang tepat.

• Claude CodeSatu perintah terminal.
• Aplikasi Claudeclaude.ai, Desktop, dan seluler: tambahkan konektor kustom.
• CursorTambahkan ke mcp.json.
• WindsurfTambahkan ke mcp_config.json.
• OpenClawAgen otonom lewat stdio.

Server lokal#

Untuk klien yang hanya stdio, seperti OpenClaw, jalankan server yang sama secara lokal dengan Node.js 22.15 atau yang lebih baru. Kedua variabel wajib diisi.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

Tool#

get_video_transcript#

Tool yang harus dipakai agen saat diminta menjelaskan isi sebuah video.

urlstringWajib

URL video YouTube atau TikTok.

mode"captions_only" | "auto" | "transcribe"Opsional

Default captions_only (1 kredit). auto beralih ke transkripsi AI jika video tidak punya subtitle; transcribe selalu memakainya (2 kredit per menit yang dimulai, paket berbayar).

format"text" | "srt" | "vtt" | "segments"Opsional

text (default) paling ringkas untuk agen; segments mengembalikan JSON dengan waktu.

timeout_secondsintegerOpsional

Default 120. Saat timeout, status dan ID tugas dikembalikan.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

This is the first caption
This is the second caption
…

Video yang sama dengan mode yang sama dijawab dari hasil yang tersimpan di ruang kerja Anda, gratis.

transcribe, wait_for_job, get_transcript#

Versi tiga langkah untuk agen yang ingin mengontrol prosesnya: transcribe menerima url, mode, language (opsional), dan max_credits (opsional), serta idempotency_key (string yang stabil dengan panjang 8 sampai 128 karakter, agar panggilan yang diulang tidak pernah mengirim dua kali), lalu mengembalikan tugas. wait_for_job menerima job_id dan timeout_seconds (opsional). get_transcript menerima result_id tugas sebagai transcript_id dan sebuah format.

Mencari video#

Tool pencarian dan daftar mengembalikan video dengan url, judul, durasi, dan jumlah tayangan, siap diberikan ke get_video_transcript. channel menerima @handle, ID channel, atau URL channel; playlist menerima ID atau URL; user menerima @user TikTok atau URL profil. Tool YouTube dibagi per halaman dengan limit (default 20) dan cursor. TikTok mengembalikan paling banyak 10 video dan tidak ada halaman berikutnya; include_details menambahkan suka, komentar, hashtag, dan bahasa subtitle per video.

Kesalahan#

Panggilan yang gagal mengembalikan isError: true dengan kode error API, pesan, dan ID permintaan, sehingga agen bisa menjelaskannya atau mengubah langkah. Kodenya sama dengan yang ada di Referensi API.

Pemecahan masalah#

• Unauthorized: di Claude, hapus konektor lalu tambahkan lagi untuk masuk dari awal. Dengan kunci, kunci dimasukkan di konfigurasi server (header atau env), bukan di shell Anda; pastikan kunci belum dicabut.
• Tidak dapat terhubung ke server MCP: gunakan URL persis https://www.transcriptdock.com/mcp, termasuk www.
• Tool tidak ditemukan: mulai ulang klien setelah mengubah konfigurasinya.
• Server lokal tidak bisa mulai: pasang Node.js 22.15 atau yang lebih baru, lalu atur TRANSCRIPTDOCK_API_KEY dan TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS: video tidak punya subtitle. Di paket berbayar, minta mode: "auto".