---
title: "AI ajanları için transcript.im MCP sunucusu"
description: "Claude, ChatGPT, Cursor veya OpenAI Agent Builder'ı transcript.im MCP sunucusuna bağlayın ve ajanınıza araç olarak transkript, toplu iş ve YouTube keşfi verin."
canonical: "https://transcript.im/tr/mcp"
markdown: "https://transcript.im/tr/mcp.md"
---

# AI ajanları için transcript.im MCP sunucusu

Claude, ChatGPT, Cursor veya OpenAI Agent Builder'ı transcript.im MCP sunucusuna bağlayın ve ajanınıza araç olarak transkript, toplu iş ve YouTube keşfi verin.

## Bağlantılar

- [Kanonik HTML](https://transcript.im/tr/mcp)
- [Markdown](https://transcript.im/tr/mcp.md)


transcript.im MCP sunucusu, bir AI istemcisine doğrudan çağırabileceği bir transkript aracı verir. Claude, ChatGPT, Cursor veya OpenAI Agent Builder'ı sunucuya yönlendirin, bir API anahtarı verin; model herkese açık bir bağlantıdan transkript alabilir, toplu iş başlatabilir, altyazı dışa aktarabilir veya YouTube'da arama yapabilir — tarayıcı olmadan ve özel bir entegrasyon olmadan. Uzak bir HTTP uç noktasıdır, bu yüzden barındırılan bir istemcinin yalnızca URL'ye ve anahtara ihtiyacı vardır, yerel kuruluma değil.

- `https://mcp.transcript.im/mcp` adresinde tek bir uzak uç nokta, API anahtarınızla kimlik doğrular — kurulacak bir şey yok.
- Transkript, toplu iş, dışa aktarma, YouTube keşfi ve kullanım için on bir araç.
- AI aracı yok — modeli zaten istemciniz çalıştırıyor; sunucu transkriptleri ve platform verilerini sağlar.
- REST API üzerinden zaten kullandığınız aynı hesap ve aynı çıkarım hattı.
- Uzun transkriptler bir sayfa belirteciyle bölümlere ayrılır, böylece tek bir sonuç bağlam penceresini doldurmaz.

## transcript.im MCP sunucusu ne yapar

Model Context Protocol, bir istemcinin sunucunun yayımladığı araçları keşfetmesini ve çağırmasını sağlar. transcript.im MCP sunucusu bu yüzeyi tek bir iş için kullanır: herkese açık bir video veya ses bağlantısını transkripte çevirmek ve etrafındaki platform sorularını yanıtlamak. İstemci bir URL ile `get_transcript` çağırır; sunucu transcript.im çıkarım hattına ulaşır, varsa içerik üreticisinin altyazılarını kullanır, yoksa AI transkripsiyonuna geçer.

Ağır iş sunucuda olduğu için istemcinin ne bir indiriciye, ne bir tarayıcı otomasyon yığınına, ne de kendi konuşma tanıma modeline ihtiyacı vardır. Tek bir araç çağrısı yeter. Bir MCP transkript sunucusunun anlamı budur: model zaten burada olma sebebinizdir, sunucu da veriye odaklı kalır.

- Araç olarak transkript çıkarımı — tek çağrı bir bağlantıyı zaman damgalı metne çevirir.
- YouTube keşfi de — video arayın, kanalları çözün, yüklemeleri ve oynatma listesi öğelerini listeleyin, altyazı üst verisini okuyun.
- Toplu iş ve dışa aktarma — birçok bağlantıyı kuyruğa alın, sonra tamamlanan kümeyi dışa aktarın.
- İçinde model yok — sunucu veri döndürür; onunla ne yapılacağına istemci karar verir.

## Ajanınızın çağırabileceği araçlar

### Transkriptler

`get_transcript` bir URL'den transkript çıkarır veya uzun bir transkriptin sonraki bölümünü okur; `get_transcript_info` ise bir çıkarıma karar vermeden önce videonun üst verisini ve API'nin çözebildiği altyazı parçalarını döndürür. İkisi birlikte, bir ajanın bir videonun transkripte değip değmeyeceğine karar vermesini, gerçekten ihtiyaç duyduğu dil önceliğini istemesini ve metni zaman damgalı ya da damgasız almasını sağlar.

### Toplu iş ve dışa aktarma

`create_batch` bir URL listesinden, bir oynatma listesinden veya bir kanaldan çalışma başlatır; `get_batch` durumu, sayıları ve sonraki öğe sayfasını bildirir; `export_batch` tamamlanan bir toplu işi metne veya altyazıya çevirir. Bir ajanın tek tek klipler yerine bir üreticinin tüm arşivini böyle işlediği yol budur ve başarısız bir bağlantı, kalanı çöpe atmak yerine ayrıca bildirilir.

### YouTube keşfi

`search_video` konuya göre video veya kanal bulur, `get_channel` bir handle'ı veya URL'yi çözer, `list_channel_video` bir kanalın yüklemelerini listeler, `list_playlist_item` bir oynatma listesinde ilerler ve `list_caption` bir videonun altyazı üst verisini ve transkript metnini okur. Bir ajanın bir nişi araştırmak, bir üreticinin ne yayımladığını kontrol etmek ve herhangi bir şeyi transkripte etmeden önce doğru kaynağı seçmek için kullandığı araçlar bunlardır.

### Hesap

`get_usage` hesabın kullanım özetini bildirir; böylece bir ajan büyük bir toplu işe veya uzun bir kanala girmeden önce hesabın neyi kullandığını görür, çalışmanın ortasında bir sınıra çarpmak yerine.

## Zaten kullandığınız istemciyi bağlayın

### Claude

Uzak sunucuyu özel bir bağlayıcı olarak ekleyin veya komut satırından kaydedin. Claude MCP sunucusuyla görüşür, araçlarını konuşmaya açar ve turlar arasında kullanılabilir tutar; böylece doğal dille bir transkript isteyip bağlantıyı tekrarlamadan hemen ardından özet isteyebilirsiniz.

### ChatGPT

Bir MCP bağlayıcısı ekleyin ve API anahtarı kimlik doğrulamasını seçin. ChatGPT ardından transkript araçlarını diğer bağlı uygulamalar gibi çağırır; yani sohbete yapıştırılan bir video bağlantısı, modelin alıntılayabileceği, çevirebileceği veya inceleyebileceği okunabilir metne dönüşebilir.

### Cursor ve diğer editörler

Editörün `mcpServers` yapılandırmasını API anahtarınızla birlikte uzak URL'ye yönlendirin. Editörün ajanı ardından bir bağlantıyı transkripte edip sonucu doğrudan projenize veya notlarınıza yazabilir.

### OpenAI Agent Builder

Sunucu URL'si ve bir Bearer kimlik bilgisiyle bir MCP aracı ekleyin; ajan transkriptleri daha büyük bir iş akışının adımı olarak kullanabilir ve metni özel bir bağlayıcı olmadan sonraki adıma aktarabilir.

## Bağlanma ve kimlik doğrulama

Sunucu uzak bir HTTP uç noktasıdır, bu yüzden bir istemciyi bağlamak kurulum değil, bir URL ve bir anahtardır.

- Uzak HTTP — MCP istemcinize `https://mcp.transcript.im/mcp` ekleyin; makinenizde çalışması gereken bir şey yok.
- API anahtarı — anahtarı `Authorization: Bearer <key>` veya `x-api-key` olarak gönderin; sunucu onu REST API'ye iletir, böylece aynı hesap ve izinler geçerli olur.
- Araç keşfi — uç nokta MCP keşif isteklerini yanıtlar, böylece bir istemci çağırmadan önce sunduğu araçları listeleyebilir.
- Aynı sonuçlar — araçlar, bölümleme ve hatalar aynı hesabın REST API'den aldığıyla örtüşür, böylece davranış istemciye bağlı değildir.

## Uzun transkriptler yönetilebilir kalır

İki saatlik bir kayıt, bir modelin tek bir araç sonucunda alması gerekenden çok daha fazla metin üretebilir; bu yüzden sunucu uzun transkriptleri sınırlı bölümler halinde döndürür. Her bölüm `truncated: true` ve opak bir `nextPageToken` bildirir; yalnızca o belirteçle `get_transcript` tekrar çağrıldığında sonraki bölüm döner ve ajan transkript tükenene kadar yineler.

- Sınırlı sonuçlar — her bölümün bir üst sınırı vardır, böylece tek bir sonuç bağlam penceresini doldurmaz veya önceki akıl yürütmeyi dışarı itmez.
- Durumsuz sayfalama — belirteç konumu taşır ve çağrılar arasında hiçbir sunucu oturumu tutulmaz, böylece herhangi bir kopya sonraki bölümü sunabilir.
- JSON sayfalama — bir JSON transkripti segment bazında sayfalanır, böylece yapısal bir tüketici metinde ilerlerken beklediği şemayı korur.
- İş yoklaması — altyazısı olmayan bir video bir iş kimliği döndürür ve ajan transkript hazır olana kadar yoklar.
- Okunabilir başlangıç — ilk bölüm açılışla ilgili bir soruyu yanıtlamaya yeter, bu yüzden kısa bir devam sorusu tüm transkripti çekmek zorunda kalmaz.

## Ajanınızın üzerine hareket edebileceği hatalar

Bir araç çağrısı başarısız olduğunda sunucu, yığın izi yerine okunabilir metinli bir MCP hatası döndürür. Yapısal ayrıntılar sonuçla birlikte gelir, böylece ajan tahmin etmek yerine toparlanabilir: bir `code`, bir HTTP `status`, bir sınıra ulaşıldığında `upgradeUrl` ve istenen dil yoksa `availableLanguages`. Bu, çıkmaz bir yolu bir sonraki eyleme çevirir — başka bir dili deneyin, başka bir bağlantı seçin veya sınırı konuşmadaki kişiye bildirin. Bir hatanın nedenini okuyabilen bir model kendi sonraki denemesini düzeltebilir; faydalı biçimde yeniden deneyen bir ajanla aynı bozuk çağrıda döngüde kalan bir ajan arasındaki fark budur.

## İlgili

- [REST API](/tr/api)
- [Agent Skills](/tr/skills)
- [API dokümantasyonu](/docs)
- [YouTube Transkript Oluşturucu](/tr/youtube-transcript)
- [YouTube Video Özetleme](/tr/youtube-video-summarizer)
- [Altyazı Oluşturucu](/tr/youtube-subtitle-generator)
- [YouTube Altyazı İndirme](/tr/youtube-subtitle-downloader)
- [Kanal Transkripti](/tr/youtube-channel-transcript)
- [Oynatma Listesi Transkripti](/tr/youtube-playlist-transcript)
## MCP sunucusu hakkında SSS

### transcript.im MCP sunucusu nedir?

transcript.im MCP sunucusu, transkript çıkarımını, toplu işleri, dışa aktarmaları ve YouTube keşfini bir AI istemcisinin çağırabileceği araçlar olarak sunan bir Model Context Protocol yüzeyidir.

### Hangi istemciler transcript.im MCP sunucusuna bağlanabilir?

Claude, ChatGPT, Cursor, OpenAI Agent Builder ve diğer tüm MCP istemcileri bir API anahtarıyla uzak HTTP uç noktasına bağlanabilir.

### transcript.im MCP sunucusu AI araçları içeriyor mu?

Hayır. Sunucu bilinçli olarak yalnızca veri ve çıkarım araçları sunar, çünkü sonucu özetleyen veya yeniden yazan modeli istemci zaten çalıştırır.

### Bir ajan bir video bağlantısından transkripti nasıl alır?

Transkript aracını bağlantıyla çağırır; sunucu önce mevcut altyazıları kullanır, yoksa AI transkripsiyonuna geçer ve zaman damgalı metin döndürür.

### MCP sunucusu uzun transkriptleri nasıl ele alır?

Sınırlı bölümler halinde döndürülür. Her sonuç bir kırpma işareti ve bir sayfa belirteci taşır ve ajan sonraki bölümü okumak için aracı o belirteçle tekrar çağırır.

### Bir ajan transcript.im MCP sunucusu üzerinden toplu iş çalıştırabilir mi?

Evet. Toplu iş araçları bir URL listesi, bir oynatma listesi veya bir kanal kabul eder, durumu ve sayıları bildirir ve tamamlanan kümeyi metin veya altyazı olarak dışa aktarır.

### transcript.im MCP sunucusu YouTube arama ve kanallarla çalışır mı?

Evet. Özel araçlar video ve kanal aramasını, kanal çözümlemeyi, kanal yüklemelerini, oynatma listesi öğelerini ve altyazı üst verisini kapsar.

### MCP sunucusu bir istemcinin kimliğini nasıl doğrular?

API anahtarını Bearer belirteci veya `x-api-key` başlığı olarak kabul eder ve REST API'ye iletir, böylece çağrıları doğrudan bir API isteğiyle aynı hesaba düşer.

## transcript.im MCP sunucusunu bağlayın

Sunucu URL'sini MCP istemcinize ekleyin, bir API anahtarı verin ve ajanınızdan bir transkript isteyin.

- [API anahtarı oluştur](/app/account/api-keys)
- [API sözleşmesini oku](/docs)