Basit Kargo MCP

ChatGPT, Claude ve diğer yapay zeka asistanlarını Basit Kargo hesabınıza bağlayın: kargo takibi, fiyat karşılaştırma, sipariş oluşturma, tahsilat ve ekstre — hepsi sohbet ederek.

45 Araç

OAuth 2.1

MCP Streamable HTTP

Sunucu Adresi

MCP (Model Context Protocol), yapay zeka asistanlarının harici servislere bağlanmasını sağlayan açık standarttır. Basit Kargo MCP sunucusuna tüm MCP uyumlu istemcilerden bağlanabilirsiniz:

MCP Sunucusu

https://mcp.basitkargo.com/mcp

💡

Bu adres bir MCP uç noktasıdır — tarayıcıda açılmaz, yapay zeka istemcinizin bağlayıcı (connector) ayarına yapıştırılır. Kurulum adımları aşağıda istemci istemci anlatılmıştır.

Bağlantı Yöntemleri

İki yöntemden istemcinize uygun olanı kullanın:

1OAuth ile bağlanma (önerilen)

ChatGPT ve claude.ai gibi istemcilerde sunucu adresini eklediğinizde Basit Kargo izin sayfası açılır. Panele giriş yapıp İzin Ver dediğinizde bağlantı otomatik kurulur — token kopyalamanız gerekmez. Verilen izin, panelinizde "Yapay Zeka - <istemci adı>" isimli bir API anahtarı olarak görünür ve istediğiniz an silebilirsiniz.

2API anahtarı ile bağlanma

Header destekleyen istemcilerde (Claude Code, Cursor vb.) panelden aldığınız API anahtarını Authorization: Bearer başlığıyla gönderin. Anahtarınızı Panel → Ayarlar → Entegrasyonlar → API sekmesinden oluşturabilirsiniz.

HTTP Header

Authorization: Bearer API_ANAHTARINIZ

İstemci Kurulumu

ChatGPT

1. ChatGPT'de Ayarlar → Bağlayıcılar (Connectors) → Bağlayıcı ekle adımına gidin.
2. Sunucu adresi alanına https://mcp.basitkargo.com/mcp yapıştırın.
3. ChatGPT sizi Basit Kargo izin sayfasına yönlendirir; giriş yapıp İzin Ver deyin.
4. Sohbette "Basit Kargo bakiyem ne kadar?" diye sorarak test edin.

💡

Bağlayıcı ekleme seçeneği ChatGPT planınıza göre Ayarlar → Connectors altında ya da geliştirici modunda yer alır.

Claude (claude.ai)

1. claude.ai'da Settings → Connectors → Add custom connector deyin.
2. URL alanına https://mcp.basitkargo.com/mcp yapıştırın.
3. Açılan Basit Kargo izin sayfasında İzin Ver deyin — bağlantı hazır.

Claude Code

Terminalde tek satır (API anahtarınızı panelden alın):

Terminal

claude mcp add --transport http basitkargo https://mcp.basitkargo.com/mcp --header "Authorization: Bearer API_ANAHTARINIZ"

Cursor

~/.cursor/mcp.json dosyasına (veya proje içindeki .cursor/mcp.json) ekleyin:

mcp.json

