Bynn Intelligence

resmi

Deteksi Penipuan Dokumen (gambar, PDF)

Apa yang bisa Anda lakukan dengan Bynn Intelligence MCP?

Deteksi gambar yang dihasilkan AI — Minta asisten Anda untuk memeriksa apakah sebuah gambar dihasilkan oleh AI melalui detect_ai_generated_image, yang mengembalikan vonis, probabilitas, dan kemungkinan generatornya.
Jalankan analisis penipuan dokumen — Kirim dokumen dengan submit_document untuk analisis keaslian lengkap, lalu polling get_document hingga laporan forensik siap.
Buat sesi verifikasi KYC — Gunakan create_session untuk memulai alur verifikasi identitas dan dapatkan tautan yang dihosting atau kode QR untuk dikirim ke pemohon.
Perkirakan usia dari swafoto — Panggil verify_age_from_selfie untuk memperkirakan usia seseorang dan memeriksanya terhadap ambang batas seperti 18 atau 21, dengan opsi liveness.
Cari wajah dalam koleksi — Daftarkan wajah dengan enroll_face dan temukan kecocokan menggunakan search_faces terhadap koleksi organisasi Anda.
Kelola kunci API dan penagihan — Daftarkan, ambil, atau rotasi kunci API dengan list_api_keys/rotate_api_key, dan periksa penggunaan atau faktur melalui alat penagihan.

Dokumentasi

Fetch the complete documentation index at: https://docs.bynn.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

Bynn MCP

Hubungkan klien AI yang kompatibel dengan MCP ke Bynn: verifikasi identitas (KYC), deteksi penipuan dokumen, verifikasi usia, moderasi konten, pencarian wajah, alur kerja AutoDoc, agen penalaran penipuan, dan manajemen akun. 143 alat melalui API Bynn, satu koneksi. Berfungsi di Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf, dan Zed.

https://mcp.bynn.com

Endpoint adalah jalur root. Jangan tambahkan /mcp; https://mcp.bynn.com/mcp tidak akan berfungsi. Satu-satunya rute lain adalah GET /health.

Mulai cepat (30 detik)

Claude Code:

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

Claude atau ChatGPT (hosted): tambahkan https://mcp.bynn.com sebagai konektor kustom dan masuk dengan akun Bynn Anda saat browser terbuka. Tidak perlu menangani kunci.

Klien bergaya API: dapatkan token di dashboard.bynn.com/authenticate dan kirim sebagai Authorization: Bearer <token> pada koneksi.

Lalu coba prompt pertama Anda:

Check whether this image is AI-generated.

Lampirkan gambar, dan hasilnya dirender sebagai kartu interaktif dengan vonis, probabilitas AI, dan generator yang paling mungkin.

Contoh prompt

Penipuan dan dokumen

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.

Verifikasi

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.

Moderasi dan media

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

Akun dan operasi

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.

Hasil penipuan dokumen dan gambar AI dirender sebagai kartu interaktif di ChatGPT dan Claude (lihat Widget interaktif).

Instalasi

Claude Code

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

Claude Desktop dan claude.ai

Pengaturan → Konektor → Tambahkan konektor kustom → URL https://mcp.bynn.com. Masuk OAuth dimulai otomatis pada penggunaan pertama.

ChatGPT

Pengaturan → Aplikasi & Konektor → aktifkan mode pengembang → Buat → URL server MCP https://mcp.bynn.com. Bynn dibangun sebagai aplikasi ChatGPT: laporan penipuan dan pemeriksaan gambar AI dirender sebagai kartu interaktif, dan gambar yang dilampirkan diteruskan ke alat secara native.

Cursor

Satu klik di atas, atau tambahkan secara manual ke ~/.cursor/mcp.json (atau .cursor/mcp.json per proyek):

{
  "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 terhubung melalui jembatan mcp-remote:

{
  "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"]
      }
    }
  }
}

Autentikasi

OAuth 2.1 (konektor)

