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.
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:
https://mcp.basitkargo.com/mcp
Bağlantı Yöntemleri
İki yöntemden istemcinize uygun olanı kullanın:
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.
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.
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.
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):
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:
{
"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:
{
"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 32 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 |
list_shipments | Gönderi Listesi | Gönderileri durum ve tarih 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 | 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_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 |
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 |
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 |
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
| 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 |
| "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.