Bynn Intelligence

공식

문서 사기 탐지 (이미지, PDF)

Bynn Intelligence MCP(으)로 무엇을 할 수 있나요?

AI 생성 이미지 감지 — 어시스턴트에게 이미지가 AI 생성인지 확인하도록 요청하고, detect_ai_generated_image를 통해 판정, 확률, 및 예상 생성기를 반환받습니다.
문서 사기 분석 실행 — 은행 거래 내역서나 송장을 제출하여 법의학적 사기 분석을 수행하고, 위험 평가가 완료될 때까지 get_document를 폴링합니다.
KYC 인증 세션 생성 — 호스팅된 링크가 포함된 신원 확인 세션을 생성한 다음, get_session_preflight 및 get_session을 통해 진행 상황을 추적합니다.
사진에서 나이 추정 — 셀카나 이미지에서 사람의 나이를 확인하며, verify_age_from_selfie를 통해 라이브니스 검사 및 법적 연령 임계값 옵션을 제공합니다.
컬렉션에서 얼굴 검색 — 얼굴을 컬렉션에 등록하고, search_faces를 사용하여 프로브 이미지로 검색해 일치 항목을 찾습니다.
AutoDoc 워크플로 관리 — 문서 수집 워크플로, 도시에 및 사람이 개입하는 승인을 생성, 복제, 모니터링합니다.

문서

Bynn MCP