Konektor hosted (Claude, ChatGPT) melakukan autentikasi dengan OAuth 2.1 + PKCE. Server otorisasi adalah dashboard.bynn.com; klien MCP Anda membuka masuk browser, Anda menyetujui izin yang diminta, dan klien terhubung sebagai pengguna dashboard Bynn Anda. Klien yang mendukung Dynamic Client Registration (Claude, Cursor) mendaftar secara otomatis.

Token Bearer (klien bergaya API)

Untuk penggunaan server-side, skrip, atau self-hosted, kirim header otorisasi pada koneksi MCP:

Authorization: Bearer <token>

Dapatkan token di dashboard.bynn.com/authenticate. Tiga jenis token berfungsi:

Token	Prefix	Apa yang dapat dilakukan
Token dashboard (JWT)	tidak ada	Semuanya. Saat alat membutuhkan kunci API, server menukar JWT dengan kunci organisasi Anda secara otomatis.
Kunci API privat	`private_...`	Alat produk dan verifikasi (dokumen, moderasi, hasil usia). Tidak cukup untuk alat dashboard seperti kunci API atau penagihan.
Kunci API publik	`public_...`	Pembuatan sesi yang aman untuk klien (`create_session`, `create_age_verification_session`).

Per grup alat:

Grup alat	Kredensial minimum
Kunci API, penagihan, pengguna, AutoDoc, penalaran, situs web	Token dashboard (JWT)
Dokumen, moderasi, wajah, NFC	Kunci privat atau JWT
`create_session`, `create_age_verification_session`	Kunci publik atau JWT
`verify_age_from_selfie`, `get_age_verification_result`	Kunci privat atau JWT
Langkah sesi (persetujuan, preflight, liveness, unggahan)	Tidak ada: token sesi di URL adalah kredensialnya

Gunakan kunci privat hanya di lingkungan server-side yang tepercaya. Jangan pernah mengeksposnya di kode frontend, repositori publik, atau obrolan bersama.

Contoh konfigurasi klien dengan token

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

export BYNN_API_KEY="private_your_bynn_key_here"

Referensi alat (143 alat)

Lencana akses: Baca = aman, tidak mengubah. Tulis = membuat atau mengubah data. Destruktif = menghapus, membatalkan, atau mencabut (delete_*, cancel_*, rotate_api_key); pertahankan konfirmasi aktif untuk ini di klien Anda. Setiap alat juga membawa anotasi readOnlyHint / destructiveHint yang dapat dibaca mesin, sehingga klien MCP dapat mengaturnya secara otomatis.

Dokumen (4)

Alat	Akses	Deskripsi
`delete_document`	Destruktif	Hapus pengiriman dokumen.
`get_document`	Baca	Ambil pengiriman dokumen dan hasil analisis forensiknya.
`list_documents`	Baca	Daftar dan cari pengiriman dokumen Anda.
`submit_document`	Tulis	Kirim dokumen untuk analisis penipuan / keaslian lengkap.

Analisis dokumen bersifat asinkron: submit_document, lalu polling get_document hingga status adalah analyzed.

Verifikasi Usia (5)

Alat	Akses	Deskripsi
`complete_age_verification_liveness`	Tulis	Finalisasi penangkapan liveness.
`create_age_verification_session`	Tulis	Buat sesi verifikasi usia liveness baru.
`get_age_verification_result`	Baca	Baca hasil sesi verifikasi usia liveness.
`start_age_verification_liveness`	Tulis	Mulai penangkapan liveness untuk sesi.
`verify_age_from_selfie`	Tulis	Perkirakan usia dari satu selfie, tanpa liveness.

verify_age_from_selfie mengambil ambang age_verification_model (21, 18, dan lebih rendah, default 18) plus flag yurisdiksi legal_age_21. Alur liveness adalah: buat sesi → mulai liveness → selesaikan liveness → dapatkan hasil.

Moderasi Konten (12)

