Bynn Intelligence

resmi

Belge Sahteciliği Tespiti (görsel, PDF)

Bynn Intelligence MCP ile neler yapabilirsiniz?

AI ile üretilmiş görselleri tespit edin — Asistanınızdan bir görselin AI ile üretilip üretilmediğini kontrol etmesini isteyin; detect_ai_generated_image ile sonuç, olasılık ve olası üretici döndürülür.
Belge sahtekarlık analizi çalıştırın — Adli sahtekarlık analizi için bir banka hesap özeti veya fatura gönderin ve risk değerlendirmesi tamamlanana kadar get_document sorgulayın.
KYC doğrulama oturumları oluşturun — Barındırılan bağlantılarla kimlik doğrulama oturumları oluşturun ve get_session_preflight ile get_session üzerinden ilerlemeyi takip edin.
Fotoğraflardan yaş tahmini yapın — Bir selfie veya görselden kişinin yaşını doğrulayın; verify_age_from_selfie ile canlılık kontrolleri ve yasal yaş eşikleri için seçenekler sunulur.
Koleksiyonlarda yüz arayın — Yüzleri koleksiyonlara kaydedin ve eşleşme bulmak için search_faces ile bir örnek görsel kullanarak arama yapın.
AutoDoc iş akışlarını yönetin — Belge koleksiyonu iş akışlarını, dosyaları ve insan onaylı süreçleri oluşturun, çoğaltın ve izleyin.

Dokümantasyon

Bynn MCP

MCP uyumlu herhangi bir yapay zeka istemcisini Bynn'e bağlayın: kimlik doğrulama (KYC), belge sahteciliği tespiti, yaş doğrulama, içerik denetimi, yüz araması, AutoDoc iş akışları, dolandırıcılık muhakeme ajanları ve hesap yönetimi. Bynn API'si üzerinden 143 araç, tek bağlantı. Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf ve Zed'de çalışır.

https://mcp.bynn.com

Uç nokta kök yoldur. /mcp eklemeyin; https://mcp.bynn.com/mcp çalışmaz. Diğer tek yol GET /health'dir.

Hızlı başlangıç (30 saniye)

Claude Code:

claude mcp add --transport http bynn https://mcp.bynn.com

Claude veya ChatGPT (barındırılan): https://mcp.bynn.com özel bağlayıcı olarak ekleyin ve tarayıcı açıldığında Bynn hesabınızla oturum açın. Anahtar yönetimi gerekmez.

API tarzı istemciler: dashboard.bynn.com/authenticate adresinden bir token alın ve bağlantıda Authorization: Bearer <token> olarak gönderin.

Ardından ilk komutunuzu deneyin:

Check whether this image is AI-generated.

Bir görsel ekleyin; sonuç, karar, yapay zeka olasılığı ve en olası üretici ile etkileşimli bir kart olarak işlenir.

Örnek komutlar

Dolandırıcılık ve belgeler

Submit this bank statement for fraud analysis and summarize the risk when it finishes.
Is this invoice manipulated? Show me the forensic findings.
Run my passport-fraud orchestrator against the latest analyzed document.

Doğrulama

Create a KYC verification session for this applicant and give me the hosted link.
Estimate the age of the person in this photo and tell me if they look under 25.
Create an age verification session with liveness for user 8841.

Denetim ve medya

Check whether this image is AI-generated.
Which moderation models can I run on video?
Search this face against my employees collection.

Hesap ve işlemler

List my API keys and when they were last used.
Rotate my live private key but keep the grace period.
Show this month's usage and my latest invoices.

Belge sahteciliği ve yapay zeka görseli sonuçları hem ChatGPT hem de Claude'da etkileşimli kartlar olarak işlenir (bkz. Etkileşimli widget'lar).

Kurulum

Claude Code

claude mcp add --transport http bynn https://mcp.bynn.com

Claude Desktop ve claude.ai

Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → URL https://mcp.bynn.com. OAuth oturum açma ilk kullanımda otomatik başlar.

ChatGPT

