Gemini URL Kısaltıcı: Araç Çağrıları Gerçekte Nerede Çalışır

Gemini, çalışan bir kısa bağlantı oluşturabilir. Yalnızca çoğu insanın ilk denediği yerde değil.

Bu ayrım diğer asistanlardakinden daha keskin ve Google'ın aldığı tek bir mimari karara dayanıyor: tüketici Gemini uygulamasının sahip olduğunuz bir API'yi çağıracak mekanizması yoktur. Ondan bir URL kısaltmasını isteyin; doğru biçimde ama arkasında hiçbir şey olmayan bir slug alırsınız. Gemini CLI farklı bir üründür ve farklı bir yanıt verir; araç çağrısı oradadır. Dolayısıyla Google'ın iki yüzeyi arasında bir tercih gibi görünen karar, ekibinizin bunu hiç kullanıp kullanamayacağını belirler.

Bu yazı üç yüzeyi ve her birinin gerçekte neler yapabildiğini ele alıyor: MCP üzerinden CLI, Gemini API'de fonksiyon çağırma ve önceden doldurulmuş sohbet. ChatGPT için yazılan paralel inceleme farklı bir sonuca varıyor; bir yüzey seçmeden önce nedenlerini anlamakta fayda var.

Gemini Uygulaması Neden Kısa Bağlantı Oluşturamaz

Gems, Gemini'nin özel asistan özelliğidir ve ilk bakışta özel bir GPT'nin karşılığı gibi görünür. Burada önemli olan bakımdan öyle değildir. Gems'te Actions karşılığı yoktur. OpenAPI şema alanı yok. Kimlik doğrulama yapılandırması yok. Birini kendi uç noktanıza yönlendirmenin yolu yok.

Gems, Google'ın kendi uzantılarını kullanabilir: Google Workspace, Maps, YouTube. Bunları sizin yapılandırmanız değil, Google yapar. Yani yetenek açığı, bir ayarla kapanan bir olgunluk açığı değildir. Bir Gem'in talimatlarına yazdığınız hiçbir şey ona API'nize ağ erişimi vermez.

Bu nedenle uygulama, araçsız herhangi bir asistanın kısa bağlantı isteğine yaptığı şeyi yapar. Akla yatkın karakterler üretir. Bir öğleden sonrayı istemlerle etrafından dolanmaya harcamadan önce bunu bilmekte fayda var.

Bir URL'yi Okumak, Kısaltmak Değildir

Bu konuyu aratırsanız Gemini'nin URL context aracı hakkında çok sayıda tartışmaya rastlarsınız. O, ters yöndür. URL context, modelin verdiğiniz bir sayfayı almasına ve okumasına izin verir. Bir URL kısaltıcının ise modelin bir şey yazmasına ihtiyacı vardır: sonradan bir yönlendirmeyi yanıtlayacak bir sunucuda kayıt oluşturmak. Okuma ve yazma ayrı yeteneklerdir ve yalnızca ikincisi hesabınızla konuşan bir araç gerektirir.

Birinci Yol: MCP Üzerinden Gemini CLI

Gemini CLI, Model Context Protocol'ü destekler; yani Claude Desktop ve Cursor'a hizmet veren aynı @elido/mcp-server, Gemini'ye özgü hiçbir kod olmadan burada da çalışır. Paket henüz npm'de değil (herkese açık sürüm yakında), bu yüzden şimdilik packages/mcp-server'ın yerel derlemesinden çalıştırılıyor. Bir kez yapılandırın; create_link, list_links, query_analytics, generate_qr ve list_workspaces çağrılabilir araçlar olarak görünür.

Sunucuyu eklemek

Hızlı yol yerleşik komuttur:

gemini mcp add -s user -e ELIDO_API_KEY=$ELIDO_API_KEY elido node /path/to/packages/mcp-server/dist/index.js

Ya da ayar dosyasını doğrudan düzenleyin. Kullanıcı kapsamı ~/.gemini/settings.json içinde, proje kapsamı .gemini/settings.json içinde yer alır ve blok mcpServers altına girer:

{
  "mcpServers": {
    "elido": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "ELIDO_API_KEY": "$ELIDO_API_KEY",
        "ELIDO_WORKSPACE_ID": "$ELIDO_WORKSPACE_ID"
      },
      "timeout": 30000
    }
  }
}

Bağlandığını doğrulayın ve neler yapabileceğini sınırlayın

