Bynn Intelligence

chính thức

Phát hiện gian lận tài liệu (hình ảnh, PDF)

Xem trên bynn.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Bynn Intelligence MCP?

Phát hiện hình ảnh do AI tạo — Yêu cầu trợ lý của bạn kiểm tra xem một hình ảnh có phải do AI tạo ra hay không thông qua detect_ai_generated_image, trả về kết quả đánh giá, xác suất và công cụ tạo có khả năng nhất.
Chạy phân tích gian lận tài liệu — Gửi một tài liệu bằng submit_document để phân tích xác thực toàn diện, sau đó thăm dò get_document cho đến khi báo cáo pháp y sẵn sàng.
Tạo phiên xác minh KYC — Sử dụng create_session để bắt đầu quy trình xác minh danh tính và nhận liên kết lưu trữ hoặc mã QR để gửi cho người nộp đơn.
Ước tính tuổi từ ảnh tự sướng — Gọi verify_age_from_selfie để ước tính tuổi của một người và kiểm tra với ngưỡng như 18 hoặc 21, có thể kèm xác thực trực tiếp.
Tìm kiếm khuôn mặt trong bộ sưu tập — Đăng ký khuôn mặt bằng enroll_face và tìm kết quả khớp bằng search_faces đối với các bộ sưu tập của tổ chức bạn.
Quản lý khóa API và thanh toán — Liệt kê, truy xuất hoặc xoay vòng khóa API bằng list_api_keys/rotate_api_key, và kiểm tra mức sử dụng hoặc hóa đơn qua các công cụ thanh toán.

Tài liệu

Fetch chỉ mục tài liệu đầy đủ tại: https://docs.bynn.com/llms.txt. Sử dụng tệp này để khám phá tất cả các trang có sẵn trước khi tìm hiểu sâu hơn. Thêm .md vào bất kỳ URL trang tài liệu nào để lấy phiên bản markdown của nó.

Bynn MCP

Kết nối bất kỳ ứng dụng AI tương thích MCP nào với Bynn: xác minh danh tính (KYC), phát hiện gian lận tài liệu, xác minh độ tuổi, kiểm duyệt nội dung, tìm kiếm khuôn mặt, quy trình AutoDoc, tác nhân suy luận gian lận và quản lý tài khoản. 143 công cụ qua API Bynn, một kết nối duy nhất. Hoạt động trong Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf và Zed.

https://mcp.bynn.com

Điểm cuối là đường dẫn gốc. Không thêm /mcp; https://mcp.bynn.com/mcp sẽ không hoạt động. Tuyến đường duy nhất khác là GET /health.

Bắt đầu nhanh (30 giây)

Claude Code:

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

Claude hoặc ChatGPT (được lưu trữ): thêm https://mcp.bynn.com làm trình kết nối tùy chỉnh và đăng nhập bằng tài khoản Bynn của bạn khi trình duyệt mở. Không cần xử lý khóa.

Ứng dụng kiểu API: lấy mã thông báo tại dashboard.bynn.com/authenticate và gửi nó dưới dạng Authorization: Bearer <token> trên kết nối.

Sau đó thử lời nhắc đầu tiên của bạn:

Check whether this image is AI-generated.

Đính kèm một hình ảnh và kết quả hiển thị dưới dạng thẻ tương tác với phán quyết, xác suất AI và trình tạo có khả năng nhất.

Ví dụ về lời nhắc

Gian lận và tài liệu

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.

Xác minh

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.

Kiểm duyệt và phương tiện

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

Tài khoản và vận hành

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.

Kết quả phát hiện gian lận tài liệu và hình ảnh AI hiển thị dưới dạng thẻ tương tác trong cả ChatGPT và Claude (xem Tiện ích tương tác).

Cài đặt

Claude Code

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

Claude Desktop và claude.ai

Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh → URL https://mcp.bynn.com. Đăng nhập OAuth tự động bắt đầu khi sử dụng lần đầu.

ChatGPT