Ayarlar → Uygulamalar ve Bağlayıcılar → geliştirici modunu etkinleştir → Oluştur → MCP sunucu URL'si https://mcp.bynn.com. Bynn, bir ChatGPT uygulaması olarak oluşturulmuştur: dolandırıcılık raporları ve yapay zeka görseli kontrolleri etkileşimli kartlar olarak işlenir ve eklenen görseller araçlara yerel olarak iletilir.

Cursor

Yukarıda tek tıkla veya ~/.cursor/mcp.json (veya proje başına .cursor/mcp.json) öğesine manuel olarak ekleyin:

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com"
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json:

{
  "servers": {
    "bynn": {
      "type": "http",
      "url": "https://mcp.bynn.com"
    }
  }
}

Windsurf

Windsurf, mcp-remote köprüsü üzerinden bağlanır:

{
  "mcpServers": {
    "bynn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
    }
  }
}

Zed

settings.json → context_servers:

{
  "context_servers": {
    "bynn": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
      }
    }
  }
}

Kimlik doğrulama

OAuth 2.1 (bağlayıcılar)

Barındırılan bağlayıcılar (Claude, ChatGPT) OAuth 2.1 + PKCE ile kimlik doğrular. Yetkilendirme sunucusu dashboard.bynn.com'dir; MCP istemciniz bir tarayıcı oturum açma sayfası açar, istenen izinleri onaylarsınız ve istemci Bynn paneli kullanıcınız olarak bağlanır. Dinamik İstemci Kaydı'nı destekleyen istemciler (Claude, Cursor) otomatik olarak kaydolur.

Taşıyıcı token'lar (API tarzı istemciler)

Sunucu tarafı, betikli veya kendi kendine barındırılan kullanım için MCP bağlantısında bir yetkilendirme başlığı gönderin:

Authorization: Bearer <token>

dashboard.bynn.com/authenticate adresinden bir token alın. Üç token türü çalışır:

Token	Önek	Neler yapabilir
Panel token'ı (JWT)	yok	Her şey. Bir araç API anahtarı gerektirdiğinde, sunucu JWT'yi kuruluşunuzun anahtarlarıyla otomatik olarak değiştirir.
Özel API anahtarı	`private_...`	Ürün ve doğrulama araçları (belgeler, denetim, yaş sonuçları). API anahtarları veya faturalama gibi panel araçları için yeterli değildir.
Genel API anahtarı	`public_...`	İstemci güvenli oturum oluşturma (`create_session`, `create_age_verification_session`).

Araç grubuna göre:

Araç grubu	Minimum kimlik bilgisi
API anahtarları, faturalama, kullanıcılar, AutoDoc, muhakeme, web siteleri	Panel token'ı (JWT)
Belgeler, denetim, yüz, NFC	Özel anahtar veya JWT
`create_session`, `create_age_verification_session`	Genel anahtar veya JWT
`verify_age_from_selfie`, `get_age_verification_result`	Özel anahtar veya JWT
Oturum adımları (onay, ön kontrol, canlılık, yüklemeler)	Yok: URL'deki oturum token'ı kimlik bilgisidir

Özel anahtarları yalnızca güvenilir sunucu tarafı ortamlarında kullanın. Bunları asla ön uç kodunda, genel depolarda veya paylaşılan sohbetlerde açığa çıkarmayın.

Token ile örnek istemci yapılandırması

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com",
      "headers": {
        "Authorization": "Bearer ${BYNN_API_KEY}"
      }
    }
  }
}

export BYNN_API_KEY="private_your_bynn_key_here"

Araç referansı (143 araç)

Erişim rozetleri: Okuma = güvenli, değiştirmez. Yazma = veri oluşturur veya değiştirir. Yıkıcı = siler, iptal eder veya geri alır (delete_*, cancel_*, rotate_api_key); bunlar için istemcinizde onayı etkin tutun. Her araç ayrıca makine tarafından okunabilir readOnlyHint / destructiveHint ek açıklamaları taşır, böylece MCP istemcileri bunları otomatik olarak kapılayabilir.

Belgeler (4)

