GuruPDF MCP ile Claude ve Cursor'da Dosyaları Dönüştür

Kod ajanın bir uygulamanın iskeletini kurabilir, bir stack trace'i çözebilir ve sekme mi boşluk mu diye seninle tartışabilir. Ama ona bir PDF verip düzenlenebilir bir Word dosyası iste; orada takılıp kalır. Dosyalar diskinde yaşar; model ise sohbetin içinde. İkisini birbirine bağlayan hiçbir şey yok.

İşte GuruPDF MCP'yi tam da bu boşluk için yaptık — Claude'a, Cursor'a ve diğer tüm MCP istemcilerine dosyaları gerçekten dönüştürme imkânı veren küçük bir MCP sunucusu. İstemine bir yol koy, ne istediğini söyle, dönüştürülmüş dosya bir an sonra diskine geri düşsün. Yükleme ekranı yok, "indir, sonra başka bir yere tekrar yükle" derdi yok. Sadece "~/contracts/lease.pdf dosyasını Word'e dönüştür."

Dosya dönüştürme MCP'si tam olarak nedir

MCP — yani Model Context Protocol — bir yapay zekâ ajanının kendi kafasının dışındaki araçları kullanmasını sağlayan o fiştir. Bir sunucu birkaç eylem sunar; istemin gerektirdiğinde ajan onları çağırır. Veritabanları, tarayıcılar, GitHub için MCP sunucuları var.

Ama dosyalar için iyi bir tane yoktu. İşte bir PDF MCP — aslında bir dosya dönüştürme MCP'si, çünkü PDF'in çok ötesine uzanıyor — bir formatta dosya alıp sana başkasını geri veren bir sunucudan ibaret. PDF'ten Word'e. Bir görsel klasöründen tek bir PDF'e. Taranmış bir sayfadan aranabilir metne. İsteyen ajan; dönüştüren ise GuruPDF.

Kaputun altında gurupdf.com ile aynı motor çalışıyor: 126 araç, 100'den fazla format, artık doğrudan editörünün içinden erişilebilir.

Yaklaşık iki dakikada kur

İki şeye ihtiyacın var: Node (npx için) ve ücretsiz bir GuruPDF API anahtarı. gurupdf.com/profile adresinden bir anahtar al — ücretsiz hesaplar günlük kredilerle geliyor, yani hemen dönüştürmeye başlayabilirsin.

Sunucu kendini npx üzerinden kurup çalıştırıyor; klonlanacak bir şey yok:

npx gurupdf-mcp

Gerçi bunu elle çalıştırmayacaksın — MCP istemcini ona yönlendiriyorsun. Cursor, Claude Desktop, VS Code ya da Windsurf için şunu MCP yapılandırmana bırak:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

İstemciyi yeniden başlat, ajanın sessizce dört araç kazansın: bir dosyayı dönüştür, bir işi kontrol et, neyin desteklendiğini listele ve kredi bakiyeni kontrol et. Bütün kurulum bu kadar.

Bununla gerçekte neler yapabilirsin

İşte eğlenceli kısım. Bir kez bağladıktan sonra, bunlar gerçekten işe yarayan istemler:

• "~/Downloads/invoice.pdf dosyasını Word'e dönüştür ki toplamları düzenleyebileyim." — orijinalin yanında düzenlenebilir bir .docx beliriyor.
• "~/shots içindeki her ekran görüntüsünü tek bir PDF'e dönüştür." — görseller sırasıyla tek bir dosyada birleştiriliyor.
• "Bu tarama yalnızca bir görsel. OCR uygula ve bana metni ver." — piksellerin içinden gerçek metin geri çekiliyor.
• "report.pdf'i sıkıştır, 40 MB ve onu e-postayla göndermem lazım." — hâlâ okunabilir, daha küçük bir dosya.
• "https://example.com/pricing sayfasının bir PDF'ini yap." — canlı sayfa PDF'e dönüştürülüyor.

Araç adlarını ya da formatları asla ezberlemiyorsun. Hedefi sade bir dille söyle; sunucu 126 araçtan hangisinin uyduğunu seçsin, çalıştırsın ve sonucu diske yazsın. Birleştirme, bölme, döndürme, parola koruma, filigran, Excel ↔ PDF, HEIC → JPG — hepsi içinde.

Bir şeyler ters gittiğinde geri konuşur

Çoğu dönüştürücü anlaşılmaz bir kodla başarısız olur; bu ise kendini ajanın üzerinden açıklamak için tasarlandı — çünkü yanıtı asıl okuyan şey ajanın kendisi.

Ücretsiz katmanda kredilerin azaldığında çıplak bir 402 almazsın. Asistanının sana aktardığı bir cümle alırsın: ücretsiz sınıra ulaştın (dakikada 2, günde 10 dönüştürme), yarın sıfırlanıyor ve beklemek istemezsen işte bir bağlantı. Bir araca yanlış formatı ver ya da çok büyük bir dosya ver; sana tam olarak bunu söyler — hata numarasıyla değil, kelimelerle. Ne olduğunu anlamak için sohbetten ayrılmana hiç gerek kalmaz.

O "ajanın üzerinden açıkla" fikri, sözcükler üzerinde neden bu kadar titizlendiğimizin de sebebi. Hiçbir insanın okumadığı bir hata mesajının bile onu aktaran model için anlamlı olması gerekiyor.

Kaputun altında ne var

• 126 araç, 100'den fazla format. PDF, Word, Excel, PowerPoint, görseller, e-kitaplar, hatta video — web sitesiyle aynı motor.
• Gerçek bir ücretsiz katman. Her hesap günlük kredi alır. Daha yoğun kullanım için ücretli planlar ve kredi paketleri var; ajanın da bunlara seni ancak gerçekten mantıklı olduğunda yönlendirir, öncesinde değil.
• Dosyalar ortalıkta kalmaz. Her şey HTTPS üzerinden taşınır ve bir saat içinde silinir. MCP sonucu diskine yazar; bizdeki kopya da kısa süre sonra yok olur.
• Açık kaynak. Sunucu MIT lisanslı, npm üzerinde yayınlanmış ve resmî MCP kayıt defterinde listeli, yani çalıştırmadan önce her satırını okuyabilirsin.

Edin

Gününü Claude'da ya da Cursor'da geçiriyor ve sürekli bir dönüştürücü web sitesine fırlıyorsan, bu o gidiş-gelişi ortadan kaldırır.

• Kurulum: npx gurupdf-mcp
• Paket: npmjs.com/package/gurupdf-mcp
• Kayıt defteri: resmî MCP kayıt defterinde "GuruPDF" diye ara
• API anahtarı: gurupdf.com/profile

Bir kez ekle ve orada olduğunu unut — ta ki bir dosyayı dönüştürmek için bir tarayıcı sekmesi açacağın bir sonraki ana kadar; o zaman ajanın bunu senin yerine yapıveriyor.