Alat	Akses	Deskripsi
`check_age`	Tulis	Perkirakan usia wajah dalam gambar (verifikasi usia / deteksi anak di bawah umur).
`create_moderation_inference`	Tulis	Jalankan inferensi moderasi / deteksi AI.
`detect_ai_generated_image`	Tulis	Periksa apakah gambar dibuat AI atau foto asli.
`get_moderation_dashboard_stats`	Baca	Dapatkan statistik dashboard moderasi untuk organisasi Anda.
`get_moderation_inference`	Baca	Ambil inferensi moderasi sebelumnya berdasarkan id-nya.
`get_moderation_model`	Baca	Dapatkan satu model moderasi dengan dokumentasi lengkap.
`list_all_moderation_models`	Baca	Daftar SEMUA model moderasi publik di setiap jenis.
`list_audio_moderation_models`	Baca	Daftar model moderasi AUDIO yang dikelompokkan berdasarkan kategori.
`list_image_moderation_models`	Baca	Daftar model moderasi GAMBAR yang dikelompokkan berdasarkan kategori.
`list_text_moderation_models`	Baca	Daftar model moderasi TEKS yang dikelompokkan berdasarkan kategori.
`list_video_moderation_models`	Baca	Daftar model moderasi VIDEO yang dikelompokkan berdasarkan kategori.
`public_moderation_inference`	Tulis	Jalankan inferensi deteksi AI publik GRATIS, tanpa kredensial diperlukan.

detect_ai_generated_image mengembalikan result.is_ai_generated (vonis), ai_probability, uncertain, top_generator, generators, c2pa_signer, dan detection_mode. check_age mengembalikan per wajah age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty, dan bbox.

Pencarian Wajah (6)

Alat	Akses	Deskripsi
`create_face_collection`	Tulis	Buat koleksi wajah baru.
`delete_face`	Destruktif	Hapus satu wajah terdaftar dari koleksi.
`delete_face_collection`	Destruktif	Hapus koleksi wajah dan SEMUA wajah terdaftarnya.
`enroll_face`	Tulis	Daftarkan satu wajah ke koleksi.
`list_face_collections`	Baca	Daftar koleksi wajah organisasi Anda.
`search_faces`	Baca	Cari koleksi untuk wajah yang mirip dengan gambar probe.

AutoDoc (37)

Alat	Akses	Deskripsi
`add_dossier_note`	Tulis	Tambahkan catatan admin ke sebuah dossier.
`approve_approval`	Tulis	Setujui persetujuan HITL yang tertunda.
`attach_dossier_tag`	Tulis	Lampirkan tag organisasi ke sebuah dossier.
`create_document_collection`	Tulis	Buat koleksi dokumen.
`create_invitation`	Tulis	Kirim undangan AutoDoc melalui email atau SMS.
`create_organization_tag`	Tulis	Buat tag organisasi.
`create_workflow`	Tulis	Buat alur kerja.
`delete_document_collection`	Destruktif	Hapus koleksi dokumen (soft delete).
`delete_invitation`	Destruktif	Batalkan (hard-delete) undangan AutoDoc yang tertunda.
`delete_organization_tag`	Destruktif	Hapus tag organisasi.
`delete_workflow`	Destruktif	Hapus alur kerja (soft delete).
`detach_dossier_tag`	Tulis	Lepaskan tag organisasi dari sebuah dossier.
`download_dossier_zip`	Baca	Kemas dokumen + variabel dossier ke dalam ZIP.
`duplicate_workflow`	Tulis	Gandakan alur kerja.
`get_autodoc_dashboard_stats`	Baca	Ambil statistik dasbor AutoDoc yang digabungkan.
`get_document_collection`	Baca	Ambil satu koleksi dokumen beserta persyaratannya.
`get_dossier`	Baca	Ambil satu dossier dengan progres dan variabel alur kerja.
`get_dossier_form_fields`	Baca	Daftar nama kolom formulir yang tersedia di seluruh alur kerja aktif Anda.
`get_invitation`	Baca	Ambil satu undangan AutoDoc.
`get_pending_approval_count`	Baca	Ambil jumlah persetujuan HITL yang tertunda.
`get_workflow`	Baca	Ambil satu alur kerja.
`list_approvals`	Baca	Daftar persetujuan alur kerja human-in-the-loop.
`list_document_collections`	Baca	Daftar koleksi dokumen untuk organisasi Anda.
`list_document_types`	Baca	Daftar jenis dokumen yang tersedia untuk persyaratan koleksi.
`list_dossier_documents`	Baca	Daftar dokumen yang diunggah ke sebuah dossier.
`list_dossier_notes`	Baca	Daftar catatan / linimasa audit sebuah dossier.
`list_dossiers`	Baca	Daftar dan filter dossier AutoDoc.
`list_invitation_locales`	Baca	Daftar locale undangan yang didukung.
`list_invitations`	Baca	Daftar undangan AutoDoc.
`list_organization_tags`	Baca	Daftar tag dossier organisasi Anda.
`list_workflows`	Baca	Daftar alur kerja untuk organisasi Anda.
`reject_approval`	Tulis	Tolak persetujuan HITL yang tertunda.
`resend_invitation`	Tulis	Kirim ulang undangan AutoDoc.
`update_document_collection`	Tulis	Perbarui koleksi dokumen dan (opsional) persyaratannya.
`update_dossier`	Tulis	Ganti nama sebuah dossier.
`update_organization_tag`	Tulis	Perbarui warna dan/atau nama tag organisasi.
`update_workflow`	Tulis	Perbarui alur kerja.