Cài đặt → Ứng dụng & Trình kết nối → bật chế độ nhà phát triển → Tạo → URL máy chủ MCP https://mcp.bynn.com. Bynn được xây dựng như một ứng dụng ChatGPT: báo cáo gian lận và kiểm tra hình ảnh AI hiển thị dưới dạng thẻ tương tác và hình ảnh đính kèm được chuyển tiếp đến các công cụ một cách tự nhiên.

Cursor

Một cú nhấp chuột ở trên hoặc thêm thủ công vào ~/.cursor/mcp.json (hoặc .cursor/mcp.json cho mỗi dự án):

{
  "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 kết nối qua cầu nối 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"]
      }
    }
  }
}

Xác thực

OAuth 2.1 (trình kết nối)

Các trình kết nối được lưu trữ (Claude, ChatGPT) xác thực bằng OAuth 2.1 + PKCE. Máy chủ ủy quyền là dashboard.bynn.com; ứng dụng MCP của bạn mở trình duyệt đăng nhập, bạn phê duyệt các quyền được yêu cầu và ứng dụng kết nối với tư cách người dùng bảng điều khiển Bynn của bạn. Các ứng dụng hỗ trợ Đăng ký ứng dụng động (Claude, Cursor) tự động đăng ký.

Mã thông báo Bearer (ứng dụng kiểu API)

Đối với sử dụng phía máy chủ, tập lệnh hoặc tự lưu trữ, hãy gửi tiêu đề ủy quyền trên kết nối MCP:

Authorization: Bearer <token>

Lấy mã thông báo tại dashboard.bynn.com/authenticate. Ba loại mã thông báo hoạt động:

Mã thông báo	Tiền tố	Khả năng
Mã thông báo bảng điều khiển (JWT)	không có	Mọi thứ. Khi một công cụ cần khóa API, máy chủ tự động trao đổi JWT để lấy khóa của tổ chức bạn.
Khóa API riêng tư	`private_...`	Các công cụ sản phẩm và xác minh (tài liệu, kiểm duyệt, kết quả độ tuổi). Không đủ cho các công cụ bảng điều khiển như khóa API hoặc thanh toán.
Khóa API công khai	`public_...`	Tạo phiên an toàn cho ứng dụng (`create_session`, `create_age_verification_session`).

Theo nhóm công cụ:

Nhóm công cụ	Thông tin xác thực tối thiểu
Khóa API, thanh toán, người dùng, AutoDoc, suy luận, trang web	Mã thông báo bảng điều khiển (JWT)
Tài liệu, kiểm duyệt, khuôn mặt, NFC	Khóa riêng tư hoặc JWT
`create_session`, `create_age_verification_session`	Khóa công khai hoặc JWT
`verify_age_from_selfie`, `get_age_verification_result`	Khóa riêng tư hoặc JWT
Các bước phiên (đồng ý, kiểm tra trước, kiểm tra sống, tải lên)	Không có: mã thông báo phiên trong URL là thông tin xác thực

Chỉ sử dụng khóa riêng tư trong môi trường phía máy chủ đáng tin cậy. Không bao giờ tiết lộ chúng trong mã giao diện người dùng, kho lưu trữ công khai hoặc các cuộc trò chuyện chia sẻ.

Ví dụ cấu hình ứng dụng với mã thông báo

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

export BYNN_API_KEY="private_your_bynn_key_here"

Tham chiếu công cụ (143 công cụ)

Huy hiệu truy cập: Đọc = an toàn, không thay đổi. Ghi = tạo hoặc thay đổi dữ liệu. Phá hủy = xóa, hủy hoặc thu hồi (delete_*, cancel_*, rotate_api_key); giữ xác nhận được bật cho các công cụ này trong ứng dụng của bạn. Mỗi công cụ cũng mang chú thích readOnlyHint / destructiveHint có thể đọc bằng máy, để các ứng dụng MCP có thể tự động kiểm soát chúng.

Tài liệu (4)

Công cụ	Truy cập	Mô tả
`delete_document`	Phá hủy	Xóa một bản gửi tài liệu.
`get_document`	Đọc	Truy xuất một bản gửi tài liệu và kết quả phân tích pháp y của nó.
`list_documents`	Đọc	Liệt kê và tìm kiếm các bản gửi tài liệu của bạn.
`submit_document`	Ghi	Gửi một tài liệu để phân tích gian lận / xác thực đầy đủ.