Gemini CLI içinde /mcp komutunu çalıştırın. Yapılandırılmış her sunucuyu CONNECTED, CONNECTING veya DISCONNECTED durumuyla ve sunduğu araçlarla listeler. elido beş araç gösteriyorsa kurulum çalışıyordur. Sonra basit bir istek deneyin: "create a short link for https://example.com/spring with the slug spring-sale". Gerçek bir araç çağrısı, açabileceğiniz bir bağlantı ve panonuzda bir kayıt döndürür. Araç çağrısı olmadan uydurma bir slug geliyorsa sunucu bağlı değildir.

İki ayar bunu sıkı tutar. trust varsayılan olarak false'tur; yani CLI her araç çağrısından önce onay ister. Modelin create_link ile ne yaptığını öğrenirken bunu öyle bırakın. includeTools ise bir izin listesi gibi çalışır; yalnızca oluşturma ve analitik istiyorsanız onları yazın, gerisi modele hiç ulaşmaz:

"includeTools": ["create_link", "query_analytics"]

Can sıkan env genişletme ayrıntısı

Gemini CLI, env bloğu içindeki $VAR ve ${VAR} ifadelerini genişletir; bu yüzden yukarıdaki anahtar yapıştırılmış bir gizli bilgi değil, bir referanstır. Bunu kullanın. Canlı bir anahtarla proje kapsamlı .gemini/settings.json dosyasını commit etmek kolay bir hatadır ve fark edilmesi yavaş olur.

Google'ın MCP sunucu belgelerinden keskin bir köşe: tanımsız bir değişken hata fırlatmak yerine boş bir dizeye dönüşür. Dolayısıyla değişken adındaki bir yazım hatası başlangıçta sesli biçimde başarısız olmaz. Daha sonra, ilk araç çağrısında kimlik doğrulama hatası olarak patlar. Eksik bir export yüzünden yirmi dakikamı kaybettim ve hepsini yanlış dosyayı tekrar tekrar okuyarak harcadım; çünkü kimlik doğrulama hatası, onu taşıması gereken değişkenin adına değil, kimlik bilgisine işaret eder. Sunucu bağlanıyor ama her çağrı yetkisiz dönüyorsa önce değişkene bakın.

Anahtarı kurun; terminalde yazacağınız bir sonraki kampanya özeti kendi bağlantılarını oluşturabilir: bir çalışma alanı başlatın ve yalnızca bu entegrasyon için kapsamı sınırlı bir anahtar üretin.

İkinci Yol: Gemini API'de Fonksiyon Çağırma

Etkileşimli çalışmak yerine bir şey geliştiriyorsanız fonksiyon çağırma, API katmanındaki eşdeğer mekanizmadır. Fonksiyonu tanımlarsınız, model uygun gördüğünde yapılandırılmış bir çağrı döndürür, kodunuz isteği yürütür ve sonucu geri beslersiniz.

Biçim, her araç entegrasyonundakiyle aynıdır. create_link'i tanımlayın, HTTP isteğini kendiniz çalıştırın, yanıtı döndürün. MCP'ye göre kazandığınız şey kontroldür. Modelin hangi parametreleri ayarlayabileceğine tam olarak siz karar verirsiniz ve adlandırma kuralınızın dışındaki her şeyi istek sürecinizden çıkmadan önce reddedebilirsiniz. Kaybettiğiniz şey taşınabilirliktir. Bu bağlantıyı sürdürmek size aittir ve sizi hiçbir yere takip etmez.

Çoğu ekip için bu yol, yalnızca kısaltma daha büyük bir otomatik akışın içindeki bir adım olduğunda anlamlıdır. Sadece çalışırken bağlantı istiyorsanız CLI daha az kod ve ayakta tutulacak daha az şey demektir.

Üçüncü Yol: Önceden Doldurulmuş Sohbet

Kurulumsuz seçenek, Gemini'yi istem önceden yazılmış olarak açan bir bağlantıdır:

https://gemini.google.com/app?q=<url-encoded%20prompt>

LLM entegrasyonları sayfasındaki düğmelerin arkasındaki mekanizma budur ve Nisan 2026'da canlı yüzeyde doğrulanmıştır. Herhangi bir yapay zeka ürününde sorgu parametresi davranışı değişir; bu yüzden bir düğme eskiden yaptığını yapmayı bırakırsa yeniden test edin.

İlk bölümü göz önünde bulundurarak bunun size ne sağladığı konusunda gerçekçi olun. Asistanın araçları yoktur; taslağı o yazar, yürütmeyi siz yaparsınız. Bu yine de yararlıdır. Tutarlı bir adlandırma düzeniyle sekiz UTM varyantı gerektiren bir lansman elle sıkıcıdır ve bir modelin doğru yapması kolaydır. Sadece bir bağlantıyla bitmez.

