Transcript MCP সার্ভার

MCP সার্ভার একটি AI এজেন্টকে আপনার API কীয়ের মতোই একই API দেয়: সে ভিডিও খুঁজতে পারে, ট্রান্সক্রাইব করতে পারে এবং কথোপকথনের মাঝেই ফলাফল পড়তে পারে। এটি আপনার ক্রেডিট ব্যবহার করে। ইনস্টল করার কিছু নেই: ক্লায়েন্টকে রিমোট সার্ভারের দিকে নির্দেশ করুন, https://www.transcriptdock.com/mcp।

সংযুক্ত করুন#

Claude (claude.ai, ডেস্কটপ, মোবাইল)#

• Customize, Connectors খুলুন এবং Add custom connector বেছে নিন।
• নাম দিন Transcript Dock, আর সার্ভার URL হিসেবে https://www.transcriptdock.com/mcp বসান। উন্নত সেটিংস খালি রাখুন।
• Add বেছে নিন, তারপর Connect। Transcript Dock এ সাইন ইন করুন এবং Allow access বেছে নিন।

কোনো API কী লাগে না: কানেক্টর আপনার অ্যাকাউন্ট দিয়ে সাইন ইন করে এবং কাজ জমা ও ট্রান্সক্রিপ্ট পড়তে পারে, কিন্তু কী, বিলিং বা অ্যাকাউন্ট সেটিংস কখনো দেখতে বা বদলাতে পারে না। Team ও Enterprise প্ল্যানে একজন Owner এটি একবার Organization settings, Connectors এর অধীনে যোগ করেন, এবং প্রতিটি সদস্য নিজে সংযুক্ত হন।

Claude Code#

সার্ভার যোগ করুন, তারপর Claude Code এ /mcp চালিয়ে সাইন ইন করতে Authenticate বেছে নিন।

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

CI ও স্ক্রিপ্টের জন্য সাইন ইন না করে একটি API কী পাঠান:

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

Cursor ও অন্যান্য ক্লায়েন্ট#

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

Windsurf এ url এর বদলে serverUrl লাগে, আর VS Code সার্ভারগুলো servers এর অধীনে "type": "http" সহ তালিকাভুক্ত করে। নিচের ক্লায়েন্ট পাতাগুলোতে সঠিক ফাইলগুলো আছে।

• Claude Codeটার্মিনালে একটিমাত্র কমান্ড।
• Claude অ্যাপclaude.ai, ডেস্কটপ ও মোবাইল: একটি কাস্টম কানেক্টর যোগ করুন।
• Cursormcp.json এ যোগ করুন।
• Windsurfmcp_config.json এ যোগ করুন।
• OpenClawstdio দিয়ে স্বয়ংক্রিয় এজেন্ট।

লোকাল সার্ভার#

OpenClaw এর মতো শুধু stdio সমর্থন করা ক্লায়েন্টের জন্য একই সার্ভারটি নিজের মেশিনে চালান, Node.js 22.15 বা তার নতুন সংস্করণে। দুটি ভেরিয়েবলই আবশ্যক।

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

টুল#

get_video_transcript#

কোনো ভিডিওতে কী বলা আছে জিজ্ঞেস করা হলে এজেন্ট প্রথমে এই টুলটিই ব্যবহার করবে।

urlstringআবশ্যক

YouTube বা TikTok ভিডিওর URL।

mode"captions_only" | "auto" | "transcribe"ঐচ্ছিক

ডিফল্ট captions_only (1 ক্রেডিট)। ভিডিওতে ক্যাপশন না থাকলে auto AI ট্রান্সক্রিপশনে ফিরে যায়; transcribe সবসময় এটি ব্যবহার করে (শুরু হওয়া প্রতি মিনিটে 2 ক্রেডিট, পেইড প্ল্যানে)।

format"text" | "srt" | "vtt" | "segments"ঐচ্ছিক

text (ডিফল্ট) এজেন্টের জন্য সবচেয়ে ছোট; segments সময়সহ JSON ফেরত দেয়।

timeout_secondsintegerঐচ্ছিক

ডিফল্ট 120। টাইমআউট হলে বদলে কাজের অবস্থা ও আইডি ফেরত আসে।

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

Never gonna give you up
Never gonna let you down
…

একই ভিডিও একই mode দিয়ে চাইলে আপনার ওয়ার্কস্পেসে সংরক্ষিত ফলাফল থেকে বিনা খরচে উত্তর আসে।

transcribe, wait_for_job, get_transcript#

যেসব এজেন্ট নিয়ন্ত্রণ চায় তাদের জন্য তিন ধাপের পদ্ধতি: transcribe নেয় url, mode, ঐচ্ছিক language ও max_credits, সাথে একটি idempotency_key (যেকোনো স্থির 8 থেকে 128 অক্ষরের স্ট্রিং, যাতে আবার চেষ্টা করা কল কখনো দুবার জমা না হয়), এবং কাজটি ফেরত দেয়। wait_for_job নেয় job_id ও ঐচ্ছিক timeout_seconds। get_transcript নেয় কাজের result_id, সেটি transcript_id হিসেবে, এবং একটি format।

ভিডিও খোঁজা#

খোঁজা ও তালিকার টুলগুলো ভিডিও ফেরত দেয়, যেখানে url, শিরোনাম, দৈর্ঘ্য ও ভিউ সংখ্যা থাকে, যা সরাসরি get_video_transcript এ দেওয়া যায়। channel একটি @handle, চ্যানেল আইডি বা চ্যানেল URL নেয়; playlist একটি আইডি বা URL; user একটি TikTok @user বা প্রোফাইল URL। YouTube টুলগুলো limit (ডিফল্ট 20) ও cursor দিয়ে পাতা ধরে। TikTok সর্বোচ্চ 10টি ভিডিও দেয় এবং আর কোনো পরবর্তী পাতা থাকে না; include_details প্রতি ভিডিওতে লাইক, মন্তব্য, হ্যাশট্যাগ ও ক্যাপশনের ভাষা যোগ করে।

ত্রুটি#

ব্যর্থ কল isError: true ফেরত দেয়, সাথে API ত্রুটির কোড, বার্তা ও অনুরোধ আইডি, যাতে এজেন্ট ব্যাখ্যা করতে বা পথ বদলাতে পারে। কোডগুলো API রেফারেন্স এ যেগুলো আছে সেগুলোই।

সমস্যা সমাধান#

• Unauthorized: Claude এ কানেক্টরটি সরিয়ে আবার যোগ করুন, নতুন করে সাইন ইন করতে। কী দিলে সেটি সার্ভার কনফিগে (হেডার বা env) যায়, আপনার শেলে নয়; দেখুন সেটি বাতিল হয়নি তো।
• MCP সার্ভারে পৌঁছানো যাচ্ছে না: ঠিক এই URL ব্যবহার করুন, https://www.transcriptdock.com/mcp, www সহ।
• টুল পাওয়া যায়নি: কনফিগ বদলানোর পরে ক্লায়েন্ট আবার চালু করুন।
• লোকাল সার্ভার শুরু হচ্ছে না: Node.js 22.15 বা নতুন সংস্করণ ইনস্টল করুন এবং TRANSCRIPTDOCK_API_KEY ও TRANSCRIPTDOCK_BASE_URL দুটোই সেট করুন।
• NO_CAPTIONS: ভিডিওতে ক্যাপশন নেই। পেইড প্ল্যানে mode: "auto" ব্যবহার করুন।