Phân tích tài liệu không đồng bộ: submit_document, sau đó thăm dò get_document cho đến khi status là analyzed.

Xác minh độ tuổi (5)

Công cụ	Truy cập	Mô tả
`complete_age_verification_liveness`	Ghi	Hoàn tất một lần chụp kiểm tra sống.
`create_age_verification_session`	Ghi	Tạo một phiên xác minh độ tuổi kiểm tra sống mới.
`get_age_verification_result`	Đọc	Đọc kết quả của một phiên xác minh độ tuổi kiểm tra sống.
`start_age_verification_liveness`	Ghi	Bắt đầu chụp kiểm tra sống cho một phiên.
`verify_age_from_selfie`	Ghi	Ước tính độ tuổi từ một bức ảnh tự sướng, không cần kiểm tra sống.

verify_age_from_selfie nhận ngưỡng age_verification_model (21, 18 và thấp hơn, mặc định 18) cùng với cờ khu vực tài phán legal_age_21. Quy trình kiểm tra sống là: tạo phiên → bắt đầu kiểm tra sống → hoàn tất kiểm tra sống → lấy kết quả.

Kiểm duyệt nội dung (12)

Công cụ	Truy cập	Mô tả
`check_age`	Ghi	Ước tính độ tuổi của khuôn mặt trong hình ảnh (xác minh độ tuổi / phát hiện trẻ vị thành niên).
`create_moderation_inference`	Ghi	Chạy suy luận kiểm duyệt / phát hiện AI.
`detect_ai_generated_image`	Ghi	Kiểm tra xem hình ảnh có phải do AI tạo hay là ảnh thật.
`get_moderation_dashboard_stats`	Đọc	Lấy thống kê bảng điều khiển kiểm duyệt cho tổ chức của bạn.
`get_moderation_inference`	Đọc	Truy xuất một suy luận kiểm duyệt trước đó theo id của nó.
`get_moderation_model`	Đọc	Lấy một mô hình kiểm duyệt với tài liệu đầy đủ.
`list_all_moderation_models`	Đọc	Liệt kê TẤT CẢ các mô hình kiểm duyệt công khai trên mọi loại.
`list_audio_moderation_models`	Đọc	Liệt kê các mô hình kiểm duyệt ÂM THANH được nhóm theo danh mục.
`list_image_moderation_models`	Đọc	Liệt kê các mô hình kiểm duyệt HÌNH ẢNH được nhóm theo danh mục.
`list_text_moderation_models`	Đọc	Liệt kê các mô hình kiểm duyệt VĂN BẢN được nhóm theo danh mục.
`list_video_moderation_models`	Đọc	Liệt kê các mô hình kiểm duyệt VIDEO được nhóm theo danh mục.
`public_moderation_inference`	Ghi	Chạy suy luận phát hiện AI công khai MIỄN PHÍ, không cần thông tin xác thực.

detect_ai_generated_image trả về result.is_ai_generated (phán quyết), ai_probability, uncertain, top_generator, generators, c2pa_signer và detection_mode. check_age trả về age cho từng khuôn mặt, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty và bbox.

Tìm kiếm khuôn mặt (6)

Công cụ	Truy cập	Mô tả
`create_face_collection`	Ghi	Tạo một bộ sưu tập khuôn mặt mới.
`delete_face`	Phá hủy	Xóa một khuôn mặt đã đăng ký khỏi một bộ sưu tập.
`delete_face_collection`	Phá hủy	Xóa một bộ sưu tập khuôn mặt và TẤT CẢ các khuôn mặt đã đăng ký của nó.
`enroll_face`	Ghi	Đăng ký một khuôn mặt vào một bộ sưu tập.
`list_face_collections`	Đọc	Liệt kê các bộ sưu tập khuôn mặt của tổ chức bạn.
`search_faces`	Đọc	Tìm kiếm trong một bộ sưu tập các khuôn mặt tương tự với hình ảnh mẫu.

AutoDoc (37)