Araç	Erişim	Açıklama
`delete_document`	Yıkıcı	Bir belge gönderimini silin.
`get_document`	Okuma	Bir belge gönderimini ve adli analiz sonucunu alın.
`list_documents`	Okuma	Belge gönderimlerinizi listeleyin ve arayın.
`submit_document`	Yazma	Tam sahtecilik / orijinallik analizi için bir belge gönderin.

Belge analizi eşzamansızdır: submit_document, ardından status analyzed olana kadar get_document yoklayın.

Yaş Doğrulama (5)

Araç	Erişim	Açıklama
`complete_age_verification_liveness`	Yazma	Bir canlılık yakalamasını sonlandırın.
`create_age_verification_session`	Yazma	Yeni bir canlılık yaş doğrulama oturumu oluşturun.
`get_age_verification_result`	Okuma	Bir canlılık yaş doğrulama oturumunun sonucunu okuyun.
`start_age_verification_liveness`	Yazma	Bir oturum için canlılık yakalamasını başlatın.
`verify_age_from_selfie`	Yazma	Canlılık olmadan tek bir özçekimden yaş tahmin edin.

verify_age_from_selfie, bir age_verification_model eşiği (21, 18 ve daha düşük, varsayılan 18) artı bir legal_age_21 yargı yetkisi bayrağı alır. Canlılık akışı şöyledir: oturum oluştur → canlılığı başlat → canlılığı tamamla → sonucu al.

İçerik Denetimi (12)

Araç	Erişim	Açıklama
`check_age`	Yazma	Bir görseldeki yüzlerin yaşını tahmin edin (yaş doğrulama / reşit olmayan tespiti).
`create_moderation_inference`	Yazma	Bir denetim / yapay zeka tespiti çıkarımı çalıştırın.
`detect_ai_generated_image`	Yazma	Bir görselin yapay zeka tarafından mı üretildiğini yoksa gerçek bir fotoğraf mı olduğunu kontrol edin.
`get_moderation_dashboard_stats`	Okuma	Kuruluşunuz için denetim paneli istatistiklerini alın.
`get_moderation_inference`	Okuma	Kimliğine göre geçmiş bir denetim çıkarımını alın.
`get_moderation_model`	Okuma	Tam belgelerle bir denetim modeli alın.
`list_all_moderation_models`	Okuma	Her türdeki TÜM genel denetim modellerini listeleyin.
`list_audio_moderation_models`	Okuma	Kategoriye göre gruplandırılmış SES denetim modellerini listeleyin.
`list_image_moderation_models`	Okuma	Kategoriye göre gruplandırılmış GÖRSEL denetim modellerini listeleyin.
`list_text_moderation_models`	Okuma	Kategoriye göre gruplandırılmış METİN denetim modellerini listeleyin.
`list_video_moderation_models`	Okuma	Kategoriye göre gruplandırılmış VİDEO denetim modellerini listeleyin.
`public_moderation_inference`	Yazma	ÜCRETSİZ genel yapay zeka tespiti çıkarımı çalıştırın, kimlik bilgisi gerekmez.

detect_ai_generated_image, result.is_ai_generated (karar), ai_probability, uncertain, top_generator, generators, c2pa_signer ve detection_mode döndürür. check_age, yüz başına age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty ve bbox döndürür.

Yüz Araması (6)

Araç	Erişim	Açıklama
`create_face_collection`	Yazma	Yeni bir yüz koleksiyonu oluşturun.
`delete_face`	Yıkıcı	Bir koleksiyondan tek bir kayıtlı yüzü silin.
`delete_face_collection`	Yıkıcı	Bir yüz koleksiyonunu ve TÜM kayıtlı yüzlerini silin.
`enroll_face`	Yazma	Bir koleksiyona tek bir yüz kaydedin.
`list_face_collections`	Okuma	Kuruluşunuzun yüz koleksiyonlarını listeleyin.
`search_faces`	Okuma	Bir koleksiyonda, bir örnek görsele benzer yüzleri arayın.

AutoDoc (37)

