Ana içeriğe atla
Geliştirici ve Yapay Zeka BelgeleriCanlı · sunucu v1.0.0

Yapay Zeka Asistanınızı Bağlayın

Claude, ChatGPT veya başka bir MCP istemcisini müşteri portalınıza bağlayın. Asistan projelerinizi, faturalarınızı, destek taleplerinizi, site durumunuzu ve dosyalarınızı okuyabilir. Pro ve Ultra planlarında ayrıca talep açabilir veya değişiklik istekleri gönderebilir, ancak yalnızca tam önizlemeyi onayladıktan sonra.

Araçlar ve Limitler

Her plan kendi sınırlarını belirler. Sunucu anahtar sayısını, anahtar başına dakikadaki istek sayısını ve tüm hesap için aylık birimleri uygular.

Basic

Ücretsiz

Yalnızca okuma. Bu planda yazma yok

AnahtarlarHesap başına etkin anahtar: en fazla 1
HızAnahtar başına dakikada 30 istek
KotaHesap başına ayda 1,000 birim

Projeleri, faturaları, destek taleplerini, site durumunu, proje dosyalarını ve aylık raporu görüntüleyin.

Pro

Aylık 3,000,000 Toman

Okuma ve onaylı yazma

AnahtarlarHesap başına etkin anahtar: en fazla 3
HızAnahtar başına dakikada 60 istek
KotaHesap başına ayda 5,000 birim

Tüm okuma araçları ve onaylı yazma: destek taleplerini açma ve yanıtlama, değişiklik istekleri ile Farr mesajları gönderme, dosya yükleme, içerik taslakları oluşturma ve güncelleme, teklifleri kabul etme veya reddetme. Her yazma işlemi önce önizlenir ve yalnızca siz onayladıktan sonra uygulanır.

Ultra

Aylık 5,000,000 Toman

Pro'daki her şey, ayrıca toplu işlemler ve webhook'lar

AnahtarlarHesap başına etkin anahtar: en fazla 10
HızAnahtar başına dakikada 120 istek
KotaHesap başına ayda 20,000 birim

Pro'daki her şey, ayrıca talepler üzerinde toplu işlemler (bulk_ticket_reply, bulk_ticket_close ve bulk_actions, çağrı başına en fazla 20 talep), webhook'lar (webhook_list, webhook_create ve webhook_delete) ve zamanlanmış aylık raporlar (scheduled_reports ve scheduled_reports_get).

Güvenlik: Ödeme veya Mülkiyet İşlemi Yok

Asistan API'sinde fatura ödeme, para transferi yapma, hesap sahipliğini değiştirme veya anahtar yönetimi araçları bulunmaz. Faturalar salt okunurdur. Ödemelerinizi doğrudan müşteri portalından kendiniz yaparsınız.

Asistan Anahtarı Nasıl Oluşturulur?

Müşteri portalında üç adımda bir anahtar oluşturun.

1. Portala Giriş Yapın

Müşteri portalına giriş yapın ve menüden Asistan erişimi bölümünü açın.

2. Anahtar Oluşturun

"Anahtar oluştur" seçeneğine tıklayın. 3 ila 60 karakterlik bir isim girin (örneğin "Claude Code - dizüstü"), yetkileri ve geçerlilik süresini seçin. Güvenlik nedeniyle tekrar oturum açmanız istenecektir.

3. Anahtarı Hemen Kopyalayın

Anahtarın tamamı yalnızca bir kez, oluşturulduktan hemen sonra gösterilir. Sunucu yalnızca gizli kısmın SHA-256 özetini saklar. Kaybederseniz anahtarı iptal edip yenisini oluşturun.

Claude ve ChatGPT Nasıl Bağlanır?

MCP Streamable HTTP protokolü üzerinden, Bearer anahtarı kullanarak veya OAuth ile giriş yaparak bağlanın.

Claude Code ve Diğer MCP İstemcileri

Sunucu URL'si ve başlık kabul eden araçlarda (örneğin Claude Code'un .mcp.json dosyasında), bu kaydı ekleyin ve yer tutucuyu anahtarınızla değiştirin:

{
  "mcpServers": {
    "sajjad-portal": {
      "type": "http",
      "url": "https://sajjad.blog/api/client/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_AGENT_KEY>"
      }
    }
  }
}

ChatGPT ve Web Asistanları

Bu adresi özel bağlayıcı olarak ekleyin ve istendiğinde giriş yapın (OAuth). Bu yöntemde anahtar gerekmez. Menü isimleri asistana göre değişiklik gösterebilir.

MCP Sunucu URL'si
https://sajjad.blog/api/client/mcp
Yetkilendirme Başlığı (anahtar tabanlı istemciler)
Bearer <ASISTAN_ANAHTARINIZ>
Two-Step Write Architecture

Yazma İşlemlerinde "Önizleme ve Onay" Ne Anlama Gelir?