Agen Penalaran & Penipuan (25)

Alat	Akses	Deskripsi
`create_fraud_agent`	Tulis	Buat agen / operator analisis penipuan.
`create_orchestrator`	Tulis	Buat agen orkestrator (koordinator).
`create_reasoning_job`	Tulis	Antrekan pekerjaan penalaran penipuan ASINKRON untuk sebuah dokumen.
`delete_fraud_agent`	Destruktif	Hapus agen / operator analisis penipuan.
`delete_orchestrator`	Destruktif	Hapus agen orkestrator.
`generate_fraud_agent_prompt`	Tulis	Susun draf prompt sistem agen analisis penipuan dengan AI.
`generate_orchestrator_prompt`	Tulis	Susun draf prompt sistem orkestrator dengan AI.
`get_agent`	Baca	Ambil satu agen (orkestrator atau operator) berdasarkan token.
`get_agent_stats`	Baca	Ambil statistik agen gabungan untuk organisasi Anda.
`get_reasoning_job`	Baca	Ambil status dan hasil lengkap pekerjaan penalaran.
`list_agent_categories`	Baca	Daftar opsi kategori agen yang tersedia.
`list_agent_ratings`	Baca	Daftar peringkat dan ringkasan peringkat untuk agen publik.
`list_document_content_types`	Baca	Daftar jenis konten dokumen dan mana yang sudah diklaim.
`list_fraud_agents`	Baca	Daftar agen / operator analisis penipuan organisasi ANDA.
`list_orchestrators`	Baca	Daftar agen orkestrator organisasi ANDA.
`list_public_fraud_agents`	Baca	Jelajahi template agen analisis penipuan publik dari komunitas global.
`list_public_orchestrators`	Baca	Jelajahi template orkestrator publik dari komunitas global.
`list_reasoning_jobs`	Baca	Daftar pekerjaan penalaran dengan filter dan statistik seluruh organisasi.
`publish_agent`	Tulis	Publikasikan salah satu agen Anda ke marketplace komunitas publik.
`rate_agent`	Tulis	Beri peringkat agen publik 1-5 bintang.
`reorder_orchestrator_agents`	Tulis	Urutkan ulang agen analisis penipuan yang ditugaskan ke sebuah orkestrator.
`test_orchestrator`	Tulis	Jalankan orkestrator SECARA SINKRON terhadap dokumen yang ada.
`unpublish_agent`	Tulis	Hapus salah satu agen Anda dari marketplace publik.
`update_fraud_agent`	Tulis	Perbarui agen / operator analisis penipuan.
`update_orchestrator`	Tulis	Perbarui agen orkestrator.