Araç	Erişim	Açıklama
`add_dossier_note`	Yazma	Bir dosyaya yönetici notu ekleyin.
`approve_approval`	Yazma	Bekleyen bir HITL onayını onaylayın.
`attach_dossier_tag`	Yazma	Bir dosyaya kuruluş etiketi ekleyin.
`create_document_collection`	Yazma	Bir belge koleksiyonu oluşturun.
`create_invitation`	Yazma	E-posta veya SMS ile bir AutoDoc daveti gönderin.
`create_organization_tag`	Yazma	Bir kuruluş etiketi oluşturun.
`create_workflow`	Yazma	Bir iş akışı oluşturun.
`delete_document_collection`	Yıkıcı	Bir belge koleksiyonunu silin (yumuşak silme).
`delete_invitation`	Yıkıcı	Bekleyen bir AutoDoc davetini iptal edin (kalıcı silme).
`delete_organization_tag`	Yıkıcı	Bir kuruluş etiketini silin.
`delete_workflow`	Yıkıcı	Bir iş akışını silin (yumuşak silme).
`detach_dossier_tag`	Yazma	Bir dosyadan kuruluş etiketini çıkarın.
`download_dossier_zip`	Okuma	Bir dosyanın belgelerini ve değişkenlerini ZIP olarak paketleyin.
`duplicate_workflow`	Yazma	Bir iş akışını çoğaltın.
`get_autodoc_dashboard_stats`	Okuma	Toplu AutoDoc gösterge paneli istatistiklerini alın.
`get_document_collection`	Okuma	Bir belge koleksiyonunu ve gereksinimlerini alın.
`get_dossier`	Okuma	İlerleme ve iş akışı değişkenleriyle bir dosyayı alın.
`get_dossier_form_fields`	Okuma	Etkin iş akışlarınızda bulunan form alanı adlarını listeleyin.
`get_invitation`	Okuma	Tek bir AutoDoc davetini alın.
`get_pending_approval_count`	Okuma	Bekleyen HITL onaylarının sayısını alın.
`get_workflow`	Okuma	Tek bir iş akışını alın.
`list_approvals`	Okuma	İnsan-döngüde iş akışı onaylarını listeleyin.
`list_document_collections`	Okuma	Kuruluşunuz için belge koleksiyonlarını listeleyin.
`list_document_types`	Okuma	Koleksiyon gereksinimleri için mevcut belge türlerini listeleyin.
`list_dossier_documents`	Okuma	Bir dosyaya yüklenen belgeleri listeleyin.
`list_dossier_notes`	Okuma	Bir dosyanın notlarını / denetim zaman çizelgesini listeleyin.
`list_dossiers`	Okuma	AutoDoc dosyalarını listeleyin ve filtreleyin.
`list_invitation_locales`	Okuma	Desteklenen davet dillerini listeleyin.
`list_invitations`	Okuma	AutoDoc davetlerini listeleyin.
`list_organization_tags`	Okuma	Kuruluşunuzun dosya etiketlerini listeleyin.
`list_workflows`	Okuma	Kuruluşunuz için iş akışlarını listeleyin.
`reject_approval`	Yazma	Bekleyen bir HITL onayını reddedin.
`resend_invitation`	Yazma	Bir AutoDoc davetini yeniden gönderin.
`update_document_collection`	Yazma	Bir belge koleksiyonunu ve (isteğe bağlı olarak) gereksinimlerini güncelleyin.
`update_dossier`	Yazma	Bir dosyayı yeniden adlandırın.
`update_organization_tag`	Yazma	Bir kuruluş etiketinin rengini ve/veya adını güncelleyin.
`update_workflow`	Yazma	Bir iş akışını güncelleyin.

Akıl Yürütme ve Dolandırıcılık Ajanları (25)

