AI ajanları için kargo otomasyonu

Geliver MCP ve CLI ile
kargoyu konuşarak yönetin

Claude, ChatGPT, Codex, Cursor ve yerel ajanlar; Geliver üzerinden kargo oluşturabilir, geçmiş gönderilerde detaylı arama yapabilir, son kargoya benzer yeni gönderi hazırlayabilir, indirimli teklifleri karşılaştırabilir, etiket satın alabilir ve kargo akışlarını otomatikleştirebilir.

MCP ile Bağlan CLI ve Skill’i İncele

Remote MCP

Claude ve ChatGPT

JSON CLI

Yerel ajanlar

Tek token adı

GELIVER_TOKEN

Kargo akışı

Arama, teklif, etiket

Geliver ajan akışı

1. Ara

“Geçen gün İzmir’e gönderdiğimiz kargonun durumu ne?”

Ajan kargo geçmişinde doğal dille detaylı arama yapar.

2. Hazırla

“Son kargonun aynısını İstanbul’a Ahmet adlı müşterimize gönderelim.”

Önceki gönderiden yeni kargo taslağı oluşturur.

3. Etiket

Etiketi indirir veya yazdırma akışını başlatır.

Takip ve iptal işlemleri de aynı araçlarla yapılabilir.

Ne yapabilirsiniz?

Geliver MCP ve CLI; kargo operasyonlarını panelde tek tek yapmak yerine güvenli araç çağrılarına dönüştürür.

Konuşarak arayın ve kargo oluşturun

Claude, ChatGPT veya MCP destekli istemcilerden detaylı kargo arama, kargo oluşturma, teklif bekleme, satın alma ve etiket yazdırma akışlarını başlatın.

Yerel ajanlar CLI ile çalışsın

Codex, Claude Code, Cursor ve otomasyon scriptleri Geliver CLI üzerinden JSON girdi ve JSON çıktı ile güvenilir şekilde işlem yapabilir.

Bütçe limitiyle güvenli satın alın

Etiket satın alma akışlarında fiyat limiti kullanın; ajan en uygun teklifi seçerken belirlediğiniz üst tutarı aşmaz.

Etiketi indirin veya yazdırın

Satın alma sonrası PDF ya da HTML etiket indirilebilir; MCP ve CLI üzerinden etiket yazdırma akışı tamamlanabilir.

Remote MCP

Claude ve ChatGPT’ye Geliver araçlarını ekleyin

MCP tarafında kullanıcıların sunucu yayınlamasına gerek yok. MCP destekli istemcide remote URL olarak https://ai.geliver.io/mcp kullanılır.

Geliver Token Al Soruları Gör
1

Remote MCP adresini ekleyin

Claude, ChatGPT veya MCP destekli istemcinizde Geliver MCP URL alanına bu adresi girin.

https://ai.geliver.io/mcp
2

Geliver tokenınızı alın

Geliver panelinde API token oluşturun. Tokenı sohbete yazmayın; yalnızca MCP/istemci ayarlarında saklayın.

Token sayfasını aç
3

Tek konfigürasyon adı kullanın

MCP tarafında Geliver kimliği için tek ad kullanılır. Header, credential veya env adı aynı kalır.

GELIVER_TOKEN
4

Bağlantıyı test edin

İlk mesajda Geliver hesabının bağlı olup olmadığını ve şehir listesinin gelip gelmediğini kontrol ettirin.

Geliver hesabım bağlı mı? Önce auth status bak, sonra Türkiye şehir listesini getir.

MCP istemci örnekleri

İstemciniz remote HTTP MCP destekliyorsa URL ve GELIVER_TOKEN yeterlidir. Header desteği yoksa local bridge kullanılabilir.

Claude Code

Remote HTTP MCP olarak ekleyin.

claude mcp add --transport http geliver https://ai.geliver.io/mcp \
  --header "GELIVER_TOKEN: your-geliver-token"

Claude Desktop / Bridge

Header ekleyemeyen istemcilerde mcp-remote bridge kullanın.

{
  "mcpServers": {
    "geliver": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://ai.geliver.io/mcp",
        "--header",
        "GELIVER_TOKEN:${GELIVER_TOKEN}"
      ],
      "env": {
        "GELIVER_TOKEN": "your-geliver-token"
      }
    }
  }
}

ChatGPT

Connector URL ve credential adını aynı şekilde tanımlayın.

Connector URL: https://ai.geliver.io/mcp
Credential / header name: GELIVER_TOKEN
CLI + Skill

Yerel ajanlar için JSON odaklı Geliver CLI

CLI, agentların tek tek form doldurmak yerine kontrollü JSON komutları çalıştırması için tasarlandı. Skill ise bu komutların hangi alanlarla ve hangi sırayla kullanılacağını ajanlara anlatır.

CLI Reposunu Aç Skill Kurulum Komutu

Skill kurulumu ve token

Geliver Skill kurulumu

npx skills add GeliverApp/cli

Komut skills.sh üzerinden Geliver skill paketini ajan ortamınıza ekler. Ayrı CLI kurulumu gerekmez.

Token adı

GELIVER_TOKEN

Token adresi

app.geliver.io/apitokens

Bağlantı kontrolü

GELIVER_TOKEN="$GELIVER_TOKEN" geliver auth-status

Operasyonları keşfet

geliver ops

Şehirleri listele

geliver op geo.cities --json '{"countryCode":"TR"}'

