# Asistanınızı MCP ile bağlayın > Claude, ChatGPT veya VS Code'u transkripsiyon MCP sunucusuna bağlayın. Cursor ve Claude Code için de kurulum adımlarını izleyin. Canonical: https://transcript1.com/tr/docs/mcp Language: tr Last updated: 2026-10-15 Yapay zeka asistanınızı transcript1'in uzaktaki [Model Context Protocol](https://modelcontextprotocol.io/) 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](https://transcript1.com/tr/docs/sources-and-options) 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](https://transcript1.com/tr/docs/sources-and-options) 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](https://transcript1.com/dashboard/account/tokens) oluşturabilirsiniz. MCP araçları, verdiğiniz kimlik bilgisiyle `/v1` [REST API](https://transcript1.com/tr/docs/api-reference) ü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 | Araç | Kullanımı | |---|---| | `transcribe` | Video bağlantısından transkripsiyon başlatır. `url` zorunludur; `platform`, `source`, `language`, `diarize`, `format` ve `wait_seconds` isteğe bağlıdır. Platform bağlantıdan belirlenir. İşlemi bekleyip transkriptin ilk sayfasını getirir; henüz bitmediyse `id` verir. | | `get_transcription` | `id` ile transkripsiyonun durumunu veya metnini alır. `wait_seconds`, `format`, `from_seconds` ve `max_chars` seçeneklerini de kabul eder. | | `list_transcriptions` | Yakın tarihli transkripsiyonları en yeniden eskiye sıralar; metinlerini getirmez. `status`, `platform`, `limit` ve `cursor` isteğe bağlıdır. | | `create_upload` | Yerel dosyanız için parçalı yükleme başlatır. `filename`, `size` ve sizin ürettiğiniz bir UUID olan `request_id` zorunludur. `mime_type`, `language` ve `diarize` de verilebilir. | | `get_upload_status` | Yüklenen parçaları listeler; kesilen yüklemede nereden devam edeceğinizi gösterir. | | `complete_upload` | Dosya parçalarını kontrol edip transkripsiyonu kuyruğa ekler. | | `delete_transcription` | Devam eden transkripsiyonu iptal edip dakikaları iade eder. İşlem sona ermişse transkripsiyonu metniyle birlikte siler. | | `get_account` | Dakika bakiyenizi, planınızı ve yenilenme tarihini getirir. | ### 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](https://transcript1.com/tr/docs/uploads) 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](https://transcript1.com/tr/docs/webhooks) 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](cursor://anysphere.cursor-deeplink/mcp/install?name=transcript1&config=eyJ1cmwiOiJodHRwczovL2FwaS50cmFuc2NyaXB0MS5jb20vbWNwIn0=) 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: ```json { "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](vscode:mcp/install?%7B%22name%22%3A%22transcript1%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.transcript1.com%2Fmcp%22%7D) Elle kurulum için çalışma alanınızdaki `.vscode/mcp.json` dosyasına şunu ekleyin: ```json { "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: ```bash 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](https://transcript1.com/dashboard/account/tokens) aldığınız anahtarı kullanın. ```json { "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](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 `: . ` şeklindedir. Örneğin dakika bakiyesi yetmediğinde: ```text insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing ``` Kodların açıklamalarını [Hatalar](https://transcript1.com/tr/docs/errors) 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.