Araç	Erişim	Açıklama
`create_fraud_agent`	Yazma	Bir dolandırıcılık analizi ajanı / operatörü oluşturun.
`create_orchestrator`	Yazma	Bir orkestratör (koordinatör) ajanı oluşturun.
`create_reasoning_job`	Yazma	Bir belge için ASENKRON bir dolandırıcılık akıl yürütme işi sıralayın.
`delete_fraud_agent`	Yıkıcı	Bir dolandırıcılık analizi ajanını / operatörünü silin.
`delete_orchestrator`	Yıkıcı	Bir orkestratör ajanını silin.
`generate_fraud_agent_prompt`	Yazma	Yapay zeka ile bir dolandırıcılık analizi ajanı sistem istemi taslağı oluşturun.
`generate_orchestrator_prompt`	Yazma	Yapay zeka ile bir orkestratör sistem istemi taslağı oluşturun.
`get_agent`	Okuma	Belirteç ile tek bir ajanı (orkestratör veya operatör) alın.
`get_agent_stats`	Okuma	Kuruluşunuz için toplu ajan istatistiklerini alın.
`get_reasoning_job`	Okuma	Bir akıl yürütme işinin durumunu ve tam sonuçlarını alın.
`list_agent_categories`	Okuma	Mevcut ajan kategori seçeneklerini listeleyin.
`list_agent_ratings`	Okuma	Genel bir ajan için derecelendirmeleri ve derecelendirme özetini listeleyin.
`list_document_content_types`	Okuma	Belge içerik türlerini ve hangilerinin zaten sahiplenildiğini listeleyin.
`list_fraud_agents`	Okuma	KURULUŞUNUZUN dolandırıcılık analizi ajanlarını / operatörlerini listeleyin.
`list_orchestrators`	Okuma	KURULUŞUNUZUN orkestratör ajanlarını listeleyin.
`list_public_fraud_agents`	Okuma	Küresel topluluktan genel dolandırıcılık analizi ajan şablonlarına göz atın.
`list_public_orchestrators`	Okuma	Küresel topluluktan genel orkestratör şablonlarına göz atın.
`list_reasoning_jobs`	Okuma	Filtreler ve kuruluş geneli istatistiklerle akıl yürütme işlerini listeleyin.
`publish_agent`	Yazma	Ajanlarınızdan birini genel topluluk pazarına yayınlayın.
`rate_agent`	Yazma	Genel bir ajanı 1-5 yıldızla derecelendirin.
`reorder_orchestrator_agents`	Yazma	Bir orkestratöre atanan dolandırıcılık analizi ajanlarını yeniden sıralayın.
`test_orchestrator`	Yazma	Bir orkestratörü mevcut bir belgeye karşı SENKRON olarak çalıştırın.
`unpublish_agent`	Yazma	Ajanlarınızdan birini genel pazardan kaldırın.
`update_fraud_agent`	Yazma	Bir dolandırıcılık analizi ajanını / operatörünü güncelleyin.
`update_orchestrator`	Yazma	Bir orkestratör ajanını güncelleyin.

Faturalandırma (14)

Araç	Erişim	Açıklama
`cancel_billing_plan`	Yıkıcı	Mevcut aboneliğin iptalini planlayın.
`change_billing_plan`	Yazma	Kuruluşun abonelik planını değiştirin.
`confirm_payment_method`	Yazma	Onaylanan kartı varsayılan ödeme yöntemi olarak kaydedin.
`create_setup_intent`	Yazma	Bir ödeme yöntemi toplamak için Stripe SetupIntent oluşturun.
`download_invoice`	Okuma	Bir faturayı PDF olarak indirin.
`get_billing_info`	Okuma	Kuruluş için tam faturalandırma anlık görüntüsünü alın.
`get_current_usage`	Okuma	Mevcut faturalandırma döneminin faturalanmamış kullanımını alın.
`get_stripe_config`	Okuma	Stripe istemci tarafı yapılandırmasını alın.
`list_billing_plans`	Okuma	Fiyatlandırma ve özelliklerle tüm mevcut abonelik planlarını listeleyin.
`list_inference_history`	Okuma	Kuruluşun AI çıkarım / doğrulama istek geçmişini listeleyin.
`list_invoices`	Okuma	Kuruluşun faturalarını, en yeniden en eskiye listeleyin.
`topup_balance`	Yazma	Kayıtlı kartla hesap bakiyesine ön ödemeli fon ekleyin.
`update_company_details`	Yazma	Kuruluşun şirket / faturalama bilgilerini güncelleyin.
`validate_vat_number`	Okuma	Harici bir arama yoluyla bir AB KDV numarasını doğrulayın.