Bir değişiklik ilk çağrıda asla doğrudan uygulanmaz.

Bir asistan yazma aracını çağırdığında sunucu isteği kaydeder ve 10 dakika geçerli tek kullanımlık bir onay belirteciyle önizleme döndürür. Değişiklik, yalnızca asistan bu belirteçle onay aracını çağırdığında ve sizin onayınızın ardından uygulanır. Her belirteç yalnızca bir kez, oluşturan anahtar ve hesap için geçerlidir. Hazırlanan tüm işlemler kayıt altına alınır.

Step 1
1. Asistan değişikliği taslak olarak hazırlar
Step 2
2. Önizlemeyi inceler ve onaylarsınız
Step 3
3. Sunucu belirteci doğrular ve sonucu kaydeder

Doğrulanmış Araçlar Referansı

İstemci uç noktasının sunduğu başlıca araçlar ile önizlemeden sonra kullanılan onay aracı. Planınızın dışındaki bir araç plan_required mesajıyla reddedilir.

Araç AdıErişim TürüYetenek Açıklaması
projects_listOkuma50 adede kadar projenizi listeleyin: kod, isim, durum, ilerleme ve bitiş tarihi.
invoices_listOkuma25 adede kadar faturayı vade tarihi, toplam, ödenen tutar, bakiye ve durumla listeleyin. Yalnızca ödenmemişleri görmek için openOnly kullanın. Taslaklar ve ödeme bağlantıları hariçtir.
tickets_listOkumaDurum, öncelik ve son yanıt zamanıyla birlikte 50 adede kadar destek talebinizi listeleyin.
ticket_getOkumaBir destek talebinin mesaj geçmişini alın (100 mesaja kadar). Dahili notlar hariç tutulur.
ticket_createOnaylı YazmaDüşük veya normal öncelikli yeni bir destek talebi hazırlayın. Yalnızca önizleme onaylandıktan sonra oluşturulur.
ticket_replyOnaylı YazmaAçık bir talebe yanıt hazırlayın. Kapatılmış taleplere yanıt verilemez. Yalnızca onaylandıktan sonra gönderilir.
change_request_createOnaylı YazmaProjelerinizden biri için değişiklik isteği hazırlayın. Yalnızca önizleme onaylandıktan sonra uygulanır.
site_statusOkumaBağlı sitenin alan adı durumunu, ziyaretçi ve sayfa görüntülemelerini (24 saat ve 7 gün), çalışma süresi yüzdesini ve çözülmemiş hata sayısını gösterir. Veriler son telemetri eşitlemesinden alınır.
files_listOkumaProje depolama alanınızdaki dosyaları sayfa başına 100 adede kadar listeleyin; isteğe bağlı olarak bir klasör altında.
file_linkOkumaDepolanan bir dosya için indirme bağlantısı oluşturun. Bağlantı 15 dakika sonra sona erer.
report_monthlyOkumaAylık özeti alın (12 aya kadar geriye dönük): projeler, açılan ve kapatılan talepler, mevcut web sitesi anlık görüntüsü, vadesi gelen faturalar ve 15 dakika geçerli PDF bağlantısı.

Sıkça Sorulan Sorular

Müşteri asistanları, güvenlik ve kullanım sınırları hakkında sık sorulan sorular.

Yapay zeka asistanım faturaları otomatik olarak ödeyebilir mi?

Hayır. Asistan API'sinde fatura ödeme veya para transferi aracı yoktur. Faturalar yalnızca incelenebilir; ödemeyi müşteri portalından kendiniz yaparsınız.

Aylık birim kotamı aştığımda ne olur?

Her planın tüm hesap için aylık bir birim bütçesi vardır. Okuma 1 birim, yazma önizlemesi 3 birim harcar. Hesabın ay içindeki kullanımı planın bütçesine ulaştığında, sonraki çağrılar UTC takvim ayı değişene kadar araç sonucunda bir quota_exceeded hatası döndürür (HTTP 429 değil, HTTP 200).

Güvenliği ihlal edilen bir asistan anahtarını nasıl iptal edebilirim?

Müşteri portalında Asistan erişimi bölümüne gidin, Anahtarı İptal Et seçeneğini belirleyin ve onaylayın. Bu anahtarla yapılacak tüm sonraki istekler anında reddedilir. OAuth ile bağlı asistanların bağlantısı da aynı sayfadan kesilebilir.

ChatGPT'yi bağlamak için yerel bir köprü çalıştırmam gerekir mi?

Hayır. Uç nokta standart bir HTTPS adresidir: İstemci POST ile JSON-RPC iletileri gönderir ve JSON yanıtı alır. Bulut tabanlı asistanlar yerel yazılıma gerek duymadan doğrudan bağlanır.

Asistanınızı Çalıştırmaya Hazır mısınız?

Başlamak için bir plan seçin veya müşteri portalınızı açarak bir asistan anahtarı oluşturun.