Công cụ	Quyền truy cập	Mô tả
`add_dossier_note`	Ghi	Thêm ghi chú quản trị vào một hồ sơ.
`approve_approval`	Ghi	Phê duyệt một yêu cầu phê duyệt HITL đang chờ xử lý.
`attach_dossier_tag`	Ghi	Gắn thẻ tổ chức vào một hồ sơ.
`create_document_collection`	Ghi	Tạo một bộ sưu tập tài liệu.
`create_invitation`	Ghi	Gửi lời mời AutoDoc qua email hoặc SMS.
`create_organization_tag`	Ghi	Tạo một thẻ tổ chức.
`create_workflow`	Ghi	Tạo một quy trình làm việc.
`delete_document_collection`	Phá hủy	Xóa một bộ sưu tập tài liệu (xóa mềm).
`delete_invitation`	Phá hủy	Hủy (xóa cứng) một lời mời AutoDoc đang chờ xử lý.
`delete_organization_tag`	Phá hủy	Xóa một thẻ tổ chức.
`delete_workflow`	Phá hủy	Xóa một quy trình làm việc (xóa mềm).
`detach_dossier_tag`	Ghi	Gỡ thẻ tổ chức khỏi một hồ sơ.
`download_dossier_zip`	Đọc	Đóng gói tài liệu + biến của một hồ sơ thành tệp ZIP.
`duplicate_workflow`	Ghi	Nhân bản một quy trình làm việc.
`get_autodoc_dashboard_stats`	Đọc	Lấy số liệu thống kê tổng hợp từ bảng điều khiển AutoDoc.
`get_document_collection`	Đọc	Lấy một bộ sưu tập tài liệu và các yêu cầu của nó.
`get_dossier`	Đọc	Lấy một hồ sơ kèm tiến độ và các biến của quy trình làm việc.
`get_dossier_form_fields`	Đọc	Liệt kê tên các trường biểu mẫu có sẵn trong các quy trình làm việc đang hoạt động của bạn.
`get_invitation`	Đọc	Lấy một lời mời AutoDoc cụ thể.
`get_pending_approval_count`	Đọc	Lấy số lượng yêu cầu phê duyệt HITL đang chờ xử lý.
`get_workflow`	Đọc	Lấy một quy trình làm việc cụ thể.
`list_approvals`	Đọc	Liệt kê các yêu cầu phê duyệt quy trình làm việc có sự tham gia của con người.
`list_document_collections`	Đọc	Liệt kê các bộ sưu tập tài liệu cho tổ chức của bạn.
`list_document_types`	Đọc	Liệt kê các loại tài liệu có sẵn cho các yêu cầu của bộ sưu tập.
`list_dossier_documents`	Đọc	Liệt kê các tài liệu đã tải lên một hồ sơ.
`list_dossier_notes`	Đọc	Liệt kê ghi chú / dòng thời gian kiểm toán của một hồ sơ.
`list_dossiers`	Đọc	Liệt kê và lọc các hồ sơ AutoDoc.
`list_invitation_locales`	Đọc	Liệt kê các ngôn ngữ (locale) được hỗ trợ cho lời mời.
`list_invitations`	Đọc	Liệt kê các lời mời AutoDoc.
`list_organization_tags`	Đọc	Liệt kê các thẻ hồ sơ của tổ chức bạn.
`list_workflows`	Đọc	Liệt kê các quy trình làm việc cho tổ chức của bạn.
`reject_approval`	Ghi	Từ chối một yêu cầu phê duyệt HITL đang chờ xử lý.
`resend_invitation`	Ghi	Gửi lại một lời mời AutoDoc.
`update_document_collection`	Ghi	Cập nhật một bộ sưu tập tài liệu và (tùy chọn) các yêu cầu của nó.
`update_dossier`	Ghi	Đổi tên một hồ sơ.
`update_organization_tag`	Ghi	Cập nhật màu sắc và/hoặc tên của một thẻ tổ chức.
`update_workflow`	Ghi	Cập nhật một quy trình làm việc.

Tác nhân Lập luận & Phát hiện Gian lận (25)

