Cursor ile MCP üzerinden video yazıya çevirme
Endpointi ve API anahtarını .cursor/mcp.json dosyasına ekleyin. VS Code için aynı adres .vscode/mcp.json içinde kullanılır. İki editör için de MCP rehberinde tek tıkla kurulum seçeneği bulunur.
İstemciniz uzaktaki MCP sunucularını desteklemeli ve requestlerde Authorization headerını göndermelidir. Cursor ve VS Code yapılandırmaları aynı değildir. Bir dosyanın adını değiştirmek yerine kullandığınız editöre ait örneği kopyalayın.
Bağlandıktan sonra asistandan önce get_account veya list_transcriptions çağırmasını isteyin. Böylece ücretli işlem başlatmadan bağlantıyı kontrol edersiniz. Araçlar görünmüyorsa sunucunun etkin olduğunu, yetki hatası alıyorsanız istemcideki API anahtarını kontrol edin.
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}Claude Code için MCP bağlantısını kurun
Claude Code içinde endpoint ve API anahtarıyla claude mcp add komutunu çalıştırın. Claude veya ChatGPT kullanıyorsanız aynı adresle özel bağlayıcı ekleyip giriş yapın. Claude bağlantı adımlarını izleyin.
Claude ve ChatGPT özel bağlayıcıları OAuth ile çalışır. Bağlayıcının kullanılabilirliği, asistan planınıza ve çalışma alanınızın ayarlarına bağlıdır. Kod editöründe API anahtarıyla kurulum farklıdır; kendi uygulamanızın adımlarını izleyin.
Araçlar hazır olduğunda asistana herkese açık bir video bağlantısı ve net bir görev verin. Örneğin bir Instagram Reels videosunun transkriptini almasını, sonra anlatılan adımları çıkarmasını isteyin. transcript1 konuşulanları verir; asistanın izlemediği görüntüler hakkında bilgi sağlamaz.
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"Transkripti alın, gerekiyorsa sonraki sayfaya geçin
Asistan transcribe çağırır, bekler ve metnin ilk sayfasını okur. İşlem bitmediyse get_transcription için bir ID alır. Parametreler araç referansında, yeniden kullanma ve sayfalama örnekleri ajan rehberinde yer alır.
Varsayılan yanıt zaman damgalı metindir. Uzun kayıtlarda next_from_seconds döner; sonraki çağrıda bunu from_seconds olarak gönderin. İlk sayfayı tüm transkript sanmayın. Asistan, gerekli devam sayfalarını okumadan kaydın tamamını özetlememeli.
Tam bağlantılar son 24 saatteki eşleşen işlemi yeniden kullanabilir; kısa paylaşım bağlantıları gönderilirken eşleştirilmez. Her durumda bildiğiniz ID ile get_transcription çağırmak yeni işlem açmayı önler. Aşağıdaki örnekteki yer tutucuyu gerçek, herkese açık bir TikTok video bağlantısıyla değiştirin.
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")Yerel dosyayı göndermek için dosyaya erişim de gerekir
MCP çağrısı dosyanın baytlarını taşımaz. create_upload bir yükleme kaydı ve parça planı oluşturur. Dosyaya erişebilen ajan, parçaları MCP dışında HTTP ile gönderir; ardından complete_upload çağırır. Sınırları dosya yükleme bölümünde bulabilirsiniz.
Bazı asistanlar uzak MCP araçlarını kullanabilir ama bilgisayarınızdaki dosyayı okuyamaz veya binary HTTP requesti gönderemez. Bu durumda kaydı panelden yükleyin, asistana tamamlanmış transkripsiyonun ID değerini verin. Sohbette bir dosya yolu yazmak, dosyayı transcript1 sistemine yüklemez.
Webhook gerekiyorsa REST API kullanın; MCP araçlarında bu parametre yoktur. Sohbet sırasında kısa beklemeler ve get_transcription çağrıları yeterlidir. Bağlantı kesildiyse ID ile devam edin veya son transkripsiyonları listeleyin. Kesilen çağrı, işlemin oluşturulmadığını göstermez.
Aynı bağlantıyla Bluesky videosu özetletebilir veya TikTok metni üzerinde çalışabilirsiniz. Gönderi herkese açık olmalıdır. Asistandan yalnızca transkriptteki sözlere dayanmasını isteyin; metin, görüntüde olan her şeyi anlatmaz.