Penagihan (14)

Alat	Akses	Deskripsi
`cancel_billing_plan`	Destruktif	Jadwalkan pembatalan langganan saat ini.
`change_billing_plan`	Tulis	Ubah paket langganan organisasi.
`confirm_payment_method`	Tulis	Simpan kartu terkonfirmasi sebagai metode pembayaran default.
`create_setup_intent`	Tulis	Buat Stripe SetupIntent untuk mengumpulkan metode pembayaran.
`download_invoice`	Baca	Unduh faktur sebagai PDF.
`get_billing_info`	Baca	Ambil snapshot penagihan lengkap untuk organisasi.
`get_current_usage`	Baca	Ambil penggunaan yang belum ditagih pada periode penagihan saat ini.
`get_stripe_config`	Baca	Ambil konfigurasi sisi-klien Stripe.
`list_billing_plans`	Baca	Daftar semua paket langganan yang tersedia beserta harga dan fitur.
`list_inference_history`	Baca	Daftar riwayat permintaan inferensi / verifikasi AI organisasi.
`list_invoices`	Baca	Daftar faktur organisasi, yang terbaru terlebih dahulu.
`topup_balance`	Tulis	Tambahkan dana prabayar ke saldo akun melalui kartu tersimpan.
`update_company_details`	Tulis	Perbarui detail perusahaan / penagihan organisasi.
`validate_vat_number`	Baca	Validasi nomor PPN UE melalui pencarian eksternal.

topup_balance dalam dolar AS, minimum $10, maksimum $10.000 per isi ulang.

Pengguna & Akun (7)

Alat	Akses	Deskripsi
`activate_trial`	Tulis	Simpan metode pembayaran dan aktifkan uji coba gratis 7 hari dengan kredit $10.
`add_passkey`	Tulis	Mulai menambahkan passkey ke akun pengguna terautentikasi: dapatkan opsi pembuatan WebAuthn.
`delete_passkey`	Destruktif	Hapus salah satu passkey pengguna terautentikasi.
`get_current_user`	Baca	Ambil pengguna terautentikasi, organisasi mereka, dan statistik akun cepat.
`list_passkeys`	Baca	Daftar passkey terdaftar pengguna terautentikasi.
`report_public_data`	Tulis	Laporkan data yang salah di profil publik pengguna terautentikasi.
`submit_onboarding_survey`	Tulis	Simpan survei orientasi organisasi pengguna saat ini.

Situs Web (8)

Alat	Akses	Deskripsi
`create_website`	Tulis	Buat konfigurasi situs web verifikasi usia baru.
`delete_website`	Destruktif	Hapus permanen konfigurasi situs web verifikasi usia.
`get_website`	Baca	Ambil satu situs web verifikasi usia berdasarkan ID.
`list_countries`	Baca	Daftar semua negara dengan kode dan atribut.
`list_verifications`	Baca	Jelajahi riwayat verifikasi usia untuk organisasi.
`list_websites`	Baca	Daftar setiap situs web verifikasi usia untuk organisasi terautentikasi.
`pause_website`	Tulis	Jeda atau lanjutkan verifikasi usia untuk sebuah situs web.
`update_website`	Tulis	Perbarui konfigurasi situs web verifikasi usia yang ada.

Pemeriksaan Agemin (3)

Tool	Akses	Deskripsi
`get_age_verification_status`	Baca	Periksa ulang hasil verifikasi usia sebelumnya di sisi server.
`verify_age_with_email`	Tulis	Perkirakan usia minimum seseorang dari alamat email mereka.
`verify_age_with_selfie`	Tulis	Perkirakan usia seseorang dari satu gambar selfie.

Sesi Verifikasi (16)