Công cụ	Quyền truy cập	Mô tả
`create_fraud_agent`	Ghi	Tạo một tác nhân / nhà điều hành phân tích gian lận.
`create_orchestrator`	Ghi	Tạo một tác nhân điều phối (điều phối viên).
`create_reasoning_job`	Ghi	Xếp hàng đợi một công việc lập luận phát hiện gian lận KHÔNG ĐỒNG BỘ cho một tài liệu.
`delete_fraud_agent`	Phá hủy	Xóa một tác nhân / nhà điều hành phân tích gian lận.
`delete_orchestrator`	Phá hủy	Xóa một tác nhân điều phối.
`generate_fraud_agent_prompt`	Ghi	Soạn thảo lời nhắc hệ thống cho tác nhân phân tích gian lận bằng AI.
`generate_orchestrator_prompt`	Ghi	Soạn thảo lời nhắc hệ thống cho tác nhân điều phối bằng AI.
`get_agent`	Đọc	Lấy một tác nhân cụ thể (điều phối hoặc nhà điều hành) theo mã thông báo.
`get_agent_stats`	Đọc	Lấy số liệu thống kê tổng hợp về tác nhân cho tổ chức của bạn.
`get_reasoning_job`	Đọc	Lấy trạng thái và kết quả đầy đủ của một công việc lập luận.
`list_agent_categories`	Đọc	Liệt kê các tùy chọn danh mục tác nhân có sẵn.
`list_agent_ratings`	Đọc	Liệt kê xếp hạng và tóm tắt xếp hạng cho một tác nhân công khai.
`list_document_content_types`	Đọc	Liệt kê các loại nội dung tài liệu và loại nào đã được xác nhận.
`list_fraud_agents`	Đọc	Liệt kê các tác nhân / nhà điều hành phân tích gian lận CỦA TỔ CHỨC BẠN.
`list_orchestrators`	Đọc	Liệt kê các tác nhân điều phối CỦA TỔ CHỨC BẠN.
`list_public_fraud_agents`	Đọc	Duyệt các mẫu tác nhân phân tích gian lận công khai từ cộng đồng toàn cầu.
`list_public_orchestrators`	Đọc	Duyệt các mẫu tác nhân điều phối công khai từ cộng đồng toàn cầu.
`list_reasoning_jobs`	Đọc	Liệt kê các công việc lập luận với bộ lọc và số liệu thống kê toàn tổ chức.
`publish_agent`	Ghi	Xuất bản một trong các tác nhân của bạn lên chợ cộng đồng công khai.
`rate_agent`	Ghi	Đánh giá một tác nhân công khai từ 1-5 sao.
`reorder_orchestrator_agents`	Ghi	Sắp xếp lại các tác nhân phân tích gian lận được gán cho một tác nhân điều phối.
`test_orchestrator`	Ghi	Chạy một tác nhân điều phối ĐỒNG BỘ trên một tài liệu hiện có.
`unpublish_agent`	Ghi	Gỡ một trong các tác nhân của bạn khỏi chợ công khai.
`update_fraud_agent`	Ghi	Cập nhật một tác nhân / nhà điều hành phân tích gian lận.
`update_orchestrator`	Ghi	Cập nhật một tác nhân điều phối.

Thanh toán (14)

Công cụ	Quyền truy cập	Mô tả
`cancel_billing_plan`	Phá hủy	Lên lịch hủy đăng ký hiện tại.
`change_billing_plan`	Ghi	Thay đổi gói đăng ký của tổ chức.
`confirm_payment_method`	Ghi	Lưu thẻ đã xác nhận làm phương thức thanh toán mặc định.
`create_setup_intent`	Ghi	Tạo một Stripe SetupIntent để thu thập phương thức thanh toán.
`download_invoice`	Đọc	Tải xuống hóa đơn dưới dạng PDF.
`get_billing_info`	Đọc	Lấy ảnh chụp nhanh đầy đủ về thanh toán cho tổ chức.
`get_current_usage`	Đọc	Lấy mức sử dụng chưa lập hóa đơn của kỳ thanh toán hiện tại.
`get_stripe_config`	Đọc	Lấy cấu hình phía máy khách của Stripe.
`list_billing_plans`	Đọc	Liệt kê tất cả các gói đăng ký có sẵn kèm giá và tính năng.
`list_inference_history`	Đọc	Liệt kê lịch sử yêu cầu suy luận / xác minh AI của tổ chức.
`list_invoices`	Đọc	Liệt kê các hóa đơn của tổ chức, hóa đơn mới nhất trước.
`topup_balance`	Ghi	Thêm tiền trả trước vào số dư tài khoản qua thẻ đã lưu.
`update_company_details`	Ghi	Cập nhật thông tin công ty / lập hóa đơn của tổ chức.
`validate_vat_number`	Đọc	Xác thực mã số VAT của EU qua tra cứu bên ngoài.