topup_balance ABD doları cinsindendir, her yükleme için minimum 10 $, maksimum 10.000 $.

Kullanıcılar ve Hesap (7)

Araç	Erişim	Açıklama
`activate_trial`	Yazma	Bir ödeme yöntemi kaydedin ve 10 $ krediyle 7 günlük ücretsiz denemeyi etkinleştirin.
`add_passkey`	Yazma	Kimliği doğrulanmış kullanıcının hesabına bir geçiş anahtarı eklemeye başlayın: WebAuthn oluşturma seçeneklerini alın.
`delete_passkey`	Yıkıcı	Kimliği doğrulanmış kullanıcının geçiş anahtarlarından birini silin.
`get_current_user`	Okuma	Kimliği doğrulanmış kullanıcıyı, kuruluşunu ve hızlı hesap istatistiklerini alın.
`list_passkeys`	Okuma	Kimliği doğrulanmış kullanıcının kayıtlı geçiş anahtarlarını listeleyin.
`report_public_data`	Yazma	Kimliği doğrulanmış kullanıcının genel profilindeki yanlış verileri bildirin.
`submit_onboarding_survey`	Yazma	Mevcut kullanıcının kuruluş kayıt anketini kaydedin.

Web Siteleri (8)

Araç	Erişim	Açıklama
`create_website`	Yazma	Yeni bir yaş doğrulama web sitesi yapılandırması oluşturun.
`delete_website`	Yıkıcı	Bir yaş doğrulama web sitesi yapılandırmasını kalıcı olarak silin.
`get_website`	Okuma	Kimliğe göre bir yaş doğrulama web sitesini alın.
`list_countries`	Okuma	Kodlar ve özniteliklerle tüm ülkeleri listeleyin.
`list_verifications`	Okuma	Kuruluş için yaş doğrulama geçmişine göz atın.
`list_websites`	Okuma	Kimliği doğrulanmış kuruluş için her yaş doğrulama web sitesini listeleyin.
`pause_website`	Yazma	Bir web sitesi için yaş doğrulamayı duraklatın veya sürdürün.
`update_website`	Yazma	Mevcut bir yaş doğrulama web sitesi yapılandırmasını güncelleyin.

Agemin Kontrolleri (3)

Araç	Erişim	Açıklama
`get_age_verification_status`	Okuma	Önceki bir yaş doğrulama sonucunu sunucu tarafında yeniden kontrol edin.
`verify_age_with_email`	Yazma	Bir kişinin minimum yaşını e-posta adresinden tahmin edin.
`verify_age_with_selfie`	Yazma	Bir kişinin yaşını tek bir özçekim görüntüsünden tahmin edin.

Doğrulama Oturumları (16)

Araç	Erişim	Açıklama
`cancel_session`	Yıkıcı	Bir oturumu iptal edin / sonlandırın.
`check_email_verification`	Okuma	E-posta doğrulamasını kod ile tamamlayın.
`check_phone_verification`	Okuma	Telefon doğrulamasını SMS kodu ile tamamlayın.
`complete_liveness`	Yazma	Bir yüz canlılık yakalamasını tamamlayın.
`create_session`	Yazma	Yeni bir kimlik doğrulama oturumu oluşturun.
`get_session`	Okuma	Açık bir oturum hakkında bilgi gösterin.
`get_session_preflight`	Okuma	Bir oturum için sonraki doğrulama adımını alın.
`give_session_consent`	Yazma	Başvuru sahibinin onay kararını kaydedin.
`send_session_sms`	Yazma	Başvuru sahibine telefonunda devam etmesi için SMS ile bağlantı gönderin.
`start_email_verification`	Yazma	Kod e-postası göndererek e-posta doğrulamasını başlatın.
`start_liveness`	Yazma	Bir yüz canlılık yakalaması başlatın.
`start_phone_verification`	Yazma	Kod mesajı göndererek telefon doğrulamasını başlatın.
`submit_address_verification`	Yazma	Bir adres kanıtı belgesi yükleyin.
`submit_funds_verification`	Yazma	Bir fon kanıtı belgesi yükleyin.
`update_session`	Yazma	Açık bir oturumun başvuru sahibi bilgilerini güncelleyin.
`upload_session_media`	Yazma	Yakalanan medyayı bir oturuma yükleyin.