{
  "mcpServers": {
    "basitkargo": {
      "url": "https://mcp.basitkargo.com/mcp",
      "headers": { "Authorization": "Bearer API_ANAHTARINIZ" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json dosyasına ekleyin; ilk kullanımda OAuth izin akışı otomatik açılır:

settings.json

{
  "mcpServers": { "basitkargo": { "httpUrl": "https://mcp.basitkargo.com/mcp" } }
}

Grok (xAI)

1. grok.com'da Settings → Connectors → New Connector → Custom adımına gidin.
2. Sunucu adresi alanına https://mcp.basitkargo.com/mcp yapıştırın.
3. Açılan Basit Kargo izin sayfasında İzin Ver deyin — bağlantı hazır.

Araçlar

Asistanınız bağlandığında aşağıdaki 43 aracı görür ve sorularınıza göre kendisi seçer — araç adlarını bilmenize gerek yoktur. OKUMA araçları veri değiştirmez; YAZMA araçları kayıt oluşturur veya değiştirir. Kargo ücretleri her zamanki tarifenizle uygulanır — panelden yaptığınız işlemlerle aynı koşullar; MCP veya yapay zeka kullanımının ek bir ücreti yoktur.

Gönderi İşlemleri

Araç	Adı	Ne yapar	Erişim
`track_shipment`	Kargo Takibi	Sipariş no, barkod veya takip koduyla gönderiyi bulur; durum ve hareketleri gösterir	OKUMA
`search_shipments`	Kargo Arama	Alıcı adı, telefon, sipariş no, barkod, takip kodu veya ürün adıyla gönderi arar — panel arama kutusuyla aynı	OKUMA
`list_shipments`	Gönderi Listesi	Gönderileri durum, tarih, kargo firması, kaynak, kargo yönü, kapıda ödeme, sipariş ödeme durumu, marka ve adres filtreleriyle listeler	OKUMA
`create_shipment`	Sipariş Taslağı Oluşturma	Ücretsiz taslak sipariş oluşturur — bu adımda para çekilmez	YAZMA
`update_shipment`	Sipariş Güncelleme	Henüz kargolanmamış (NEW) taslağı günceller	YAZMA
`get_shipment_fee`	Sipariş Kargo Ücretleri	Taslak sipariş için firma firma fiyat listeler	OKUMA
`generate_shipment_code`	Kargo Kodu Üretimi	Seçilen firmadan kargo kodu/barkod alır — gönderiyi kesinleştiren adımdır, asistan önce onayınızı ister	YAZMA
`bulk_generate_codes`	Toplu Kargo Kodu Üretimi	En fazla 20 taslak için tek seferde kod alır; sonuç sipariş sipariş raporlanır, asistan önce onayınızı ister	YAZMA
`cancel_shipment`	Kargo Kodu İptali	Gönderime hazır kargonun kodunu iptal eder — sipariş silinmez, taslağa (NEW) döner	YAZMA
`delete_order`	Taslak Silme	NEW durumdaki taslak siparişi siler; kodlu gönderi için önce kod iptali gerekir	YAZMA
`create_return`	İade Kodu Oluşturma	Teslim edilmiş gönderi için iade kodu üretir	YAZMA
`get_label`	Kargo Etiketi	Kodlu siparişin etiketini görsel (PNG) olarak verir — paket başına bir etiket	OKUMA
`print_label`	Etiketi Yazdır	Etiketi masaüstü yazıcı ajanınız üzerinden fiziksel yazıcıdan çıkarır (ajan çevrimiçi olmalı)	YAZMA
`list_printers`	Yazıcı Listesi	Yazıcı ajanlarınızı, yazıcılarını ve çevrimiçi durumlarını listeler	OKUMA

Fiyat & Firmalar

Araç	Adı	Ne yapar	Erişim
`get_price_quote`	Fiyat Karşılaştırma	Desi/kg değeri için tüm firmaların güncel fiyatını karşılaştırır; kapıda ödeme tutarı verilirse her firmanın tahsilat hizmet bedelini de gösterir	OKUMA
`list_handlers`	Kargo Firmaları	Kullanabileceğiniz kargo firmalarını listeler	OKUMA

Finans

Araç	Adı	Ne yapar	Erişim
`get_balance`	Bakiye Sorgulama	Güncel Basit Kargo bakiyeniz	OKUMA
`get_account_status`	Hesap Durumu	Hesap tipi, üyelik onay durumu, varsa hatalı belge nedeni ve ne yapılması gerektiği	OKUMA
`get_cod_status`	Kapıda Ödeme Tahsilatları	Tahsilat özeti (brüt/komisyon/net) ve gün gün ödeme takvimi	OKUMA
`list_transactions`	Hesap Hareketleri	Ekstre: kargo ücretleri, yüklemeler, tahsilat aktarımları	OKUMA
`list_invoices`	Kargo Faturaları	Basit Kargo'nun size kestiği dönem faturaları (panel Faturalarım sayfasıyla aynı): numara, tutar, vade, durum; istenirse kalemler ve PDF indirme bağlantısı	OKUMA

Müşteri & İstatistik

Araç	Adı	Ne yapar	Erişim
`search_customers`	Müşteri Arama	Daha önce gönderi yaptığınız alıcıları ada/telefona göre bulur — "Ahmet'e yine kargo gönder" demeniz yeterli	OKUMA
`get_stats`	Gönderi İstatistikleri	Dönemsel özet: adetler, maliyetler, ortalamalar, iade oranı	OKUMA

Notlar & Tercihler

Asistanınızla ortak bağlam: siparişlere ve müşterilere not düşün, firma geneli çalışma tercihlerinizi kaydedin — sonraki sohbetlerde de erişilebilir olur.

Araç	Adı	Ne yapar	Erişim
`get_preferences`	Çalışma Tercihleri	Firmanızın kayıtlı çalışma tercihlerini getirir ("2 desi üstünde hep Aras" gibi) — asistanınız kargo kararlarında bu tercihleri bağlam olarak kullanabilir	OKUMA
`get_notes`	Notlar	Bir siparişin veya müşterinin kayıtlı notlarını listeler	OKUMA
`add_note`	Not Ekleme	Siparişe, müşteriye veya firma geneli tercihlere not ekler ("not düş", "şunu unutma")	YAZMA
`delete_note`	Not Silme	Bir notu id'siyle siler (yalnız açık isteğinizle)	YAZMA

Otomasyon

Paneldeki otomasyon kurallarınızı asistanınızla inceleyin, çalışma geçmişine bakın, gerektiğinde açıp kapatın; yeni kuralı düz Türkçe anlatın, asistan önce taslağı ve uyarıları gösterir, onayınızla kaydeder. Mevcut kuralları düzenleme ve silme şimdilik panelde kalır.

Araç	Adı	Ne yapar	Erişim
`list_automations`	Otomasyon Listesi	Kurallarınızı tetikleyici, koşul, aksiyon ve çalışma sayılarıyla listeler; özet istatistikleri verir	OKUMA
`get_automation_history`	Otomasyon Geçmişi	Bir kuralın çalışma geçmişini veya bir siparişe uygulanan kuralları aksiyon sonuçlarıyla gösterir	OKUMA
`set_automation_enabled`	Otomasyon Aç/Kapat	Bir kuralı açar veya kapatır — kargo kodu üreten kuralları açmadan önce asistan onayınızı ister	YAZMA
`draft_automation`	Otomasyon Taslağı (AI)	Düz Türkçe anlatımı doğrulanmış kural taslağına çevirir; kaydetmez, özet ve uyarıları gösterir (yapay zeka kullanım limitine tabidir)	YAZMA
`create_automation`	Otomasyon Oluşturma	İncelenen taslağı kural olarak kaydeder — panel sihirbazıyla aynı doğrulamalar; kargo kodu üreten kural için asistan önce onayınızı ister	YAZMA

Hesap & Konum

Araç	Adı	Ne yapar	Erişim
`list_brands`	Marka Listesi	Kayıtlı gönderici markalarınız	OKUMA
`create_brand`	Marka Ekleme	Yeni gönderici markası oluşturur (onay sürecine girer)	YAZMA
`list_addresses`	Adres Listesi	Kayıtlı çıkış adresleriniz	OKUMA
`create_address`	Adres Ekleme	Yeni çıkış adresi oluşturur (resmî adres kayıtlarıyla doğrulanır)	YAZMA
`list_cities`	Şehir Listesi	İl listesi	OKUMA
`get_districts`	İlçe Listesi	Bir ilin ilçelerini listeler	OKUMA

Destek

Basit Kargo destek ekibiyle yazışmanız asistanınızdan yönetilebilir: talep açın, cevapları okuyun, yanıt yazın. Dosya ekleri panelde kalır.

Araç	Adı	Ne yapar	Erişim
`list_tickets`	Destek Talepleri	Taleplerinizi durum, kategori ve okunmamış cevap sayısıyla listeler; açık/cevaplanmış/çözülmüş özetini verir	OKUMA
`get_ticket`	Destek Talebi Detayı	Bir talebin tüm yazışmasını gösterir; destek cevaplarını okundu işaretler	OKUMA
`create_ticket`	Destek Talebi Açma	Konu, açıklama, kategori ve isteğe bağlı sipariş bağlantısıyla yeni talep açar — asistan metni önce size gösterir	YAZMA
`reply_ticket`	Destek Talebine Yanıt	Açık bir talebe yanıt yazar; kapalı talebe yazılamaz	YAZMA
`search_help`	Yardım Makaleleri	Basit Kargo'nun nasıl çalıştığına dair onaylı yardım makalelerini arar: ücretler, kapıda ödeme tahsilatı, iade, entegrasyonlar, destek saatleri	OKUMA

Tanılama

Araç	Adı	Ne yapar	Erişim
`auth_status`	Bağlantı Durumu	Bağlantıyı ve API anahtarını test eder	OKUMA
`status_labels`	Durum Sözlüğü	Kargo durum kodlarının Türkçe karşılıkları	OKUMA

Güvenlik

💰

Para güvenliği iki adımlıdır: sipariş oluşturmak her zaman ücretsiz taslak üretir; gönderiyi kesinleştiren adım kargo kodu üretimidir ve asistanınız bu adım öncesinde onayınızı ister. Kargo ücreti her zamanki tarifenize göre uygulanır: Basit Kargo anlaşmalı gönderilerde bakiyenizden düşer, kendi kargo anlaşmanızla gönderimlerde ücretlendirmeyi kargo firmanız yapar. Sunucu tarafındaki korumalar aynı sipariş için mükerrer kod üretimini ayrıca engeller.

Konu	Detay
Veri kapsamı	Bağlantı yalnızca sizin firmanızın verisine erişir; araçlar okuma/yazma olarak işaretlidir ve istemciler ücretli/yazma adımlarında ek onay ister.
Yetki iptali	Panel → Ayarlar → Entegrasyonlar → API'den ilgili anahtarı sildiğinizde bağlantı (OAuth dahil) anında geçersiz olur.
İstek limiti	Dakikada 120 istek — olağan sohbet kullanımının çok üzerindedir.
Şifreleme	Tüm trafik HTTPS; OAuth bağlantılarında anahtarlar sunucuda şifreli saklanır.

Örnek Komutlar

Bağlantı kurulduktan sonra asistanınıza doğal dille yazın:

Siz yazın	Asistan ne yapar
"Bugünkü kargolarım ne durumda?"	Günün özetini çıkarır; sorunlu gönderileri tek tek belirtir
"3 desi İzmir'e hangi firma en ucuz?"	Tüm firmaların fiyatını karşılaştırıp önerir
"Ahmet Yılmaz'a yine kargo gönder"	Müşteri havuzundan bilgileri bulur, onayınızla taslağı oluşturur
"Kapıda ödeme param ne zaman yatacak?"	Tahsilat özetini ve ödeme takvimini gösterir
"Bu ay kargoya ne kadar harcadım?"	Ekstreden dönem toplamını çıkarır
"Ağustos faturam ne kadardı, ödendi mi?"	Basit Kargo faturanızı bulur; tutar, vade ve PDF bağlantısını verir
"Dün otomasyon kaç siparişi işledi, hata var mı?"	Kurallarınızı ve çalışma geçmişini inceler; başarısız aksiyonları belirtir
"Kapıda ödemeli İstanbul siparişlerine otomatik Aras kodu üret"	Kural taslağını ve uyarıları gösterir; onayınızla otomasyonu kaydeder
"Bu kargo 5 gündür hareketsiz, destek talebi aç"	Gönderi bilgileriyle talep metnini hazırlar, onayınızla açar; cevabı sonra okur
"ABC-123 siparişinin etiketini ver"	Etiketi görsel olarak getirir

Sık Sorulan Sorular

Hangi yapay zeka asistanlarıyla çalışır?

MCP destekleyen tüm istemcilerle: ChatGPT, Claude (claude.ai ve Claude Code), Grok, Cursor, Gemini CLI ve diğerleri.

MCP bağlantısı ücretli mi?

Hayır, bağlantı ücretsizdir. Kargo işlemleri her zamanki tarifenizle ücretlendirilir — panelden yaptığınız işlemlerle aynı koşullar; MCP'ye özel bir ücret yoktur.

Yapay zeka yanlışlıkla para harcayabilir mi?

Sipariş oluşturmak ücretsiz taslak üretir; gönderiyi kesinleştiren tek adım kargo kodu üretimidir. Asistan bu adım öncesinde onayınızı ister, sunucu tarafı korumalar da aynı sipariş için mükerrer kod üretimini engeller.

Verilerime kimler erişebilir?

Bağlantı yalnızca sizin hesabınızın verisine, sizin sorularınız üzerine erişir. İzni panelden anahtarı silerek istediğiniz an iptal edebilirsiniz.

API'den farkı ne?

REST API kendi yazılımınızı entegre etmeniz içindir; MCP ise hazır yapay zeka asistanlarını kod yazmadan hesabınıza bağlar. İkisi aynı altyapıyı ve aynı API anahtarlarını kullanır.