Hangi Yol Uygun

Bu tabloyu ChatGPT tablosuyla birlikte okuyun; asimetri asıl noktadır. ChatGPT'nin paylaşılabilir yüzeyi bağlı bir eylemi barındırabilen yüzeydir, bu yüzden bir pazarlama ekibine çalışan bir özel GPT verilebilir. Gemini'nin bağlı yüzeyi ise bir terminaldir. Kullanıcılarınız pazarlamacılarsa bu fark, herhangi bir özellik karşılaştırmasından önce platformu belirler.

İyi Bir İstek Nasıl Görünür

Araç bağlandıktan sonra bağlantının kalitesi isteğe bağlıdır. Modele hedefi, önemsiyorsanız slug'ı ve kampanya bağlamını verin; UTM etiketlerini kuralınıza göre doldurmasına izin verin. "Create links for the spring launch: one each for newsletter, LinkedIn and the in-store poster, slugs prefixed spring-, with utm_source set per channel" isteği üç araç çağrısı ve bir tabloya yapıştırabileceğiniz üç bağlantı üretir. Belirsiz istekler belirsiz slug'lar üretir; bu yüzden adlandırma kuralının ne olduğunu söyleyin.

Sonucu bir meslektaşınızın işini kontrol eder gibi denetleyin. Bir bağlantıyı açın, doğru sayfaya indiğini doğrulayın ve panoda görüntüleyin. Başarılı bir araç çağrısı kaydın var olduğunu söyler; hedefin sizin kastettiğiniz olduğunu değil. Sık görülen adlandırma sorunları UTM adlandırma kurallarında ele alınıyor.

Anahtarı Kapsamlı Tutmak

MCP sunucusu kimlik bilgisini tutar ve model onu hiç görmez; bu doğru yapıdır. Yine de kimlik bilgisinin neler yapabileceğine siz karar verirsiniz.

Araçlar arasında tek bir anahtarı yeniden kullanmak yerine her entegrasyon için ayrı bir anahtar verin. Etkileşimli bağlantı oluşturma anahtarının bağlantı oluşturması ve analitik okuması gerekir; bağlantıları silmesi veya özel alan adlarına dokunması gerekmez; denetim günlüğünde beklenmedik bir şey göründüğünde, entegrasyon başına anahtar hangi yüzeyin ürettiğini söyler ve iptal edilmesi başka hiçbir şeyi bozmaz.

Proje kapsamı ek bir düşünceyi hak eder. Paylaşılan bir depoya commit edilen .gemini/settings.json kullanışlıdır ve aynı zamanda her katkıcının devraldığı bir dosyadır. Gizli bilgiyi ortamda tutun ve ayar dosyasını bir pull request'e yapıştırmayacağınız her şeyden arınmış bırakın.

Dürüst Sınırlar

Beklentiyi ayarlamaya değer üç şey.

Araç yüzeyi bilerek küçüktür. @elido/mcp-server 0.1.x sürümünde ve beş araçlıdır; çalışma alanı yönetimi bilerek bunların arasında değildir. İnsanları davet etmek, alan adlarını yapılandırmak ve planları değiştirmek, oturum açmış bir insanın yaptığı panoda kalır.

Toplu iş başka yere aittir. Tek bir konuşmada kırk bağlantı istemek hız sınırı hataları ve hangi slug'ın hangi hedefe gittiğini karıştıran bir model üretir. Bir avuçtan fazlası için API'yi veya CSV içe aktarmayı kullanın.

Uygulama açığı, kimsenin duyurduğu kadarıyla geçici değildir. Beklemek yerine buna göre plan yapın. Teknik olmayan bir ekip bugün bir sohbet yüzeyinden bağlantı oluşturmak zorundaysa dürüst yanıt bir Gem değil, başka bir asistan veya panodur.

Pillar yazıyı okuyun → Elido'yu MCP ile Claude ve Cursor'a bağlayın

Blogda İlgili Yazılar

• ChatGPT URL kısaltıcı: Ne işe yarar, ne taklit eder - aynı soru, farklı bir yanıt.
• Elido'yu MCP ile Claude ve Cursor'a bağlayın - bunun dayandığı eksiksiz MCP başvurusu.
• URL kısaltıcı API hızlı başlangıç - buradaki her yolun altındaki REST yüzeyi.
• Terraform olarak kısa bağlantılar - bağlantılar bir sohbete değil koda ait olduğunda.