Tool	Akses	Deskripsi
`cancel_session`	Destruktif	Batalkan / hentikan sebuah sesi.
`check_email_verification`	Baca	Selesaikan verifikasi email dengan kode.
`check_phone_verification`	Baca	Selesaikan verifikasi telepon dengan kode SMS.
`complete_liveness`	Tulis	Selesaikan penangkapan liveness wajah.
`create_session`	Tulis	Buat sesi verifikasi identitas baru.
`get_session`	Baca	Tampilkan informasi tentang sesi yang terbuka.
`get_session_preflight`	Baca	Dapatkan langkah verifikasi berikutnya untuk sebuah sesi.
`give_session_consent`	Tulis	Catat keputusan persetujuan pemohon.
`send_session_sms`	Tulis	Kirim SMS tautan ke pemohon untuk melanjutkan di ponsel mereka.
`start_email_verification`	Tulis	Mulai verifikasi email dengan mengirim kode melalui email.
`start_liveness`	Tulis	Mulai penangkapan liveness wajah.
`start_phone_verification`	Tulis	Mulai verifikasi telepon dengan mengirim kode melalui SMS.
`submit_address_verification`	Tulis	Unggah dokumen bukti alamat.
`submit_funds_verification`	Tulis	Unggah dokumen bukti dana.
`update_session`	Tulis	Perbarui detail pemohon pada sesi yang terbuka.
`upload_session_media`	Tulis	Unggah media yang ditangkap ke sebuah sesi.

Kunci API (3)

Tool	Akses	Deskripsi
`get_api_key`	Baca	Ambil nilai LENGKAP, tanpa topeng dari kunci API yang ada.
`list_api_keys`	Baca	Daftar semua kunci API untuk organisasi yang terautentikasi.
`rotate_api_key`	Destruktif	Putar (hasilkan ulang) kunci API untuk organisasi yang terautentikasi.

list_api_keys mengembalikan nilai bertopeng; hanya get_api_key yang mengungkapkan rahasia penuh, jadi pertahankan konfirmasi untuk itu dalam konteks bersama. rotate_api_key menjaga kunci lama tetap valid selama periode tenggang 12 jam secara default; berikan immediate: true untuk mencabutnya seketika.

NFC (1)

Tool	Akses	Deskripsi
`submit_nfc_data`	Tulis	Kirim data dokumen identitas hasil pindai NFC ke sesi verifikasi.

Server & Penemuan Mandiri (2)

Tool	Akses	Deskripsi
`describe_api`	Baca	Kembalikan spesifikasi OpenAPI 3.0 dari REST API Bynn (dari /openapi.json).
`describe_cli`	Baca	Kembalikan instruksi instalasi, autentikasi, dan penggunaan untuk CLI Bynn (`bynn`).

Widget interaktif

Dua keluarga alat mengembalikan kartu interaktif alih-alih JSON mentah di host yang mendukung aplikasi MCP (ChatGPT dan Claude):

Penipuan dokumen (submit_document, get_document): kartu laporan langsung dengan pengukur risiko, sinyal forensik, bidang yang diekstrak, dan tag risiko. Analisis yang tertunda melakukan polling sendiri hingga selesai.
Pemeriksaan gambar AI (detect_ai_generated_image): kartu putusan dengan probabilitas AI dan rincian generator. Jika tidak ada gambar yang diberikan, kartu merender pengunggah seret-dan-lepas, dan file yang dijatuhkan langsung menuju detektor tanpa masuk ke konteks obrolan.

Klien MCP lainnya hanya menerima data yang sama sebagai JSON terstruktur.

Alur kerja contoh

Sesi KYC lengkap, dijalankan secara percakapan:

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

Pola asinkron sama di mana-mana: alat pembuatan mengembalikan id, alat get_* melakukan polling padanya. Untuk penipuan dokumen, submit_document → get_document hingga status: "analyzed"; untuk pekerjaan penalaran, create_reasoning_job → get_reasoning_job.

CLI Bynn: bekerja dengan file lokal

