Asistanınızı MCP ile bağlayın

Yapay zeka asistanınızı transcript1'in uzaktaki Model Context Protocol sunucusuna bağlayın. Asistanınız YouTube, X, TikTok, Instagram, Facebook ve Bluesky bağlantıları için transkripsiyon başlatabilir, yüklediğiniz ses ve video dosyalarıyla çalışabilir ve hazır transkriptleri okuyabilir. Diğer desteklenen herkese açık kayıtları ve kısıtlamaları Kaynaklar ve seçenekler sayfasından kontrol edin.

Sosyal medya gönderisi herkese açık olmalıdır. Gönderide birkaç video varsa yalnızca ilkini yazıya çeviririz. YouTube ve X'in mevcut altyazı desteğine ek olarak TikTok, Bluesky, Dailymotion ve LinkedIn'de de videonun kendi dilindeki kullanılabilir altyazıları alırız. auto modunda altyazı bulunamazsa aynı dakika fiyatıyla sesi yapay zeka ile yazıya çeviririz. YouTube dışındaki altyazılarda otomatik oluşturulanlar dahil yalnızca segment zamanları bulunur (words: null). captions (yalnızca altyazı) modunda ses indirmeyiz ve STT kullanmayız. Konuşmacı ayırmayı açarsanız veya source=stt seçerseniz altyazıları atlarız. Ayrıntılar Kaynaklar ve seçenekler sayfasında.

• Sunucu adresi: https://api.transcript1.com/mcp (streamable HTTP).
• Kimlik doğrulama: Claude ve ChatGPT, OAuth 2.1 kullanır. transcript1'e giriş yapıp erişim izni verirsiniz. Cursor, VS Code, Claude Code ve ajanlarda ise API anahtarınızı Authorization: Bearer t1_... başlığıyla gönderin. Anahtarınızı “API keys” sayfasından oluşturabilirsiniz.

MCP araçları, verdiğiniz kimlik bilgisiyle /v1 REST API üzerinden çalışır. Doğrulama kuralları, ücretlendirme ve hata kodları değişmez. MCP çağrılarınız da hesabınızdaki diğer çağrılarla aynı dakika bakiyesini ve istek limitini kullanır.

Asistanın kullanabileceği araçlar

Format, bekleme ve sayfalama

• Varsayılan format değeri text olur. Her segment ayrı satıra yazılır; başında zaman damgası, konuşmacı ayırma açıksa konuşmacı etiketi bulunur. Örnek: [00:01:02] Speaker 1: Good morning. Dilerseniz srt, vtt veya json seçin.
• wait_seconds için varsayılan süre 50 saniyedir; 0–55 arasında seçebilirsiniz. İşlem bu sürede bitmezse araç bunu belirtir ve id döndürür. Bu kimliği get_transcription aracına vererek beklemeye devam edin.
• Uzun transkriptleri sayfalar halinde alırsınız. max_chars varsayılanı 60.000'dir; 1.000–100.000 aralığında değiştirilebilir. Sayfayı bir segmentin sonunda keseriz. Yanıttaki next_from_seconds değerini sonraki çağrıda from_seconds olarak gönderin.
• Metnin nereden geldiği her yanıtta transcript_source ile belirtilir: youtube_captions, x_captions, tiktok_captions, bluesky_captions, dailymotion_captions, linkedin_captions veya speech_to_text. caption_kind: null varsa altyazının kaynağı bilinmiyordur; içerik üreticisinin yüklediğini varsaymayın.

Aynı videoyu tekrar göndermeden önce kontrol edin

transcribe her çağrıda reuse_recent seçeneğini kullanır. Tam video bağlantısını aynı ayarlarla 24 saat içinde tekrar gönderirseniz önceki transkripsiyonu alırsınız; yeniden dakika harcamazsınız. Kısa bağlantılarda bu eşleştirme yapılamaz. Yanıtta eski transkripsiyonun kullanıldığı belirtilir. Devam eden işi kontrol etmek içinse videoyu yeniden göndermek yerine get_transcription veya list_transcriptions çağırın.

Dosya yüklerken

Dosyanın baytlarını doğrudan MCP üzerinden gönderemezsiniz. create_upload çağrısında transkripsiyonun id değerini, parça URL şablonunu, X-Upload-Token değerini ve parça listesini alırsınız. Asistan parçaları MCP dışında HTTP PUT ile yükler, sonra complete_upload çağırır. Gerekirse panelden devam edebilmeniz için yanıtta yükleme sayfasının bağlantısı da bulunur. Teknik adımlar Dosya yükleme sayfasında.