Bynn MCP를 지원하는 모든 MCP 호환 AI 클라이언트를 Bynn에 연결하세요: 신원 확인(KYC), 문서 위조 탐지, 연령 확인, 콘텐츠 모더레이션, 얼굴 검색, AutoDoc 워크플로우, 사기 추론 에이전트, 계정 관리. Bynn API를 통한 143개의 도구, 한 번의 연결로 사용 가능. Claude(claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf, Zed에서 작동합니다.

https://mcp.bynn.com

엔드포인트는 루트 경로입니다. /mcp를 추가하지 마세요. https://mcp.bynn.com/mcp는 작동하지 않습니다. 유일한 다른 경로는 GET /health입니다.

빠른 시작 (30초)

Claude Code:

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

Claude 또는 ChatGPT(호스팅): https://mcp.bynn.com를 사용자 지정 커넥터로 추가하고 브라우저가 열리면 Bynn 계정으로 로그인하세요. 키 처리 없이 사용할 수 있습니다.

API 스타일 클라이언트: dashboard.bynn.com/authenticate에서 토큰을 받아 연결 시 Authorization: Bearer <token>로 전송하세요.

그런 다음 첫 번째 프롬프트를 시도하세요:

Check whether this image is AI-generated.

이미지를 첨부하면 결과가 평결, AI 확률, 가장 가능성 높은 생성자와 함께 대화형 카드로 렌더링됩니다.

예시 프롬프트

사기 및 문서

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.

검증

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.

모더레이션 및 미디어

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

계정 및 운영

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.

문서 위조 및 AI 이미지 결과는 ChatGPT와 Claude 모두에서 대화형 카드로 렌더링됩니다 (대화형 위젯 참조).

설치

Claude Code

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

Claude Desktop 및 claude.ai

설정 → 커넥터 → 사용자 지정 커넥터 추가 → URL https://mcp.bynn.com. 첫 사용 시 OAuth 로그인이 자동으로 시작됩니다.

ChatGPT

설정 → 앱 및 커넥터 → 개발자 모드 활성화 → 만들기 → MCP 서버 URL https://mcp.bynn.com. Bynn은 ChatGPT 앱으로 구축되었습니다: 사기 보고서와 AI 이미지 검사가 대화형 카드로 렌더링되며, 첨부된 이미지는 기본적으로 도구로 전달됩니다.

Cursor

위의 한 번의 클릭으로 추가하거나, ~/.cursor/mcp.json(또는 프로젝트별 .cursor/mcp.json)에 수동으로 추가하세요:

{
  "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 브리지를 통해 연결됩니다:

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

인증

OAuth 2.1 (커넥터)

호스팅 커넥터(Claude, ChatGPT)는 OAuth 2.1 + PKCE로 인증합니다. 인증 서버는 dashboard.bynn.com입니다. MCP 클라이언트가 브라우저 로그인을 열면 요청된 권한을 승인하고 클라이언트가 Bynn 대시보드 사용자로 연결됩니다. 동적 클라이언트 등록을 지원하는 클라이언트(Claude, Cursor)는 자동으로 등록됩니다.

Bearer 토큰 (API 스타일 클라이언트)

서버 측, 스크립트, 또는 자체 호스팅 사용의 경우 MCP 연결에 인증 헤더를 전송하세요:

Authorization: Bearer <token>

dashboard.bynn.com/authenticate에서 토큰을 받으세요. 세 가지 토큰 유형이 작동합니다:

토큰	접두사	할 수 있는 작업
대시보드 토큰 (JWT)	없음	모든 것. 도구가 API 키를 필요로 할 때 서버가 자동으로 조직의 키로 JWT를 교환합니다.
비공개 API 키	`private_...`	제품 및 검증 도구(문서, 모더레이션, 연령 결과). API 키나 청구와 같은 대시보드 도구에는 충분하지 않습니다.
공개 API 키	`public_...`	클라이언트 안전 세션 생성 (`create_session`, `create_age_verification_session`).

도구 그룹별:

도구 그룹	최소 자격 증명
API 키, 청구, 사용자, AutoDoc, 추론, 웹사이트	대시보드 토큰 (JWT)
문서, 모더레이션, 얼굴, NFC	비공개 키 또는 JWT
`create_session`, `create_age_verification_session`	공개 키 또는 JWT
`verify_age_from_selfie`, `get_age_verification_result`	비공개 키 또는 JWT
세션 단계 (동의, 사전 점검, 라이브니스, 업로드)	없음: URL의 세션 토큰이 자격 증명입니다

비공개 키는 신뢰할 수 있는 서버 측 환경에서만 사용하세요. 프런트엔드 코드, 공개 저장소, 공유 채팅에 절대 노출하지 마세요.

토큰을 사용한 예시 클라이언트 구성

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

export BYNN_API_KEY="private_your_bynn_key_here"

도구 참조 (143개 도구)

접근 배지: 읽기 = 안전, 비변경. 쓰기 = 데이터 생성 또는 변경. 파괴적 = 삭제, 취소, 또는 해지 (delete_*, cancel_*, rotate_api_key); 이러한 도구에 대해 클라이언트에서 확인을 활성화하세요. 모든 도구는 또한 기계 판독 가능한 readOnlyHint / destructiveHint 주석을 포함하므로 MCP 클라이언트가 자동으로 게이트할 수 있습니다.

문서 (4)

도구	접근	설명
`delete_document`	파괴적	문서 제출을 삭제합니다.
`get_document`	읽기	문서 제출 및 포렌식 분석 결과를 검색합니다.
`list_documents`	읽기	문서 제출을 나열하고 검색합니다.
`submit_document`	쓰기	전체 사기 / 진위 분석을 위해 문서를 제출합니다.

문서 분석은 비동기식입니다: submit_document, 그런 다음 get_document을 폴링하여 status가 analyzed이 될 때까지 기다립니다.

연령 확인 (5)

도구	접근	설명
`complete_age_verification_liveness`	쓰기	라이브니스 캡처를 완료합니다.
`create_age_verification_session`	쓰기	새 라이브니스 연령 확인 세션을 생성합니다.
`get_age_verification_result`	읽기	라이브니스 연령 확인 세션의 결과를 읽습니다.
`start_age_verification_liveness`	쓰기	세션의 라이브니스 캡처를 시작합니다.
`verify_age_from_selfie`	쓰기	라이브니스 없이 단일 셀카에서 연령을 추정합니다.

verify_age_from_selfie는 age_verification_model 임계값(21, 18, 그 이하, 기본값 18)과 legal_age_21 관할권 플래그를 사용합니다. 라이브니스 흐름은: 세션 생성 → 라이브니스 시작 → 라이브니스 완료 → 결과 가져오기입니다.

콘텐츠 모더레이션 (12)

도구	접근	설명
`check_age`	쓰기	이미지에서 얼굴의 연령을 추정합니다 (연령 확인 / 미성년자 감지).
`create_moderation_inference`	쓰기	모더레이션 / AI 감지 추론을 실행합니다.
`detect_ai_generated_image`	쓰기	이미지가 AI 생성인지 실제 사진인지 확인합니다.
`get_moderation_dashboard_stats`	읽기	조직의 모더레이션 대시보드 통계를 가져옵니다.
`get_moderation_inference`	읽기	ID로 과거 모더레이션 추론을 검색합니다.
`get_moderation_model`	읽기	전체 문서와 함께 하나의 모더레이션 모델을 가져옵니다.
`list_all_moderation_models`	읽기	모든 유형의 모든 공개 모더레이션 모델을 나열합니다.
`list_audio_moderation_models`	읽기	오디오 모더레이션 모델을 카테고리별로 그룹화하여 나열합니다.
`list_image_moderation_models`	읽기	이미지 모더레이션 모델을 카테고리별로 그룹화하여 나열합니다.
`list_text_moderation_models`	읽기	텍스트 모더레이션 모델을 카테고리별로 그룹화하여 나열합니다.
`list_video_moderation_models`	읽기	비디오 모더레이션 모델을 카테고리별로 그룹화하여 나열합니다.
`public_moderation_inference`	쓰기	무료 공개 AI 감지 추론을 실행합니다, 자격 증명 불필요.

detect_ai_generated_image는 result.is_ai_generated(평결), ai_probability, uncertain, top_generator, generators, c2pa_signer, 그리고 detection_mode을 반환합니다. check_age는 얼굴별 age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty, 그리고 bbox을 반환합니다.

얼굴 검색 (6)

도구	접근	설명
`create_face_collection`	쓰기	새 얼굴 컬렉션을 생성합니다.
`delete_face`	파괴적	컬렉션에서 단일 등록 얼굴을 삭제합니다.
`delete_face_collection`	파괴적	얼굴 컬렉션과 모든 등록된 얼굴을 삭제합니다.
`enroll_face`	쓰기	컬렉션에 단일 얼굴을 등록합니다.
`list_face_collections`	읽기	조직의 얼굴 컬렉션을 나열합니다.
`search_faces`	읽기	프로브 이미지와 유사한 얼굴을 컬렉션에서 검색합니다.

AutoDoc (37)

도구	액세스	설명
`add_dossier_note`	쓰기	도시에 관리자 메모를 추가합니다.
`approve_approval`	쓰기	대기 중인 HITL 승인을 승인합니다.
`attach_dossier_tag`	쓰기	도시에 조직 태그를 연결합니다.
`create_document_collection`	쓰기	문서 컬렉션을 생성합니다.
`create_invitation`	쓰기	이메일 또는 SMS로 AutoDoc 초대장을 보냅니다.
`create_organization_tag`	쓰기	조직 태그를 생성합니다.
`create_workflow`	쓰기	워크플로우를 생성합니다.
`delete_document_collection`	파괴적	문서 컬렉션을 삭제합니다(소프트 삭제).
`delete_invitation`	파괴적	대기 중인 AutoDoc 초대장을 취소(하드 삭제)합니다.
`delete_organization_tag`	파괴적	조직 태그를 삭제합니다.
`delete_workflow`	파괴적	워크플로우를 삭제합니다(소프트 삭제).
`detach_dossier_tag`	쓰기	도시에서 조직 태그를 분리합니다.
`download_dossier_zip`	읽기	도시의 문서 + 변수를 ZIP으로 패키징합니다.
`duplicate_workflow`	쓰기	워크플로우를 복제합니다.
`get_autodoc_dashboard_stats`	읽기	집계된 AutoDoc 대시보드 통계를 가져옵니다.
`get_document_collection`	읽기	하나의 문서 컬렉션과 그 요구사항을 가져옵니다.
`get_dossier`	읽기	진행 상황과 워크플로우 변수가 포함된 하나의 도시를 가져옵니다.
`get_dossier_form_fields`	읽기	활성 워크플로우에서 사용 가능한 양식 필드 이름을 나열합니다.
`get_invitation`	읽기	단일 AutoDoc 초대장을 가져옵니다.
`get_pending_approval_count`	읽기	대기 중인 HITL 승인 수를 가져옵니다.
`get_workflow`	읽기	단일 워크플로우를 가져옵니다.
`list_approvals`	읽기	인간-루프 워크플로우 승인을 나열합니다.
`list_document_collections`	읽기	조직의 문서 컬렉션을 나열합니다.
`list_document_types`	읽기	컬렉션 요구사항에 사용 가능한 문서 유형을 나열합니다.
`list_dossier_documents`	읽기	도시에 업로드된 문서를 나열합니다.
`list_dossier_notes`	읽기	도시의 메모 / 감사 타임라인을 나열합니다.
`list_dossiers`	읽기	AutoDoc 도시를 나열하고 필터링합니다.
`list_invitation_locales`	읽기	지원되는 초대장 로케일을 나열합니다.
`list_invitations`	읽기	AutoDoc 초대장을 나열합니다.
`list_organization_tags`	읽기	조직의 도시 태그를 나열합니다.
`list_workflows`	읽기	조직의 워크플로우를 나열합니다.
`reject_approval`	쓰기	대기 중인 HITL 승인을 거부합니다.
`resend_invitation`	쓰기	AutoDoc 초대장을 다시 보냅니다.
`update_document_collection`	쓰기	문서 컬렉션과 (선택적으로) 그 요구사항을 업데이트합니다.
`update_dossier`	쓰기	도시 이름을 변경합니다.
`update_organization_tag`	쓰기	조직 태그의 색상 및/또는 이름을 업데이트합니다.
`update_workflow`	쓰기	워크플로우를 업데이트합니다.

추론 및 사기 에이전트 (25)

도구	액세스	설명
`create_fraud_agent`	쓰기	사기 분석 에이전트 / 운영자를 생성합니다.
`create_orchestrator`	쓰기	오케스트레이터(조정자) 에이전트를 생성합니다.
`create_reasoning_job`	쓰기	문서에 대한 비동기 사기 추론 작업을 대기열에 넣습니다.
`delete_fraud_agent`	파괴적	사기 분석 에이전트 / 운영자를 삭제합니다.
`delete_orchestrator`	파괴적	오케스트레이터 에이전트를 삭제합니다.
`generate_fraud_agent_prompt`	쓰기	AI로 사기 분석 에이전트 시스템 프롬프트를 초안 작성합니다.
`generate_orchestrator_prompt`	쓰기	AI로 오케스트레이터 시스템 프롬프트를 초안 작성합니다.
`get_agent`	읽기	토큰으로 단일 에이전트(오케스트레이터 또는 운영자)를 가져옵니다.
`get_agent_stats`	읽기	조직의 집계 에이전트 통계를 가져옵니다.
`get_reasoning_job`	읽기	추론 작업의 상태와 전체 결과를 가져옵니다.
`list_agent_categories`	읽기	사용 가능한 에이전트 카테고리 옵션을 나열합니다.
`list_agent_ratings`	읽기	공개 에이전트의 평점 및 평점 요약을 나열합니다.
`list_document_content_types`	읽기	문서 콘텐츠 유형과 이미 클레임된 유형을 나열합니다.
`list_fraud_agents`	읽기	조직의 사기 분석 에이전트 / 운영자를 나열합니다.
`list_orchestrators`	읽기	조직의 오케스트레이터 에이전트를 나열합니다.
`list_public_fraud_agents`	읽기	글로벌 커뮤니티의 공개 사기 분석 에이전트 템플릿을 탐색합니다.
`list_public_orchestrators`	읽기	글로벌 커뮤니티의 공개 오케스트레이터 템플릿을 탐색합니다.
`list_reasoning_jobs`	읽기	필터 및 조직 전체 통계로 추론 작업을 나열합니다.
`publish_agent`	쓰기	에이전트 중 하나를 공개 커뮤니티 마켓플레이스에 게시합니다.
`rate_agent`	쓰기	공개 에이전트를 1-5점으로 평가합니다.
`reorder_orchestrator_agents`	쓰기	오케스트레이터에 할당된 사기 분석 에이전트를 재정렬합니다.
`test_orchestrator`	쓰기	기존 문서에 대해 오케스트레이터를 동기식으로 실행합니다.
`unpublish_agent`	쓰기	공개 마켓플레이스에서 에이전트 중 하나를 제거합니다.
`update_fraud_agent`	쓰기	사기 분석 에이전트 / 운영자를 업데이트합니다.
`update_orchestrator`	쓰기	오케스트레이터 에이전트를 업데이트합니다.

청구 (14)

도구	액세스	설명
`cancel_billing_plan`	파괴적	현재 구독의 취소를 예약합니다.
`change_billing_plan`	쓰기	조직의 구독 요금제를 변경합니다.
`confirm_payment_method`	쓰기	확인된 카드를 기본 결제 수단으로 저장합니다.
`create_setup_intent`	쓰기	결제 수단을 수집하기 위해 Stripe SetupIntent를 생성합니다.
`download_invoice`	읽기	인보이스를 PDF로 다운로드합니다.
`get_billing_info`	읽기	조직의 전체 청구 스냅샷을 가져옵니다.
`get_current_usage`	읽기	현재 청구 기간의 청구되지 않은 사용량을 가져옵니다.
`get_stripe_config`	읽기	Stripe 클라이언트 측 구성을 가져옵니다.
`list_billing_plans`	읽기	가격 및 기능이 포함된 모든 사용 가능한 구독 요금제를 나열합니다.
`list_inference_history`	읽기	조직의 AI 추론 / 검증 요청 기록을 나열합니다.
`list_invoices`	읽기	조직의 인보이스를 최신순으로 나열합니다.
`topup_balance`	쓰기	저장된 카드로 계정 잔액에 선불 자금을 추가합니다.
`update_company_details`	쓰기	조직의 회사 / 청구 세부 정보를 업데이트합니다.
`validate_vat_number`	읽기	외부 조회를 통해 EU VAT 번호를 검증합니다.

topup_balance은(는) 미국 달러 기준이며, 충전당 최소 $10, 최대 $10,000입니다.

사용자 및 계정 (7)

도구	액세스	설명
`activate_trial`	쓰기	결제 수단을 저장하고 $10 크레딧이 포함된 7일 무료 평가판을 활성화합니다.
`add_passkey`	쓰기	인증된 사용자 계정에 패스키 추가를 시작합니다: WebAuthn 생성 옵션을 가져옵니다.
`delete_passkey`	파괴적	인증된 사용자의 패스키 중 하나를 삭제합니다.
`get_current_user`	읽기	인증된 사용자, 해당 조직 및 빠른 계정 통계를 가져옵니다.
`list_passkeys`	읽기	인증된 사용자의 등록된 패스키를 나열합니다.
`report_public_data`	쓰기	인증된 사용자의 공개 프로필에서 잘못된 데이터를 신고합니다.
`submit_onboarding_survey`	쓰기	현재 사용자의 조직 온보딩 설문조사를 저장합니다.

웹사이트 (8)

도구	액세스	설명
`create_website`	쓰기	새로운 연령 확인 웹사이트 구성을 생성합니다.
`delete_website`	파괴적	연령 확인 웹사이트 구성을 영구적으로 삭제합니다.
`get_website`	읽기	ID로 하나의 연령 확인 웹사이트를 가져옵니다.
`list_countries`	읽기	코드 및 속성이 포함된 모든 국가를 나열합니다.
`list_verifications`	읽기	조직의 연령 확인 기록을 탐색합니다.
`list_websites`	읽기	인증된 조직의 모든 연령 확인 웹사이트를 나열합니다.
`pause_website`	쓰기	웹사이트의 연령 확인을 일시 중지하거나 재개합니다.
`update_website`	쓰기	기존 연령 확인 웹사이트 구성을 업데이트합니다.

Agemin 검사 (3)

도구	접근 권한	설명
`get_age_verification_status`	읽기	이전 연령 확인 결과를 서버 측에서 다시 검증합니다.
`verify_age_with_email`	쓰기	이메일 주소로 개인의 최소 연령을 추정합니다.
`verify_age_with_selfie`	쓰기	단일 셀카 이미지로 개인의 연령을 추정합니다.

검증 세션 (16)

도구	접근 권한	설명
`cancel_session`	파괴적	세션을 취소/중단합니다.
`check_email_verification`	읽기	코드로 이메일 검증을 완료합니다.
`check_phone_verification`	읽기	SMS 코드로 전화번호 검증을 완료합니다.
`complete_liveness`	쓰기	얼굴 실시간 감지 캡처를 완료합니다.
`create_session`	쓰기	새 신원 확인 세션을 생성합니다.
`get_session`	읽기	열린 세션에 대한 정보를 표시합니다.
`get_session_preflight`	읽기	세션의 다음 검증 단계를 가져옵니다.
`give_session_consent`	쓰기	신청자의 동의 결정을 기록합니다.
`send_session_sms`	쓰기	신청자에게 휴대폰에서 계속할 수 있는 링크를 SMS로 보냅니다.
`start_email_verification`	쓰기	코드를 이메일로 보내 이메일 검증을 시작합니다.
`start_liveness`	쓰기	얼굴 실시간 감지 캡처를 시작합니다.
`start_phone_verification`	쓰기	코드를 문자로 보내 전화번호 검증을 시작합니다.
`submit_address_verification`	쓰기	주소 증명 문서를 업로드합니다.
`submit_funds_verification`	쓰기	자금 증명 문서를 업로드합니다.
`update_session`	쓰기	열린 세션의 신청자 세부 정보를 업데이트합니다.
`upload_session_media`	쓰기	캡처된 미디어를 세션에 업로드합니다.

API 키 (3)

도구	접근 권한	설명
`get_api_key`	읽기	기존 API 키의 전체(마스킹되지 않은) 값을 검색합니다.
`list_api_keys`	읽기	인증된 조직의 모든 API 키를 나열합니다.
`rotate_api_key`	파괴적	인증된 조직의 API 키를 회전(재생성)합니다.

list_api_keys는 마스킹된 값을 반환합니다. 전체 비밀 키를 공개하는 것은 get_api_key뿐이므로, 공유 환경에서는 이에 대한 확인을 유지하세요. rotate_api_key는 기본적으로 이전 키를 12시간 유예 기간 동안 유효하게 유지합니다. 즉시 폐기하려면 immediate: true를 전달하세요.

NFC (1)

도구	접근 권한	설명
`submit_nfc_data`	쓰기	NFC로 스캔한 신분증 데이터를 검증 세션에 제출합니다.

서버 및 자체 검색 (2)

도구	접근 권한	설명
`describe_api`	읽기	Bynn REST API의 OpenAPI 3.0 사양을 반환합니다(/openapi.json에서).
`describe_cli`	읽기	Bynn CLI(`bynn`)의 설치, 인증 및 사용 지침을 반환합니다.

대화형 위젯

두 도구 계열은 MCP 앱(ChatGPT 및 Claude)을 지원하는 호스트에서 원시 JSON 대신 대화형 카드를 반환합니다:

문서 사기 (submit_document, get_document): 위험 게이지, 포렌식 신호, 추출된 필드 및 위험 태그가 포함된 실시간 보고서 카드입니다. 보류 중인 분석은 완료될 때까지 자체적으로 폴링합니다.
AI 이미지 확인 (detect_ai_generated_image): AI 확률 및 생성기 분석이 포함된 판정 카드입니다. 이미지가 제공되지 않은 경우 카드는 드래그 앤 드롭 업로더를 렌더링하며, 드롭된 파일은 채팅 컨텍스트에 들어가지 않고 감지기로 직접 전송됩니다.

다른 MCP 클라이언트는 동일한 데이터를 구조화된 JSON으로 받습니다.

예제 워크플로

대화형으로 진행되는 완전한 KYC 세션:

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

비동기 패턴은 모든 곳에서 동일합니다: 생성 도구는 ID를 반환하고, get_* 도구는 이를 폴링합니다. 문서 사기의 경우 submit_document → get_document를 status: "analyzed"이 될 때까지 반복합니다. 추론 작업의 경우 create_reasoning_job → get_reasoning_job을 사용합니다.

Bynn CLI: 로컬 파일 작업

호스팅된 MCP 서버는 사용자 컴퓨터의 파일을 읽을 수 없습니다. Bynn CLI는 읽을 수 있습니다. 로컬에서 실행되는 에이전트(Claude Code, Cursor, 터미널)는 로컬 파일을 직접 분석할 수 있습니다:

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

설치(macOS/Linux):

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

설치(Windows):

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

직접 다운로드(및 .deb/.rpm 및 체크섬)는 릴리스 페이지에서 확인할 수 있습니다.

한 번 인증하면(bynn auth login는 OS 키체인에 키를 저장합니다), 또는 BYNN_API_KEY, --token, bynn auth login --with-token로 비대화형으로 인증할 수 있습니다. 샌드박스 키(private_sandbox_...)는 자동으로 인식됩니다.

에이전트 친화적으로 설계되었습니다: 구조화된 출력을 위한 -o json, 필터링을 위한 --jq, 요청 미리보기를 위한 --dry-run, 비동기 결과를 위한 --poll, 그리고 깔끔한 출력 계약 (stdout = 데이터, stderr = 진행 상황)을 제공합니다. 명령 트리는 라이브 Bynn OpenAPI 사양에서 생성되며, bynn api <METHOD> <PATH>는 모든 엔드포인트에 대한 원시 인증된 패스스루입니다. CLI는 세션, 연령 확인, AutoDoc 초대, 문서, 모더레이션, NFC 및 얼굴을 다룹니다. 청구, API 키, 도시에, 오케스트레이터 및 웹사이트의 경우 이 MCP 서버를 사용하세요.

에이전트용: 이 서버의 describe_cli 도구를 호출하여 이 전체 가이드를 기계가 읽을 수 있는 형태로 받으세요.

에이전트용 자체 검색

서버는 스스로를 문서화합니다. 연결된 LLM이라면:

describe_api는 완전한 Bynn OpenAPI 3.0 사양을 반환합니다: 모든 엔드포인트, 매개변수 및 스키마(MCP 도구로 래핑되지 않은 것 포함). 인증 불필요.
describe_cli는 로컬 파일 작업을 위해 bynn CLI를 로컬에서 설치, 인증 및 실행하는 방법에 대한 구조화된 가이드를 반환합니다. 인증 불필요.
file://server/status (MCP 리소스)는 라이브 도구 목록과 서버 상태를 반환합니다.

이들은 서버의 initialize 지침에도 공지되므로, 이 README 없이도 찾을 수 있습니다.

고급

주석 및 응답 계약

모든 도구는 MCP ToolAnnotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)을 동사별로 일관되게 적용합니다: get_*/list_*/ search_*/describe_*/download_*/validate_*는 읽기 전용입니다. delete_*/cancel_*/ rotate_api_key는 파괴적입니다. 실패는 프로토콜 오류가 아닌 구조화된 {error: true, error_type, message} 페이로드로 반환되므로, 에이전트가 이를 읽고 대응할 수 있습니다.

문제 해결

증상	해결 방법
404 / 연결이 즉시 실패	URL에 `/mcp`를 추가했습니다. 엔드포인트는 루트입니다: `https://mcp.bynn.com`
`authentication_error` / `authentication_required`	dashboard.bynn.com/authenticate에서 토큰을 받아 `Authorization` 헤더로 설정하세요. 무작정 재시도하지 마세요.
유효한 연결에서 도구가 401을 반환	해당 도구 그룹에 대한 잘못된 자격 증명 유형입니다. 인증 테이블을 참조하세요. API 키 및 청구에는 원시 `private_` 키가 아닌 대시보드 토큰이 필요합니다.
이미지 도구가 이미지가 제공되지 않았다고 표시	표시되는 카드는 드래그 앤 드롭을 지원합니다. 이미지를 카드에 드롭하세요. 또는 공개 `image_url`를 전달하세요.
문서가 `pending`에 멈춤	분석은 비동기식입니다. `get_document`를 `status`이 `analyzed`가 될 때까지 폴링하세요. 몇 초에 한 번 이상 폴링하지 마세요.
OAuth 커넥터가 작동 중지	커넥터를 연결 해제하고 다시 연결하여 로그인 흐름을 다시 실행하세요.

지원

문제 및 질문: github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

MIT 라이선스.