Carrier Lookup MCP ve REST API: Doğru İş Akışını Seçin
Liste boyutuna, inceleme ve denetim ihtiyaçlarına göre etkileşimli bir MCP operatör sorgusu, eşzamanlı REST isteği veya eşzamansız dosya görevi seçin.
Bir yapay zeka asistanı içindeki gözden geçirilmiş sorgular için MCP'yi, tekrarlanabilir uygulama çağrıları için REST'i ve büyük hazır listeler için REST veya kontrol paneli dosya görevlerini kullanın.
Bir kişi bir yapay zeka asistanında az sayıda telefon numarasını inceliyorsa ve her sorguyu onaylayabiliyorsa CarrierLookup MCP'yi kullanın. Belgelenmiş araçları; ürünleri listeler, bir numarayı veya 1–100 numarayı eşzamanlı olarak sorgular ve bakiyeyi okur. Uygulama kodunun tekrarlanabilir ve eşzamanlı bir istek yapması gerektiğinde REST API'yi kullanın. Eşzamansız işleme gerektiren hazır bir dosya için REST toplu işlem görevini veya kontrol panelini kullanın; MCP herhangi bir dosya görevi aracı sunmaz. Seçim, yetkilendirme ve incelemeyi etkilerken, sonuç mevcut ağ veya erişilebilirlik kanıtı değil, orijinal tahsis verisi olarak kalır.
Görevi belgelenmiş arayüzle eşleştirin
CarrierLookup MCP documentation dört aracı tanımlar: ürün listeleme, check_number, check_numbers ve get_balance. Sorgu araçları oturum içinde yanıt verir. check_numbers 1–100 arası numarayı kabul eder ve giriş sırasını korur. Dosya yüklemez veya arka plan görevi oluşturmaz.
| Ekip görevi | Arayüz | Neden uygundur |
|---|---|---|
| Analist bir kaydı incelerken bir numarayı sorgular | MCP check_number, insan onayı ile |
Soru ve sonuç, analistin inceleme akışında kalır. |
| Analist 1–100 numaradan oluşan kısa ve onaylı bir seti karşılaştırır | MCP check_numbers |
Tek bir eşzamanlı istek giriş sırasını korur; her sonucu ayrı ayrı inceleyin. |
| Arka uç, kontrollü bir iş aracılığıyla kayıtları zenginleştirir | REST POST /api/v1/check veya POST /api/v1/batch-check |
Kod; giriş doğrulama, yeniden deneme, günlük kaydı ve sonuç eşlemeden sorumludur. |
| Ekip, hazır bir CSV veya TXT listesini işler | REST POST /api/v1/bulk-tasks ve GET /api/v1/bulk-tasks/{id} veya kontrol paneli dosya görevi |
Daha sonra sonuç CSV'si alınan eşzamansız bir dosya iş akışıdır. |
REST eşzamanlı çoklu sorgu da 1–100 numarayı işler; çalışmayı bir incelemecinin mi yoksa uygulamanın mı denetlediğine göre seçim yapın. Dosya görevleri için, MCP çoklu aracını bir toplu yükleyici olarak kullanmak yerine API reference belgesini ve mevcut ürün limitlerini takip edin.
Onayı tekrarlanabilir yürütmeden ayırın
Etkileşimli bir sorgu için, asistan bir aracı çağırmadan önce insan incelemeciden amaçlanan numaraları, amacı ve hizmeti onaylamasını isteyin. Asistanın erişebileceği araçları ve erişim yetkisini, incelemecinin gerçekten yetkilendirdiği işlerle sınırlayın. Bunlar yerleşik MCP garantileri değil, ekip kontrolleridir. İncelemeciyi, giriş seti referansını, talep edilen hizmeti, zamanı ve araç çağrısını, tam telefon numaralarını geniş günlüklerde tutmadan kendi iş akışınızda kaydedin.
Arka uç işi için, kod REST'i çağırmadan önce giriş kaynağını ve izin verilen kullanımı tanımlayın. Gerçek zamanlı sorgular için numaraları belgelenmiş E.164 biçimine normalleştirin. Bir iş tanımlayıcısı, giriş sürümü, istek zamanı, uç nokta, yanıt sonucu ve kaynak kayıtlara geri dönen korumalı bir eşleme tutun. Eşzamanlı bir zaman aşımı veya dolu bir yuva, tamamlanmış bir operatör sonucu değildir; bunu operasyonel bir dal olarak ele alın. Bu ayrım, yeniden çalıştırmaları açıklanabilir kılar ve konuşmaya dayalı bir isteğin kontrolsüz, tekrarlayan bir toplu işleme dönüşmesini engeller.
Bir dosya işinin başka bir inceleme noktası vardır. Tek sütunlu TXT veya CSV dosyasını hazırlayın, belgelenmiş toplu iş akışında hedeflenen ülkeyi seçin, gönderin, ardından görev durumunu kontrol edin ve başarıdan sonra sonuç CSV'sini indirin. Kayıtları değiştirmeden önce ön işleme sayılarını inceleyin ve döndürülen satırları hazırlanan girişle karşılaştırın. Kontrol paneli operatörlere, REST ise tekrarlanabilir uygulama işlerine uygundur.
Kimlik bilgilerini doğru yerde tutun
İki yüzey aynı hesap anahtarını ve bakiyeyi kullanır ancak anahtarı farklı şekilde gönderir. MCP rehberi, güvenilir bir MCP istemci yapılandırmasında Authorization: Bearer kullanımını belirtir. REST referansı ise sunucu tarafındaki API çağrılarında X-API-Key kullanımını belirtir. Kimlik bilgilerinin hiçbiri asistan isteminde, paylaşılan bir transkriptte, tarayıcı tarafındaki kaynak kodunda, örnek sonuçta veya tanılama günlüğünde yer almamalıdır. Yapılandırmayı koruyun ve operatör erişimini kısıtlayın.
Planlanan bir çalıştırmadan önce belgelenmiş bakiye aracı veya REST bakiye uç noktası aracılığıyla bakiyeyi kontrol edin, ardından çalışma sonrasında hesap kayıtlarını karşılaştırın. Her iki arayüz de tek bir bakiyeden harcama yapar; MCP'den REST'e geçmek ayrı bir bütçe oluşturmaz. Toplu bir dosya için, geçici bir rezervasyon ile nihai ücreti ve cüzdana iade edilen kullanılmamış rezervi ayırt edin. Her ücretin arkasındaki çalıştırmayı günlüğe kaydedin; iade edilen bir rezerv, satın alma iadesi değildir.
Yanıtı dar bir kapsamda yorumlayın ve saklayın
CarrierLookup'ın carrier alanı, numara aralığının orijinal olarak tahsis edildiği operatörü belirtir. Numara taşıma işlemi, bunu mevcut hizmet ağından farklı kılabilir. underlying_carrier mevcut olduğunda ayrı bir sonuç alanıdır; orijinal operatör yanıtını sessizce bununla değiştirmeyin. region ve city alanları, kişinin veya cihazın şu an nerede olduğunu değil, numara tahsis coğrafyasını tanımlar. Bu alanların hiçbiri erişilebilirlik, aktif hizmet, sahiplik, kimlik veya onay durumunu belirlemez.
Her sonuç için giriş referansını, arayüzü, hizmet türünü, sorgu zamanını, yanıt durumunu ve döndürülen alanları koruyun. Boş alanları bir operatör uydurmak yerine kullanılamaz olarak işaretleyin. Tamamlanmış bir code=0 sorgusu, boş operatör alanlarına sahip olabilir ve yine de tamamlanmış bir sorgu olarak sayılır. Eşzamanlı çoklu sonuçlarda exists=false, o satır için normal bir sonuç olmadığı anlamına gelir; bu, numaranın geçersiz veya bağlantısı kesilmiş olduğunu kanıtlamaz. Reddedilen bir biçim veya belirlenemedi yanıtı, farklı bir sonuç kategorisine aittir.
Mevcut ağ, teslimat veya bir numaranın kontrolü için farklı kanıtlar elde edin. Tahsis bağlamı için, MCP araç rehberini kullanarak insan tarafından incelenmiş bir örnekle başlayın, ardından tekrarlayan bir listeyi açık bir iş günlüğü ve sonuç incelemesi ile belgelenmiş REST veya dosya görevi rotasına taşıyın.
Daha fazla bilgi edinin
İş akışınızın bir sonraki adımına uygun ürün bilgilerini seçin.