> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Portal'in Model Context Protocol (MCP) ile Kullanımı

> API Portal, Model Context Protocol (MCP) standardını kullanarak çeşitli API yönetimi işlevlerini sağlayan araçlar sunar. Bu araç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 kapsayan tam API yaşam döngüsü desteği sağlar, hem HTTP hem de WebSocket bağlantıları üzerinden çalışabilir ve geliştiriciler için API entegrasyonu, test etme ve debugging işlemlerini optimize eder.

## 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.

<CardGroup cols={2}>
  <Card title="Tam API Yaşam Döngüsü Desteği" icon="circle-nodes">
    API keşfinden deployment ve monitoring'e kadar tüm süreçleri kapsar
  </Card>

  <Card title="Çift Protokol Desteği" icon="network-wired">
    Hem HTTP hem de WebSocket bağlantıları üzerinden çalışabilir
  </Card>

  <Card title="Geliştiriciler İçin Optimize" icon="code">
    API entegrasyonu, test etme ve debugging için optimize edilmiş araçlar
  </Card>

  <Card title="Güvenli Kimlik Doğrulama" icon="shield">
    Bearer token tabanlı güvenli erişim kontrolü
  </Card>

  <Card title="Gerçek Zamanlı Analytics" icon="chart-line">
    API kullanımı, performans ve trafik analizi
  </Card>

  <Card title="Otomatik Token Yönetimi" icon="key">
    JWT ve OAuth2 protokolleri için otomatik token alma
  </Card>
</CardGroup>

## Hedef Kullanıcılar

<CardGroup cols={2}>
  <Card title="API Geliştiricileri" icon="user-gear">
    API entegrasyonu ve test işlemleri için
  </Card>

  <Card title="DevOps Ekipleri" icon="server">
    API monitoring ve performans analizi için
  </Card>

  <Card title="Proje Yöneticileri" icon="chart-bar">
    API kullanım istatistikleri ve raporları için
  </Card>

  <Card title="QA Ekipleri" icon="flask">
    API test senaryoları ve doğrulama işlemleri için
  </Card>
</CardGroup>

## 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)

<Info>
  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.
</Info>

## API Yönetimi ve Keşif

<CardGroup cols={2}>
  <Card title="search_apis" icon="magnifying-glass">
    Portal'daki API'ları arama ve filtreleme. İsim, kategori, etiket gibi kriterlere göre arama yapabilir
  </Card>

  <Card title="get_api_details" icon="info">
    Belirli bir API'nin detaylı bilgilerini alma. API metadata'sı, endpoint'ler, kategori adları ve dokümantasyon
  </Card>

  <Card title="get_api_spec" icon="file-code">
    API'nin OpenAPI (Swagger) spesifikasyonunu alma. Tüm endpoint'ler, şemalar ve örnekler
  </Card>

  <Card title="get_api_access_url" icon="link">
    API'nin tam erişim URL'sini alma. Test işlemleri için base URL
  </Card>

  <Card title="get_api_auth_info" icon="key">
    API'nin kimlik doğrulama bilgilerini alma. JWT/OAuth2 server adresleri ve client bilgileri
  </Card>

  <Card title="get_api_plans" icon="tags">
    API'nin mevcut planlarını listeleme. FREE, SUBSCRIPTION, METERED ve TIERED plan detayları
  </Card>

  <Card title="get_api_applications" icon="layer-group">
    Belirli bir API'ye kayıtlı uygulamaları listeleme
  </Card>

  <Card title="get_categories" icon="folder">
    Portal'daki tüm API kategorilerini listeleme. Kategori ID ve adlarını döndürür
  </Card>
</CardGroup>

## Uygulama Yönetimi

<CardGroup cols={2}>
  <Card title="search_apps" icon="magnifying-glass">
    Kullanıcının sahip olduğu uygulamaları listeleme ve arama
  </Card>

  <Card title="create_app" icon="plus">
    Yeni uygulama oluşturma ve otomatik API anahtarı oluşturma. API aboneliklerini gruplamak için kullanılır
  </Card>

  <Card title="get_app_details" icon="info">
    Belirli bir uygulamanın detaylı bilgilerini alma
  </Card>

  <Card title="get_app_apis" icon="layer-group">
    Uygulamaya kayıtlı API'ları listeleme
  </Card>

  <Card title="get_app_registrations" icon="list">
    Uygulamanın tüm API kayıtlarını listeleme
  </Card>

  <Card title="delete_app" icon="trash">
    Uygulamayı silme (tüm kayıtlar ve credentials da silinir)
  </Card>

  <Card title="get_available_apis_for_app" icon="check">
    Uygulama için kullanılabilir API'ları listeleme
  </Card>
</CardGroup>

## API Kaydı ve Abonelik

<CardGroup cols={2}>
  <Card title="register_api_to_application" icon="link">
    Uygulamayı bir API'ye kaydetme ve plan seçimi yapma
  </Card>
</CardGroup>

## Kimlik Bilgileri (Credentials) Yönetimi

<CardGroup cols={2}>
  <Card title="get_app_credentials" icon="key">
    Uygulamanın tüm API anahtarlarını listeleme (username/password değerleri dahil)
  </Card>

  <Card title="add_api_key" icon="plus">
    Uygulamaya yeni API anahtarı ekleme
  </Card>

  <Card title="get_credential_details" icon="info">
    Belirli bir credential'ın detaylı bilgilerini alma (gerçek değerler dahil)
  </Card>

  <Card title="delete_credential" icon="trash">
    API anahtarını silme ve iptal etme
  </Card>
</CardGroup>

## Token ve Kimlik Doğrulama

<CardGroup cols={2}>
  <Card title="get_token" icon="key">
    JWT/OAuth2 access token alma. Otomatik veya manuel mod destekler
  </Card>
</CardGroup>

## API Test Etme

<CardGroup cols={2}>
  <Card title="test_api" icon="flask">
    API endpoint'lerini test etme. HTTP istekleri gönderme ve yanıtları alma
  </Card>
</CardGroup>

## Analitik ve İstatistikler

<CardGroup cols={2}>
  <Card title="get_api_traffic" icon="chart-line">
    API trafik analitik verilerini alma. Hacim, pattern ve kullanım trendleri
  </Card>

  <Card title="get_api_response_time" icon="clock">
    API yanıt süresi analitikleri. Latency trendleri ve performans istatistikleri
  </Card>

  <Card title="get_api_stats" icon="chart-bar">
    Genel API istatistikleri. İstek sayısı, hata oranları, kullanım kalıpları
  </Card>

  <Card title="query_api_traffic" icon="magnifying-glass">
    Detaylı trafik sorguları. Karmaşık filtreleme, sıralama ve toplama özellikleri
  </Card>
</CardGroup>

## Yardımcı Araçlar

<CardGroup cols={2}>
  <Card title="hello" icon="hand-wave">
    Apinizer API Portal'dan karşılama mesajı alma (bağlantı testi)
  </Card>
</CardGroup>

## Önemli Notlar

<Note>
  **Kimlik Doğrulama**: Tüm araçlar `APINIZER-TOKEN` header'ı gerektirir
</Note>

<Note>
  **İki Protokol**: Hem HTTP hem de WebSocket protokolleri desteklenir
</Note>

<Note>
  **Test İşlemleri**: API test etmek için önce `get_api_access_url` ile base URL alın, sonra endpoint'i ekleyin
</Note>

<Warning>
  **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.
</Warning>

<Note>
  **Yetkilendirme**: Uygulama sahipleri sadece kendi uygulamalarına erişebilir
</Note>