Kargo oluşturmayı önce planla

geliver op shipments.create --dry-run --json '{"senderAddressID":"...","recipientAddressID":"...","length":10,"width":5,"height":4,"weight":1}'

En uygun teklifi limitli satın al

geliver op shipments.buy_cheapest --json '{"shipmentID":"...","maxAmount":250,"timeoutMs":60000,"intervalMs":1000}'

Etiketi indir

geliver op labels.download --json '{"shipmentID":"...","output":"/tmp/geliver-etiket.pdf"}'

Desteklenen işlem alanları

MCP ve CLI, Geliver API’nin günlük kargo operasyonlarında ihtiyaç duyulan ana akışlarını ajanlara araç olarak sunar.

Kargo

Kargo oluşturma

Kargo listeleme ve detay alma

Doğal dille detaylı kargo/sipariş arama

Önceki kargodan yeni gönderi hazırlama

Teklif bekleme

En uygun teklifi satın alma

Kargo iptali

İade kargosu oluşturma

Etiket

Etiket satın alma

PDF etiket indirme

HTML etiket indirme

Etiket yazdırma

Adres ve kargo firması

Gönderici adresi yönetimi

Alıcı adresi yönetimi

Kargo firması hesabı listeleme

Kargo firması hesabı ekleme veya silme

Otomasyon

Webhook oluşturma

Webhook test etme

Fiyat sorgulama

Organizasyon bakiyesi

Ham API isteği

Güvenli çalışma akışı

Ajanlara işlem yaptırırken en iyi pratik basit: önce kontrol, sonra dry-run, ardından bütçe limitli satın alma.

1

Önce auth status ve bakiye kontrolü yapın.

2

Kargo payloadını dry-run ile doğrulayın.

3

Teklifleri bekleyin ve karşılaştırın.

4

Satın alma için mutlaka maxAmount limiti verin.

5

Etiketi indirin veya yazdırın.

6

Geçici test kargolarını işiniz bitince iptal edin.

Önerilen ajan talimatı

“Önce Geliver auth status ve bakiyeyi kontrol et. Kargo oluştururken dry-run yap. Satın alma için maksimum 250 TL limit kullan. Etiketi indir ve işlem bittiğinde özet ver.”

Bu yaklaşım hem MCP hem CLI için uygundur; token hiçbir zaman sohbet mesajına yazılmaz.

Sıkça Sorulan Sorular

Geliver MCP, CLI ve Skill hakkında merak edilenler

Geliver MCP nedir?

Geliver MCP, Claude, ChatGPT ve MCP destekli istemcilerin Geliver kargo işlemlerini araç olarak çağırmasını sağlar. Kargo oluşturma, teklif alma, etiket satın alma, etiket yazdırma, iptal, takip ve webhook işlemlerinde kullanılabilir.

MCP adresi nedir?

Remote MCP adresi https://ai.geliver.io/mcp olarak kullanılır. Kullanıcının ayrıca sunucu yayınlamasına gerek yoktur.

Geliver tokenımı nereden alırım?

Geliver tokenınızı https://app.geliver.io/apitokens adresinden oluşturabilirsiniz. MCP ve CLI tarafında token adı GELIVER_TOKEN olmalıdır.

Tokenı sohbete yazmam gerekir mi?

Hayır. Tokenı chat mesajına yazmayın. MCP ayarlarında credential/header olarak, CLI tarafında ise GELIVER_TOKEN ortam değişkeni olarak tanımlayın.

Geliver CLI kimler için?

Geliver CLI; Codex, Claude Code, Cursor, yerel ajanlar, cron işleri ve otomasyon scriptleri için JSON odaklı bir komut satırı aracı olarak tasarlanmıştır.

Geliver Skill ne işe yarar?

Geliver Skill, ajanların CLI komutlarını doğru JSON alanlarıyla kullanması için hazırlanmış talimat ve operasyon rehberidir. skills.sh üzerinden npx skills add GeliverApp/cli komutuyla yerel ajan çalışma alanına eklenebilir.

Ajanlar kargo geçmişinde detaylı arama yapabilir mi?

Evet. “Geçen gün İzmir’e gönderdiğimiz kargonun durumu ne?” gibi doğal dilde sorularla geçmiş kargolar aranabilir, bulunan kargonun takip ve durum bilgisi özetlenebilir.

Önceki bir kargodan yeni gönderi oluşturulabilir mi?

Evet. Ajan, son kargoya veya aramayla bulunan bir gönderiye benzer yeni kargo taslağı hazırlayabilir; alıcı, şehir veya müşteri adı gibi değişen alanları yeni isteğe göre düzenleyebilir.

Etiket satın alma güvenli mi?

Evet, akış bütçe limitiyle çalıştırılabilir. Satın alma komutlarında maxAmount vererek ajanın belirlediğiniz üst tutarı aşmasını engelleyebilirsiniz.

Kargo ve shipment aynı şey mi?

Evet. Kullanıcıya dönük Türkçe metinlerde kargo, API ve CLI operasyonlarında ise İngilizce alan adları nedeniyle shipment ifadesi kullanılır.

Geliver’i AI ajanlarınıza bağlayın

Remote MCP ile Claude ve ChatGPT’den, CLI ve Skill ile yerel ajanlardan aynı Geliver kargo akışlarını kullanabilirsiniz.

Geliver Token Al CLI Reposunu Aç