API Anahtarları (3)

Araç	Erişim	Açıklama
`get_api_key`	Okuma	Mevcut bir API anahtarının TAM, maskelenmemiş değerini alın.
`list_api_keys`	Okuma	Kimliği doğrulanmış kuruluş için tüm API anahtarlarını listeleyin.
`rotate_api_key`	Yıkıcı	Kimliği doğrulanmış kuruluş için bir API anahtarını döndürün (yeniden oluşturun).

list_api_keys maskelenmiş değerler döndürür; yalnızca get_api_key tam sırrı açığa çıkarır, bu nedenle paylaşılan bağlamlarda bunun için onayı açık tutun. rotate_api_key eski anahtarı varsayılan olarak 12 saatlik bir geçiş süresi boyunca geçerli tutar; anında iptal etmek için immediate: true değerini iletin.

NFC (1)

Araç	Erişim	Açıklama
`submit_nfc_data`	Yazma	NFC ile taranmış kimlik belgesi verilerini bir doğrulama oturumuna gönderin.

Sunucu ve Kendini Keşfetme (2)

Araç	Erişim	Açıklama
`describe_api`	Okuma	Bynn REST API'sinin OpenAPI 3.0 spesifikasyonunu döndürün (/openapi.json adresinden).
`describe_cli`	Okuma	Bynn CLI için kurulum, kimlik doğrulama ve kullanım talimatlarını döndürün (`bynn`).

Etkileşimli widget'lar

İki araç ailesi, MCP uygulamalarını (ChatGPT ve Claude) destekleyen ana bilgisayarlarda ham JSON yerine etkileşimli kartlar döndürür:

Belge sahtekarlığı (submit_document, get_document): risk göstergesi, adli sinyaller, çıkarılan alanlar ve risk etiketleri içeren canlı bir rapor kartı. Bekleyen analizler tamamlanana kadar kendilerini yoklar.
AI görüntü kontrolü (detect_ai_generated_image): AI olasılığı ve bir üretici dökümü içeren sonuç kartı. Görüntü sağlanmadıysa, kart sürükle-bırak yükleyiciyi işler ve bırakılan dosya sohbet bağlamına girmeden doğrudan dedektöre gider.

Diğer MCP istemcileri aynı verileri yapılandırılmış JSON olarak alır.

Örnek iş akışı

Sohbet odaklı yürütülen eksiksiz bir KYC oturumu:

1. "Create a verification session for applicant #4471 with my standard KYC level."
   → create_session returns {session_id, dossier_id, url, qr_base64_png, websocket_url}
2. Send the returned `url` to the applicant (or show the QR code).
3. "What's the next step for this session?"
   → get_session_preflight (after give_session_consent) walks each remaining step
4. "Show the session status."
   → get_session, repeated until the flow completes

Eşzamansız desen her yerde aynıdır: oluşturma araçları bir kimlik döndürür, get_* araçları onu yoklar. Belge sahtekarlığı için, submit_document → get_document status: "analyzed" olana kadar; muhakeme işleri için, create_reasoning_job → get_reasoning_job.

Bynn CLI: yerel dosyalarla çalışma

Barındırılan MCP sunucusu makinenizdeki dosyaları okuyamaz. Bynn CLI okuyabilir. Yerel olarak çalışan aracılar (Claude Code, Cursor, bir terminal) yerel dosyaları doğrudan analiz edebilir:

bynn submit ./bank-statement.pdf -o json      # full document-fraud analysis, auto-polls
bynn ai-generated ./profile-photo.png -o json # AI-generated-image check

Kurulum (macOS/Linux):

brew tap Bynn-Intelligence/bynn
brew install --cask bynn

Kurulum (Windows):

