ShipEntegra MCP (Model Context Provider) Entegrasyonu

ShipEntegra MCP (Model Context Provider) Entegrasyonu
Kurulum, Kullanım Kılavuzu ve Uygulama Kapsamı
Lojistik sektörü, dijital dönüşümün etkisiyle her geçen gün daha karmaşık ve hızlı hale geliyor. Günümüzde lojistik operasyonlarının sürdürülebilirliği, farklı platformlar, yazılımlar ve servisler arasında güvenli, esnek ve yüksek performanslı entegrasyonların kurulmasına bağlıdır. Özellikle e-ticaretin büyümesiyle birlikte, sipariş yönetimi, kargo takibi ve fiyat hesaplama gibi işlemlerin entegre sistemlerle yürütülmesi, hem operasyonel verimliliği artırmakta hem de müşteri memnuniyetine doğrudan katkı sağlamaktadır.
ShipEntegra olarak, bu ihtiyaca çözüm sunmak amacıyla geliştirdiğimiz Model Context Provider (MCP) entegrasyon altyapısı sayesinde, dış sistemlerle hızlı, güvenli ve standartlara uygun veri iletişimini mümkün kılıyoruz. Bu belge, ShipEntegra MCP’nin ne işe yaradığını, hangi ihtiyaçlara çözüm sunduğunu, kurulum ve kullanım adımlarını detaylı şekilde açıklamak amacıyla hazırlanmıştır.
-
MCP Nedir?
Model Context Provider (MCP), farklı sistemlerin ortak bir protokol üzerinden iletişim kurmasını sağlayan modern bir entegrasyon katmanıdır. Özellikle mikroservis mimarileri ve API tabanlı çözümlerde, sistemler arası veri alışverişinin standardizasyonu büyük önem taşır. MCP bu noktada devreye girerek, farklı uygulamalar ve platformlar arasında güvenli, hızlı ve tutarlı bir köprü görevi görür.
ShipEntegra MCP, ShipEntegra’nın sunduğu lojistik servisleri; ERP sistemleri, özel yazılımlar veya e-ticaret platformları gibi harici sistemlerle entegre etmek amacıyla geliştirilmiştir. Bu sayede kullanıcılar; sipariş yönetimi, taşıyıcı listesi, kargo takibi ve fiyat hesaplama gibi önemli lojistik işlevleri kendi sistemleri üzerinden doğrudan kullanabilir hale gelirler.
-
Uygulamanın Kapsamı ve Özellikleri
ShipEntegra MCP entegrasyon modülü, geniş kapsamlı ve kullanıcı dostu fonksiyonlar sunar. Temel işlevler aşağıdaki gibidir:
- Taşıyıcı Listeleme: Sistemde kullanıcıya özel olarak tanımlı taşıyıcıların listelenmesini sağlar. Bu sayede gönderi işlemlerinde uygun taşıyıcılar kolayca seçilebilir.
- Sipariş Yönetimi: Mevcut siparişlerin sorgulanması, detaylarının görüntülenmesi ve manuel olarak yeni sipariş oluşturulması işlemleri desteklenir.
- Kargo Takibi: Gönderiye ait tüm hareketlerin ve güncel durum bilgilerinin sistem üzerinden sorgulanmasına olanak tanır.
- Fiyat Hesaplama: Gönderi bilgilerine bağlı olarak, seçilen taşıyıcıya göre anlık kargo fiyat hesaplaması yapılabilir.
- Etiket (Label) Oluşturma: ShipEntegra, FedEx, UPS, USPS ve DHL eCommerce gibi büyük taşıyıcılar için otomatik etiket (label) üretimi sağlar.
- Sipariş Durumu Güncelleme: Siparişlerin durum bilgisi tekil ya da toplu olarak güncellenebilir. Bu özellik, sistemin stok ve sevkiyat süreçleriyle uyumlu çalışmasını sağlar.
Tüm bu özellikler; REST tabanlı, güvenli ve ölçeklenebilir bir API yapısı üzerinden sunulmakta olup, geliştirici dostu bir kullanım deneyimi sağlar.
Kullanıcılar için Entegrasyon ve Kullanım
1. API Key ve Secret Bilgilerinin Alınması
ShipEntegra MCP sistemine erişim sağlayabilmek için kullanıcıların, kendilerine özel oluşturulan API Key ve API Secret bilgilerine sahip olmaları gerekir. Bu bilgiler, kimlik doğrulama ve güvenlik amaçlı kullanılır.
Adımlar:
- https://app.shipentegra.com adresinden kullanıcı girişi yapılır.
- Ana menüden “Entegrasyonlar” sekmesine tıklanır.
- Açılan ekrandan “ShipEntegra for Developers” uygulaması seçilir.
- API Key ve API Secret bilgileri bu alanda görüntülenebilir ve kopyalanabilir.
2. VSCode ile Bağlantı Kurulumu
Visual Studio Code (VSCode) üzerinden MCP API’ye bağlanmak için şu adımları izleyin:
- Bilgisayarınızda en güncel VSCode sürümünün kurulu olduğundan emin olun.
- CTRL + SHIFT + P tuş kombinasyonu ile komut panelini açın.
- Açılan komut paletinden “MCP: Add Server” seçeneğini seçin.
- HTTP bağlantı tipi tercih edilir.
- URL kısmına:
https://mcpserver.shipentegra.com yazılır.
- Oluşan bağlantı tanım dosyasına aşağıdaki gibi bir Authorization Header eklenir:
-
- apikey:apiSecret birleşimi, base64 formatına dönüştürülür.
- Header formatı şu şekilde olmalıdır:
Authorization: Basic <base64-encoded-string>
Daha fazla bilgiye VSCode dokümantasyonundan ulaşabilirsiniz.
3. Claude Aracı ile Bağlantı

Claude gibi modern AI araçlarını kullanarak da MCP API bağlantısı kurulabilir. Adımlar:
- Claude uygulamasının bilgisayarınızda kurulu ve güncel olduğundan emin olun.
- Menüden Files > Settings bölümüne geçin.
- Açılan pencerede Developer sekmesine gidin ve Edit Config seçeneğine tıklayın.
- Yapılandırma dosyası olan claude_desktop_config.json içinde gerekli ayarlamaları yapın:
-
- apikey:apiSecret bilgilerini base64 formatında encode edin.
- Authorization header’ını şu formatta ekleyin:
Authorization: Basic <base64-encoded-string>
-
Öneriler
ShipEntegra MCP, lojistik entegrasyon ihtiyaçlarına modern, güvenli ve ölçeklenebilir bir çözüm sunar. Özellikle birden fazla sistemin bir arada çalıştığı karmaşık yapılar için, iletişim katmanının sade ve standartlara uygun olması büyük avantaj sağlar.
Geliştiriciler, apiKey ve apiSecret bilgileri ile doğrulama sağlayarak kolayca sistemlere entegre olabilirler. Entegrasyon süreci hızlıdır ve genellikle sadece doğru bir header tanımı ile erişim mümkün hale gelir.
ShipEntegra olarak, farklı senaryolara özel entegrasyon çözümleri sunmaktayız. Her türlü teknik destek ihtiyacınızda bizimle iletişime geçebilirsiniz. MCP entegrasyonu ile operasyonel süreçlerinizi daha verimli hale getirebilir, zamandan ve maliyetten tasarruf edebilirsiniz.