topup_balance tính bằng đô la Mỹ, tối thiểu $10, tối đa $10.000 cho mỗi lần nạp.

Người dùng & Tài khoản (7)

Công cụ	Quyền truy cập	Mô tả
`activate_trial`	Ghi	Lưu phương thức thanh toán và kích hoạt dùng thử miễn phí 7 ngày với tín dụng $10.
`add_passkey`	Ghi	Bắt đầu thêm khóa truy cập (passkey) vào tài khoản của người dùng đã xác thực: lấy tùy chọn tạo WebAuthn.
`delete_passkey`	Phá hủy	Xóa một khóa truy cập của người dùng đã xác thực.
`get_current_user`	Đọc	Lấy người dùng đã xác thực, tổ chức của họ và số liệu tài khoản nhanh.
`list_passkeys`	Đọc	Liệt kê các khóa truy cập đã đăng ký của người dùng đã xác thực.
`report_public_data`	Ghi	Báo cáo dữ liệu không chính xác trong hồ sơ công khai của người dùng đã xác thực.
`submit_onboarding_survey`	Ghi	Lưu khảo sát giới thiệu tổ chức của người dùng hiện tại.

Trang web (8)

Công cụ	Quyền truy cập	Mô tả
`create_website`	Ghi	Tạo cấu hình trang web xác minh độ tuổi mới.
`delete_website`	Phá hủy	Xóa vĩnh viễn cấu hình trang web xác minh độ tuổi.
`get_website`	Đọc	Lấy một trang web xác minh độ tuổi theo ID.
`list_countries`	Đọc	Liệt kê tất cả các quốc gia kèm mã và thuộc tính.
`list_verifications`	Đọc	Duyệt lịch sử xác minh độ tuổi cho tổ chức.
`list_websites`	Đọc	Liệt kê mọi trang web xác minh độ tuổi cho tổ chức đã xác thực.
`pause_website`	Ghi	Tạm dừng hoặc tiếp tục xác minh độ tuổi cho một trang web.
`update_website`	Ghi	Cập nhật cấu hình trang web xác minh độ tuổi hiện có.

Kiểm tra Agemin (3)

Công cụ	Quyền truy cập	Mô tả
`get_age_verification_status`	Đọc	Kiểm tra lại kết quả xác minh độ tuổi trước đó ở phía máy chủ.
`verify_age_with_email`	Ghi	Ước tính độ tuổi tối thiểu của một người từ địa chỉ email của họ.
`verify_age_with_selfie`	Ghi	Ước tính độ tuổi của một người từ một ảnh selfie duy nhất.

Phiên xác minh (16)

