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.

Özellikler

Tam API Yaşam Döngüsü Desteği: API keşfinden deployment ve monitoring'e kadar tüm süreçleri kapsar
Çift Protokol Desteği: Hem HTTP hem de WebSocket bağlantıları üzerinden çalışabilir
Geliştiriciler İçin Tasarlanmış: API entegrasyonu, test etme ve debugging için optimize edilmiş araçlar
Güvenli Kimlik Doğrulama: Bearer token tabanlı güvenli erişim kontrolü
Gerçek Zamanlı Analytics: API kullanımı, performans ve trafik analizi
Otomatik Token Yönetimi: JWT ve OAuth2 protokolleri için otomatik token alma

Hedef Kullanıcılar

API Geliştiricileri: API entegrasyonu ve test işlemleri için
DevOps Ekipleri: API monitoring ve performans analizi için
Proje Yöneticileri: API kullanım istatistikleri ve raporları için
QA Ekipleri: 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)

Konuyla ilgili makelemize aşağıdaki linkten erişebilirsiniz:

API’ların AI ile Konuştuğu Gelecek: Apinizer API Portal MCP Entegrasyonu

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
Claude Desktop gibi özel MCP client'ları gerektirir

MCP endpoint'lerini test etmek için Claude Desktop veya uyumlu MCP client kullanın.

API Yönetimi ve Keşif

Araç Adı	Ne İşe Yarar
`search_apis`	Portal'daki API'ları arama ve filtreleme. İsim, kategori, etiket gibi kriterlere göre arama yapabilir
`get_api_details`	Belirli bir API'nin detaylı bilgilerini alma. API metadata'sı, endpoint'ler ve dokümantasyon
`get_api_spec`	API'nin OpenAPI (Swagger) spesifikasyonunu alma. Tüm endpoint'ler, şemalar ve örnekler
`get_api_access_url`	API'nin tam erişim URL'sini alma. Test işlemleri için base URL
`get_api_auth_info`	API'nin kimlik doğrulama bilgilerini alma. JWT/OAuth2 server adresleri ve client bilgileri
`get_api_plans`	API'nin mevcut planlarını listeleme. FREE, SUBSCRIPTION, METERED ve TIERED plan detayları
`get_api_applications`	Belirli bir API'ye kayıtlı uygulamaları listeleme

Uygulama Yönetimi

Araç Adı	Ne İşe Yarar
`search_apps`	Kullanıcının sahip olduğu uygulamaları listeleme ve arama
`create_app`	Yeni uygulama oluşturma. API aboneliklerini gruplamak için kullanılır
`get_app_details`	Belirli bir uygulamanın detaylı bilgilerini alma
`get_app_apis`	Uygulamaya kayıtlı API'ları listeleme
`get_app_registrations`	Uygulamanın tüm API kayıtlarını listeleme
`delete_app`	Uygulamayı silme (tüm kayıtlar ve credentials da silinir)
`get_available_apis_for_app`	Uygulama için kullanılabilir API'ları listeleme

API Kaydı ve Abonelik

Araç Adı	Ne İşe Yarar
`register_api_to_application`	Uygulamayı bir API'ye kaydetme ve plan seçimi yapma

Kimlik Bilgileri (Credentials) Yönetimi

Araç Adı	Ne İşe Yarar
`get_app_credentials`	Uygulamanın tüm API anahtarlarını listeleme (username/password değerleri dahil)
`add_api_key`	Uygulamaya yeni API anahtarı ekleme
`get_credential_details`	Belirli bir credential'ın detaylı bilgilerini alma (gerçek değerler dahil)
`delete_credential`	API anahtarını silme ve iptal etme

Token ve Kimlik Doğrulama

Araç Adı	Ne İşe Yarar
`get_token`	JWT/OAuth2 access token alma. Otomatik veya manuel mod destekler

API Test Etme

Araç Adı	Ne İşe Yarar
`test_api`	API endpoint'lerini test etme. HTTP istekleri gönderme ve yanıtları alma

Analitik ve İstatistikler

Araç Adı	Ne İşe Yarar
`get_api_traffic`	API trafik analitik verilerini alma. Hacim, pattern ve kullanım trendleri
`get_api_response_time`	API yanıt süresi analitikleri. Latency trendleri ve performans istatistikleri
`get_api_stats`	Genel API istatistikleri. İstek sayısı, hata oranları, kullanım kalıpları
`query_api_traffic`	Detaylı trafik sorguları. Karmaşık filtreleme, sıralama ve toplama özellikleri

Yardımcı Araçlar

Araç Adı	Ne İşe Yarar
`hello`	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
Yetkilendirme: Uygulama sahipleri sadece kendi uygulamalarına erişebilir