Server MCP yang dihosting tidak dapat membaca file di mesin Anda. CLI Bynn bisa. Agen yang berjalan secara lokal (Claude Code, Cursor, terminal) dapat menganalisis file lokal secara langsung:

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

Instalasi (macOS/Linux):

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

Instalasi (Windows):

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

Unduhan langsung (plus .deb/.rpm dan checksum) tersedia di halaman rilis.

Autentikasi sekali (bynn auth login menyimpan kunci di keychain OS Anda), atau non-interaktif dengan BYNN_API_KEY, --token, atau bynn auth login --with-token. Kunci sandbox (private_sandbox_...) dikenali secara otomatis.

Ramah agen secara desain: -o json untuk keluaran terstruktur, --jq untuk pemfilteran, --dry-run untuk melihat pratinjau permintaan, --poll untuk hasil asinkron, dan kontrak keluaran yang bersih (stdout = data, stderr = progres). Pohon perintah dihasilkan dari spesifikasi OpenAPI Bynn langsung, dan bynn api <METHOD> <PATH> adalah penerusan mentah terautentikasi ke endpoint mana pun. CLI mencakup sesi, verifikasi usia, undangan AutoDoc, dokumen, moderasi, NFC, dan wajah; untuk penagihan, kunci API, dossier, orkestrator, dan situs web, gunakan server MCP ini.

Untuk agen: panggil alat describe_cli di server ini untuk panduan lengkap ini dalam bentuk yang dapat dibaca mesin.

Penemuan mandiri untuk agen

Server mendokumentasikan dirinya sendiri. Jika Anda adalah LLM yang terhubung dengannya:

describe_api mengembalikan spesifikasi OpenAPI 3.0 Bynn lengkap: setiap endpoint, parameter, dan skema, termasuk yang tidak dibungkus sebagai alat MCP. Tidak perlu autentikasi.
describe_cli mengembalikan panduan terstruktur untuk menginstal, mengautentikasi, dan menjalankan CLI bynn secara lokal, untuk bekerja dengan file lokal. Tidak perlu autentikasi.
file://server/status (sumber daya MCP) mengembalikan daftar alat langsung dan status server.

Ini juga diumumkan dalam instruksi initialize server, jadi Anda tidak perlu README ini untuk menemukannya.

Lanjutan

Anotasi dan kontrak respons

Setiap alat membawa ToolAnnotations MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), diterapkan secara konsisten berdasarkan kata kerja: get_*/list_*/ search_*/describe_*/download_*/validate_* bersifat hanya-baca; delete_*/cancel_*/ rotate_api_key bersifat destruktif. Kegagalan datang sebagai payload {error: true, error_type, message} terstruktur alih-alih kesalahan protokol, sehingga agen dapat membaca dan bereaksi terhadapnya.

Pemecahan masalah

Gejala	Perbaikan
404 / koneksi gagal segera	Anda menambahkan `/mcp` ke URL. Endpoint-nya adalah akar: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	Dapatkan token di dashboard.bynn.com/authenticate dan atur sebagai header `Authorization`. Jangan mencoba ulang secara membabi buta.
Alat mengembalikan 401 dengan koneksi yang valid	Jenis kredensial salah untuk grup alat tersebut; lihat tabel autentikasi. Kunci API dan penagihan memerlukan token dasbor, bukan kunci `private_` mentah.
Alat gambar mengatakan tidak ada gambar yang diberikan	Kartu yang muncul menerima seret-dan-lepas; jatuhkan gambar ke dalamnya. Atau berikan `image_url` publik.
Dokumen macet di `pending`	Analisis bersifat asinkron; polling `get_document` hingga `status` menjadi `analyzed`. Jangan polling lebih dari setiap beberapa detik.
Konektor OAuth berhenti berfungsi	Putuskan dan sambungkan kembali konektor untuk menjalankan ulang alur masuk.

Dukungan

Masalah dan pertanyaan: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

Dilisensikan MIT.