Bynn Intelligence

공식

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

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

AI 생성 이미지 감지 — 어시스턴트에게 detect_ai_generated_image를 통해 이미지가 AI 생성인지 확인하도록 요청하고, 판정 결과, 확률, 예상 생성 도구를 반환받습니다.
문서 사기 분석 실행 — submit_document로 문서를 제출하여 전체 진위 분석을 수행하고, get_document를 폴링하여 법의학 보고서가 준비될 때까지 기다립니다.
KYC 검증 세션 생성 — create_session을 사용하여 신원 확인 흐름을 시작하고, 신청자에게 보낼 호스팅 링크 또는 QR 코드를 받습니다.
셀카로 나이 추정 — verify_age_from_selfie를 호출하여 사람의 나이를 추정하고 18세 또는 21세 같은 기준값과 비교하며, 선택적으로 라이브니스 검증을 포함할 수 있습니다.
컬렉션에서 얼굴 검색 — enroll_face로 얼굴을 등록하고, search_faces를 사용하여 조직의 컬렉션에서 일치 항목을 찾습니다.
API 키 및 결제 관리 — list_api_keys/rotate_api_key로 API 키를 나열, 조회 또는 교체하고, 결제 도구를 통해 사용량 또는 청구서를 확인합니다.

문서

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

Connect any MCP-compatible AI client to Bynn: identity verification (KYC), document fraud detection, age verification, content moderation, face search, AutoDoc workflows, fraud reasoning agents, and account management. 143 tools over the Bynn API, one connection. Works in Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf, and Zed.

https://mcp.bynn.com

The endpoint is the root path. Do not append /mcp; https://mcp.bynn.com/mcp will not work. The only other route is GET /health.

Quick start (30 seconds)

Claude Code:

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

Claude or ChatGPT (hosted): add https://mcp.bynn.com as a custom connector and sign in with your Bynn account when the browser opens. No key handling needed.

API-style clients: get a token at dashboard.bynn.com/authenticate and send it as Authorization: Bearer <token> on the connection.

Then try your first prompt:

Check whether this image is AI-generated.

Attach an image, and the result renders as an interactive card with the verdict, AI probability, and most likely generator.

Example prompts

Fraud and documents

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.

Verification

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.

Moderation and media

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

Account and operations

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.

Document-fraud and AI-image results render as interactive cards in both ChatGPT and Claude (see Interactive widgets).

Installation

Claude Code

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

Claude Desktop and claude.ai

Settings → Connectors → Add custom connector → URL https://mcp.bynn.com. OAuth sign-in starts automatically on first use.

ChatGPT

Settings → Apps & Connectors → enable developer mode → Create → MCP server URL https://mcp.bynn.com. Bynn is built as a ChatGPT app: fraud reports and AI-image checks render as interactive cards, and attached images are forwarded to the tools natively.

Cursor

One click above, or add manually to ~/.cursor/mcp.json (or .cursor/mcp.json per project):

{
  "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 connects through the mcp-remote bridge:

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

Authentication

OAuth 2.1 (connectors)

Hosted connectors (Claude, ChatGPT) authenticate with OAuth 2.1 + PKCE. The authorization server is dashboard.bynn.com; your MCP client opens a browser sign-in, you approve the requested permissions, and the client connects as your Bynn dashboard user. Clients that support Dynamic Client Registration (Claude, Cursor) register automatically.

Bearer tokens (API-style clients)

For server-side, scripted, or self-hosted use, send an authorization header on the MCP connection:

Authorization: Bearer <token>

Get a token at dashboard.bynn.com/authenticate. Three token types work:

Token	Prefix	What it can do
Dashboard token (JWT)	none	Everything. When a tool needs an API key, the server exchanges the JWT for your organization's keys automatically.
Private API key	`private_...`	Product and verification tools (documents, moderation, age results). Not sufficient for dashboard tools like API keys or billing.
Public API key	`public_...`	Client-safe session creation (`create_session`, `create_age_verification_session`).

Per tool group:

Tool group	Minimum credential
API keys, billing, users, AutoDoc, reasoning, websites	Dashboard token (JWT)
Documents, moderation, face, NFC	Private key or JWT
`create_session`, `create_age_verification_session`	Public key or JWT
`verify_age_from_selfie`, `get_age_verification_result`	Private key or JWT
Session steps (consent, preflight, liveness, uploads)	None: the session token in the URL is the credential

Use private keys only in trusted server-side environments. Never expose them in frontend code, public repositories, or shared chats.

Example client configuration with a token

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

export BYNN_API_KEY="private_your_bynn_key_here"

Tools reference (143 tools)

Access badges: Read = safe, non-mutating. Write = creates or changes data. Destructive = deletes, cancels, or revokes (delete_*, cancel_*, rotate_api_key); keep confirmation enabled for these in your client. Every tool also carries machine-readable readOnlyHint / destructiveHint annotations, so MCP clients can gate them automatically.

Documents (4)

Tool	Access	Description
`delete_document`	Destructive	Delete a document submission.
`get_document`	Read	Retrieve a document submission and its forensic analysis result.
`list_documents`	Read	List and search your document submissions.
`submit_document`	Write	Submit a document for full fraud / authenticity analysis.

Document analysis is asynchronous: submit_document, then poll get_document until status is analyzed.

Age Verification (5)

Tool	Access	Description
`complete_age_verification_liveness`	Write	Finalize a liveness capture.
`create_age_verification_session`	Write	Create a new liveness age-verification session.
`get_age_verification_result`	Read	Read the result of a liveness age-verification session.
`start_age_verification_liveness`	Write	Start the liveness capture for a session.
`verify_age_from_selfie`	Write	Estimate age from a single selfie, without liveness.

verify_age_from_selfie takes an age_verification_model threshold (21, 18, and lower, default 18) plus a legal_age_21 jurisdiction flag. The liveness flow is: create session → start liveness → complete liveness → get result.

Content Moderation (12)

Tool	Access	Description
`check_age`	Write	Estimate the age of faces in an image (age verification / minor detection).
`create_moderation_inference`	Write	Run a moderation / AI-detection inference.
`detect_ai_generated_image`	Write	Check whether an image is AI-generated or a real photo.
`get_moderation_dashboard_stats`	Read	Get moderation dashboard statistics for your organization.
`get_moderation_inference`	Read	Retrieve a past moderation inference by its id.
`get_moderation_model`	Read	Get one moderation model with full documentation.
`list_all_moderation_models`	Read	List ALL public moderation models across every type.
`list_audio_moderation_models`	Read	List AUDIO moderation models grouped by category.
`list_image_moderation_models`	Read	List IMAGE moderation models grouped by category.
`list_text_moderation_models`	Read	List TEXT moderation models grouped by category.
`list_video_moderation_models`	Read	List VIDEO moderation models grouped by category.
`public_moderation_inference`	Write	Run a FREE public AI-detection inference, no credential required.

detect_ai_generated_image returns result.is_ai_generated (the verdict), ai_probability, uncertain, top_generator, generators, c2pa_signer, and detection_mode. check_age returns per-face age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty, and bbox.

Face Search (6)

Tool	Access	Description
`create_face_collection`	Write	Create a new face collection.
`delete_face`	Destructive	Delete a single enrolled face from a collection.
`delete_face_collection`	Destructive	Delete a face collection and ALL its enrolled faces.
`enroll_face`	Write	Enroll a single face into a collection.
`list_face_collections`	Read	List your organization's face collections.
`search_faces`	Read	Search a collection for faces similar to a probe image.

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 라이선스.