Webhook için REST API kullanın

MCP araçları webhook parametresi kabul etmez. Bildirim almak istiyorsanız REST API'deki webhook desteğini kullanın.

Claude

Claude'da uzaktaki MCP sunucusunu özel connector olarak ekleyin.

1. Claude'un connector ayarlarını açın ve özel bir connector ekleyin.
2. Bağlantıyı transcript1 olarak adlandırın. Sunucu adresine https://api.transcript1.com/mcp yazın.
3. Açılan adımda transcript1'e giriş yapın ve erişim izni verin. Bağlantı, transcriptions:read ve transcriptions:write yetkilerini ister.

Bağlandıktan sonra Claude'a “https://www.youtube.com/watch?v=dQw4w9WgXcQ adresindeki videoyu yazıya çevir” diyebilirsiniz. Özel connector kullanabilmeniz Claude planınıza bağlıdır.

ChatGPT

ChatGPT'de de özel connector ekleyerek bağlanın.

1. ChatGPT'nin connector ayarlarını açıp MCP sunucusu için özel bir connector oluşturun.
2. Sunucu adresine https://api.transcript1.com/mcp yazın.
3. transcript1'e giriş yapıp erişim izni verin.

Bu özellik ChatGPT planınıza ve çalışma alanınızın ayarlarına bağlıdır. Geliştirici modunu açmanız da gerekebilir.

Cursor'a MCP sunucusunu ekleyin

Kurulumu bağlantıdan başlatabilirsiniz: transcript1'i Cursor'a ekleyin

Elle ayarlamak için .cursor/mcp.json dosyasına aşağıdaki yapılandırmayı ekleyin. Authorization başlığında kendi API anahtarınızı kullanın:

{
  "mcpServers": {
    "transcript1": {
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

VS Code

Kurulumu bağlantıdan başlatabilirsiniz: transcript1'i VS Code'a ekleyin

Elle kurulum için çalışma alanınızdaki .vscode/mcp.json dosyasına şunu ekleyin:

{
  "servers": {
    "transcript1": {
      "type": "http",
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

Claude Code'da MCP bağlantısını kurun

Komutta t1_YOURKEY yerine kendi API anahtarınızı koyup çalıştırın:

claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"

Başka bir istemci kullanıyorsanız

İstemciniz uzaktaki MCP sunucularını destekliyorsa sunucu adresi olarak https://api.transcript1.com/mcp kullanın. API anahtarınızı Authorization: Bearer t1_... başlığında gönderin.

Sunucuyu komutla başlatan istemcilerde kurulum

Claude Desktop gibi MCP sunucusunu komutla başlatan bir istemci kullanıyorsanız TRANSCRIPT1_API_KEY ortam değişkenine API anahtarınızı yazın ve npx -y @transcript1/mcp çalıştırın. Bu paket transcript1'in sunucusuna bağlanır. Node.js 18 veya daha yeni bir sürüm gerekir.

Claude Desktop için aşağıdaki ayarları claude_desktop_config.json dosyasına ekleyin. t1_YOURKEY yerine “API keys” sayfasından aldığınız anahtarı kullanın.

{
  "mcpServers": {
    "transcript1": {
      "command": "npx",
      "args": ["-y", "@transcript1/mcp"],
      "env": { "TRANSCRIPT1_API_KEY": "t1_YOURKEY" }
    }
  }
}

Agent Skill

Agent Skill, ajana transcript1'i nasıl kullanacağını anlatan kısa bir SKILL.md dosyasıdır. Agent Skill destekleyen ajanınıza https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md adresindeki dosyayı ekleyin.

Ajanınız Agent Skill dosyalarını otomatik keşfedebiliyorsa dosyaya https://transcript1.com/.well-known/agent-skills/index.json listesinden de ulaşabilir.

Bir araç hata döndürürse

Araç çağrısı başarısız olursa REST API ile aynı code değerini alırsınız. Hata metninde açıklama ve asistanın atabileceği sonraki adım da bulunur. Biçim <code>: <message>. <next step> şeklindedir. Örneğin dakika bakiyesi yetmediğinde:

insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing

Kodların açıklamalarını Hatalar sayfasında bulabilirsiniz. Transkripsiyon başladıktan sonra başarısız olursa da aynı biçimde, örneğin media_private veya no_captions koduyla hata alırsınız.