Công cụ	Quyền truy cập	Mô tả
`cancel_session`	Hủy	Hủy / dừng một phiên.
`check_email_verification`	Đọc	Hoàn tất xác minh email bằng mã.
`check_phone_verification`	Đọc	Hoàn tất xác minh điện thoại bằng mã SMS.
`complete_liveness`	Ghi	Hoàn tất quá trình chụp kiểm tra độ sống của khuôn mặt.
`create_session`	Ghi	Tạo một phiên xác minh danh tính mới.
`get_session`	Đọc	Hiển thị thông tin về một phiên đang mở.
`get_session_preflight`	Đọc	Lấy bước xác minh tiếp theo cho một phiên.
`give_session_consent`	Ghi	Ghi lại quyết định đồng ý của người nộp đơn.
`send_session_sms`	Ghi	Gửi SMS cho người nộp đơn một liên kết để tiếp tục trên điện thoại của họ.
`start_email_verification`	Ghi	Bắt đầu xác minh email bằng cách gửi email một mã.
`start_liveness`	Ghi	Bắt đầu quá trình chụp kiểm tra độ sống của khuôn mặt.
`start_phone_verification`	Ghi	Bắt đầu xác minh điện thoại bằng cách nhắn tin một mã.
`submit_address_verification`	Ghi	Tải lên tài liệu xác minh địa chỉ.
`submit_funds_verification`	Ghi	Tải lên tài liệu xác minh nguồn tiền.
`update_session`	Ghi	Cập nhật chi tiết người nộp đơn của một phiên đang mở.
`upload_session_media`	Ghi	Tải lên phương tiện đã chụp vào một phiên.

Khóa API (3)

Công cụ	Quyền truy cập	Mô tả
`get_api_key`	Đọc	Truy xuất giá trị ĐẦY ĐỦ, không bị che của một khóa API hiện có.
`list_api_keys`	Đọc	Liệt kê tất cả các khóa API cho tổ chức đã xác thực.
`rotate_api_key`	Hủy	Xoay vòng (tạo lại) một khóa API cho tổ chức đã xác thực.

list_api_keys trả về các giá trị bị che; chỉ get_api_key tiết lộ bí mật đầy đủ, vì vậy hãy giữ xác nhận bật cho nó trong các ngữ cảnh dùng chung. rotate_api_key giữ khóa cũ có hiệu lực trong khoảng thời gian gia hạn 12 giờ theo mặc định; truyền immediate: true để thu hồi ngay lập tức.

NFC (1)

Công cụ	Quyền truy cập	Mô tả
`submit_nfc_data`	Ghi	Gửi dữ liệu tài liệu nhận dạng quét NFC đến một phiên xác minh.

Máy chủ & Tự khám phá (2)

Công cụ	Quyền truy cập	Mô tả
`describe_api`	Đọc	Trả về đặc tả OpenAPI 3.0 của REST API Bynn (từ /openapi.json).
`describe_cli`	Đọc	Trả về hướng dẫn cài đặt, xác thực và sử dụng cho CLI Bynn (`bynn`).

Tiện ích tương tác

Hai nhóm công cụ trả về thẻ tương tác thay vì JSON thô trong các máy chủ hỗ trợ ứng dụng MCP (ChatGPT và Claude):

Gian lận tài liệu (submit_document, get_document): một thẻ báo cáo trực tiếp với đồng hồ đo rủi ro, tín hiệu pháp y, các trường được trích xuất và thẻ rủi ro. Các phân tích đang chờ xử lý tự thăm dò đến khi hoàn tất.
Kiểm tra ảnh AI (detect_ai_generated_image): thẻ phán quyết với xác suất AI và phân tích trình tạo. Nếu không có ảnh nào được cung cấp, thẻ hiển thị bộ tải lên kéo-và-thả, và tệp được thả sẽ đi thẳng đến bộ phát hiện mà không vào ngữ cảnh trò chuyện.

Các máy khách MCP khác chỉ đơn giản nhận cùng dữ liệu dưới dạng JSON có cấu trúc.

Quy trình làm việc ví dụ

Một phiên KYC hoàn chỉnh, được điều khiển theo kiểu trò chuyện:

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

Mẫu không đồng bộ giống nhau ở mọi nơi: các công cụ tạo trả về một id, các công cụ get_* thăm dò nó. Đối với gian lận tài liệu, submit_document → get_document cho đến khi status: "analyzed"; đối với các công việc suy luận, create_reasoning_job → get_reasoning_job.

CLI Bynn: làm việc với các tệp cục bộ

Máy chủ MCP được lưu trữ không thể đọc các tệp trên máy của bạn. CLI Bynn có thể. Các tác nhân chạy cục bộ (Claude Code, Cursor, một thiết bị đầu cuối) có thể phân tích các tệp cục bộ trực tiếp:

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