scoop bucket add bynn https://github.com/Bynn-Intelligence/scoop-bynn
scoop install bynn

Doğrudan indirmeler (artı .deb/.rpm ve sağlama toplamları) sürümler sayfasında bulunur.

Bir kez kimlik doğrulayın (bynn auth login anahtarı işletim sistemi anahtar zincirinizde saklar) veya BYNN_API_KEY, --token veya bynn auth login --with-token ile etkileşimli olmayan şekilde. Sandbox anahtarları (private_sandbox_...) otomatik olarak tanınır.

Aracı dostu tasarım: yapılandırılmış çıktı için -o json, filtreleme için --jq, istekleri önizlemek için --dry-run, eşzamansız sonuçlar için --poll ve temiz bir çıktı sözleşmesi (stdout = veri, stderr = ilerleme). Komut ağacı canlı Bynn OpenAPI spesifikasyonundan oluşturulur ve bynn api <METHOD> <PATH> herhangi bir uç noktaya ham kimliği doğrulanmış bir geçiştir. CLI oturumları, yaş doğrulaması, AutoDoc davetiyeleri, belgeler, moderasyon, NFC ve yüz kapsar; faturalandırma, API anahtarları, dosyalar, orkestratörler ve web siteleri için bu MCP sunucusunu kullanın.

Aracılar için: bu kılavuzun tamamını makine tarafından okunabilir biçimde almak için bu sunucudaki describe_cli aracını çağırın.

Aracılar için kendini keşfetme

Sunucu kendini belgeler. Ona bağlı bir LLM iseniz:

describe_api eksiksiz Bynn OpenAPI 3.0 spesifikasyonunu döndürür: MCP araçları olarak sarılmamış olanlar dahil her uç nokta, parametre ve şema. Kimlik doğrulama gerekmez.
describe_cli yerel dosyalarla çalışmak için bynn CLI'sini yerel olarak kurma, kimlik doğrulama ve çalıştırma konusunda yapılandırılmış bir kılavuz döndürür. Kimlik doğrulama gerekmez.
file://server/status (MCP kaynağı) canlı araç listesini ve sunucu durumunu döndürür.

Bunlar ayrıca sunucunun initialize talimatlarında duyurulur, bu nedenle bunları bulmak için bu README'ye ihtiyacınız yoktur.

Gelişmiş

Ek açıklamalar ve yanıt sözleşmesi

Her araç, fiile göre tutarlı bir şekilde uygulanan MCP ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) taşır: get_*/list_*/search_*/describe_*/download_*/validate_* salt okunurdur; delete_*/cancel_*/rotate_api_key yıkıcıdır. Hatalar, protokol hataları yerine yapılandırılmış {error: true, error_type, message} yükleri olarak geri döner, böylece aracılar bunları okuyabilir ve bunlara tepki verebilir.

Sorun giderme

Belirti	Çözüm
404 / bağlantı anında başarısız oluyor	URL'ye `/mcp` eklediniz. Uç nokta köktür: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	dashboard.bynn.com/authenticate adresinden bir belirteç alın ve bunu `Authorization` başlığı olarak ayarlayın. Körü körüne yeniden denemeyin.
Bir araç geçerli bir bağlantıyla 401 döndürüyor	Bu araç grubu için yanlış kimlik bilgisi türü; kimlik doğrulama tablosuna bakın. API anahtarları ve faturalandırma, ham bir `private_` anahtarı değil, bir gösterge paneli belirteci gerektirir.
Görüntü aracı görüntü sağlanmadığını söylüyor	Görünen kart sürükle-bırak kabul eder; görüntüyü içine bırakın. Veya genel bir `image_url` iletin.
Belge `pending` durumunda takılı kaldı	Analiz eşzamansızdır; `get_document` `status` `analyzed` olana kadar yoklayın. Birkaç saniyeden daha sık yoklamayın.
OAuth bağlayıcısı çalışmayı durduruyor	Oturum açma akışını yeniden çalıştırmak için bağlayıcının bağlantısını kesin ve yeniden bağlayın.

Destek

Sorunlar ve sorular: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

MIT lisanslı.