API Portal'in Model Context Protocol (MCP) ile Kullanımı
Genel Bakış
API Portal projesi, Model Context Protocol (MCP) standardını kullanarak çeşitli API yönetimi işlevlerini sağlayan tool'lar içerir. Bu tool'lar, API Portal Management API'sinin MCP üzerinden erişilebilir hale getirilmiş versiyonlarıdır.
API keşfinden deployment ve monitoring'e kadar tüm süreçleri kapsar
Hem HTTP hem de WebSocket bağlantıları üzerinden çalışabilir
API entegrasyonu, test etme ve debugging için optimize edilmiş araçlar
Bearer token tabanlı güvenli erişim kontrolü
API kullanımı, performans ve trafik analizi
JWT ve OAuth2 protokolleri için otomatik token alma
Hedef Kullanıcılar
API entegrasyonu ve test işlemleri için
API monitoring ve performans analizi için
API kullanım istatistikleri ve raporları için
API test senaryoları ve doğrulama işlemleri için
Teknik Gereksinimler
- Geçerli Apinizer Portal hesabı
- APINIZER-TOKEN authentication header'ı
- MCP compatible client (Claude, VS Code extensions, vb.)
- İnternet bağlantısı (API Portal erişimi için)
MCP (Model Context Protocol), JSON-RPC 2.0 protokolünü kullanarak client-server iletişimi sağlar. Bu protokol HTTP REST API'den farklı olarak persistent bağlantılar üzerinden çift yönlü mesajlaşma imkanı sunar, doğrudan curl/Postman gibi araçlarla test edilemez ve Claude Desktop gibi özel MCP client'ları gerektirir.
API Yönetimi ve Keşif
Portal'daki API'ları arama ve filtreleme. İsim, kategori, etiket gibi kriterlere göre arama yapabilir
Belirli bir API'nin detaylı bilgilerini alma. API metadata'sı, endpoint'ler, kategori adları ve dokümantasyon
API'nin OpenAPI (Swagger) spesifikasyonunu alma. Tüm endpoint'ler, şemalar ve örnekler
API'nin tam erişim URL'sini alma. Test işlemleri için base URL
API'nin kimlik doğrulama bilgilerini alma. JWT/OAuth2 server adresleri ve client bilgileri
API'nin mevcut planlarını listeleme. FREE, SUBSCRIPTION, METERED ve TIERED plan detayları
Belirli bir API'ye kayıtlı uygulamaları listeleme
Portal'daki tüm API kategorilerini listeleme. Kategori ID ve adlarını döndürür
Uygulama Yönetimi
Kullanıcının sahip olduğu uygulamaları listeleme ve arama
Yeni uygulama oluşturma ve otomatik API anahtarı oluşturma. API aboneliklerini gruplamak için kullanılır
Belirli bir uygulamanın detaylı bilgilerini alma
Uygulamaya kayıtlı API'ları listeleme
Uygulamanın tüm API kayıtlarını listeleme
Uygulamayı silme (tüm kayıtlar ve credentials da silinir)
Uygulama için kullanılabilir API'ları listeleme
API Kaydı ve Abonelik
Uygulamayı bir API'ye kaydetme ve plan seçimi yapma
Kimlik Bilgileri (Credentials) Yönetimi
Uygulamanın tüm API anahtarlarını listeleme (username/password değerleri dahil)
Uygulamaya yeni API anahtarı ekleme
Belirli bir credential'ın detaylı bilgilerini alma (gerçek değerler dahil)
API anahtarını silme ve iptal etme
Token ve Kimlik Doğrulama
JWT/OAuth2 access token alma. Otomatik veya manuel mod destekler
API Test Etme
API endpoint'lerini test etme. HTTP istekleri gönderme ve yanıtları alma
Analitik ve İstatistikler
API trafik analitik verilerini alma. Hacim, pattern ve kullanım trendleri
API yanıt süresi analitikleri. Latency trendleri ve performans istatistikleri
Genel API istatistikleri. İstek sayısı, hata oranları, kullanım kalıpları
Detaylı trafik sorguları. Karmaşık filtreleme, sıralama ve toplama özellikleri
Yardımcı Araçlar
Apinizer API Portal'dan karşılama mesajı alma (bağlantı testi)
Önemli Notlar
Kimlik Doğrulama: Tüm araçlar APINIZER-TOKEN header'ı gerektirir
İki Protokol: Hem HTTP hem de WebSocket protokolleri desteklenir
Test İşlemleri: API test etmek için önce get_api_access_url ile base URL alın, sonra endpoint'i ekleyin
Credentials: get_app_credentials ve get_credential_details gerçek API Key/Secret değerlerini döndürür. Bu bilgileri güvenli bir şekilde saklayın.
Yetkilendirme: Uygulama sahipleri sadece kendi uygulamalarına erişebilir