Cài đặt (macOS/Linux):

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

Cài đặt (Windows):

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

Tải xuống trực tiếp (cộng với .deb/.rpm và tổng kiểm tra) có trên trang phát hành.

Xác thực một lần (bynn auth login lưu khóa trong chuỗi khóa hệ điều hành của bạn), hoặc không tương tác với BYNN_API_KEY, --token, hoặc bynn auth login --with-token. Các khóa sandbox (private_sandbox_...) được nhận dạng tự động.

Thân thiện với tác nhân theo thiết kế: -o json cho đầu ra có cấu trúc, --jq để lọc, --dry-run để xem trước các yêu cầu, --poll cho kết quả không đồng bộ và một hợp đồng đầu ra sạch (stdout = dữ liệu, stderr = tiến trình). Cây lệnh được tạo từ đặc tả Bynn OpenAPI trực tiếp, và bynn api <METHOD> <PATH> là một đường truyền trực tiếp đã xác thực thô đến bất kỳ điểm cuối nào. CLI bao gồm các phiên, xác minh độ tuổi, lời mời AutoDoc, tài liệu, kiểm duyệt, NFC và khuôn mặt; để thanh toán, khóa API, hồ sơ, bộ điều phối và trang web, hãy sử dụng máy chủ MCP này.

Dành cho tác nhân: gọi công cụ describe_cli trên máy chủ này để lấy toàn bộ hướng dẫn này ở dạng có thể đọc bằng máy.

Tự khám phá cho tác nhân

Máy chủ tự ghi lại chính nó. Nếu bạn là một LLM được kết nối với nó:

describe_api trả về đặc tả Bynn OpenAPI 3.0 hoàn chỉnh: mọi điểm cuối, tham số và lược đồ, bao gồm cả những cái không được bọc dưới dạng công cụ MCP. Không cần xác thực.
describe_cli trả về một hướng dẫn có cấu trúc để cài đặt, xác thực và chạy CLI bynn cục bộ, để làm việc với các tệp cục bộ. Không cần xác thực.
file://server/status (tài nguyên MCP) trả về danh sách công cụ trực tiếp và trạng thái máy chủ.

Những điều này cũng được công bố trong các hướng dẫn initialize của máy chủ, vì vậy bạn không cần README này để tìm chúng.

Nâng cao

Chú thích và hợp đồng phản hồi

Mọi công cụ đều mang MCP ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), được áp dụng nhất quán theo động từ: get_*/list_*/ search_*/describe_*/download_*/validate_* chỉ đọc; delete_*/cancel_*/ rotate_api_key là hủy. Các lỗi trả về dưới dạng tải trọng {error: true, error_type, message} có cấu trúc thay vì lỗi giao thức, vì vậy các tác nhân có thể đọc và phản ứng với chúng.

Xử lý sự cố

Triệu chứng	Khắc phục
404 / kết nối thất bại ngay lập tức	Bạn đã thêm `/mcp` vào URL. Điểm cuối là gốc: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	Lấy mã thông báo tại dashboard.bynn.com/authenticate và đặt nó làm tiêu đề `Authorization`. Đừng thử lại một cách mù quáng.
Một công cụ trả về 401 với kết nối hợp lệ	Loại thông tin xác thực sai cho nhóm công cụ đó; xem bảng xác thực. Khóa API và thanh toán cần mã thông báo bảng điều khiển, không phải khóa `private_` thô.
Công cụ hình ảnh nói rằng không có hình ảnh nào được cung cấp	Thẻ xuất hiện chấp nhận kéo-và-thả; thả hình ảnh vào đó. Hoặc truyền một `image_url` công khai.
Tài liệu bị kẹt trong `pending`	Phân tích không đồng bộ; thăm dò `get_document` cho đến khi `status` là `analyzed`. Đừng thăm dò thường xuyên hơn vài giây một lần.
Trình kết nối OAuth ngừng hoạt động	Ngắt kết nối và kết nối lại trình kết nối để chạy lại luồng đăng nhập.

Hỗ trợ

Các vấn đề và câu hỏi: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

Được cấp phép MIT.