Bynn Intelligence

официальный

Обнаружение мошенничества с документами (изображение, PDF)

Смотреть на bynn.comПопробовать этот MCPСпонсировано

Что можно делать с Bynn Intelligence MCP?

Detect AI-generated images — Попросите вашего ассистента проверить, является ли изображение сгенерированным ИИ, с помощью detect_ai_generated_image; в ответ вы получите вердикт, вероятность и вероятный генератор.
Run document fraud analysis — Отправьте документ через submit_document для полного анализа подлинности, затем опрашивайте get_document, пока не будет готов судебно-медицинский отчет.
Create KYC verification sessions — Используйте create_session, чтобы запустить процесс проверки личности и получить ссылку для размещения или QR-код для отправки заявителю.
Estimate age from a selfie — Вызовите verify_age_from_selfie, чтобы оценить возраст человека и проверить его по порогу, например 18 или 21, с опциональной проверкой живости.
Search faces in collections — Добавляйте лица с помощью enroll_face и находите совпадения через search_faces в коллекциях вашей организации.
Manage API keys and billing — Просматривайте, получайте или меняйте API-ключи с помощью list_api_keys/rotate_api_key, а также проверяйте использование или счета через инструменты биллинга.

Документация

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

Подключите любой MCP-совместимый ИИ-клиент к Bynn: проверка личности (KYC), обнаружение поддельных документов, проверка возраста, модерация контента, поиск по лицам, рабочие процессы AutoDoc, агенты анализа мошенничества и управление аккаунтом. 143 инструмента через Bynn API, одно подключение. Работает в 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.

Прикрепите изображение, и результат отобразится в виде интерактивной карточки с вердиктом, вероятностью ИИ и наиболее вероятным генератором.

Примеры запросов

Мошенничество и документы

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.

Результаты проверки поддельных документов и ИИ-изображений отображаются в виде интерактивных карточек как в 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

Настройки → Приложения и коннекторы → включите режим разработчика → Создать → URL MCP-сервера https://mcp.bynn.com. Bynn создан как приложение ChatGPT: отчеты о мошенничестве и проверки ИИ-изображений отображаются в виде интерактивных карточек, а прикрепленные изображения передаются в инструменты нативно.

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
Шаги сессии (согласие, предварительная проверка, liveness, загрузки)	Нет: токен сессии в 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`	Запись	Завершить захват liveness.
`create_age_verification_session`	Запись	Создать новую сессию проверки возраста с liveness.
`get_age_verification_result`	Чтение	Прочитать результат сессии проверки возраста с liveness.
`start_age_verification_liveness`	Запись	Начать захват liveness для сессии.
`verify_age_from_selfie`	Запись	Оценить возраст по одному селфи, без liveness.

verify_age_from_selfie принимает порог age_verification_model (21, 18 и ниже, по умолчанию 18) плюс флаг юрисдикции legal_age_21. Поток liveness: создать сессию → начать liveness → завершить liveness → получить результат.

Модерация контента (12)

Инструмент	Доступ	Описание
`check_age`	Запись	Оценить возраст лиц на изображении (проверка возраста / обнаружение несовершеннолетних).
`create_moderation_inference`	Запись	Запустить вывод модерации / ИИ-обнаружения.
`detect_ai_generated_image`	Запись	Проверить, является ли изображение ИИ-сгенерированным или реальным фото.
`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`	Запись	Запустить БЕСПЛАТНЫЙ публичный вывод ИИ-обнаружения, без учетных данных.

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`	Запись	Отправить приглашение AutoDoc по электронной почте или SMS.
`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`	Запись	Составить системный промпт агента анализа мошенничества с помощью ИИ.
`generate_orchestrator_prompt`	Запись	Составить системный промпт оркестратора с помощью ИИ.
`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`	Чтение	Перечислить историю запросов ИИ-инференции / верификации организации.
`list_invoices`	Чтение	Перечислить счета организации, сначала самые новые.
`topup_balance`	Запись	Добавить предоплаченные средства на баланс через сохранённую карту.
`update_company_details`	Запись	Обновить данные компании / выставления счетов организации.
`validate_vat_number`	Чтение	Проверить номер НДС ЕС через внешний поиск.

topup_balance указан в долларах США, минимум $10, максимум $10 000 за пополнение.

Пользователи и аккаунт (7)

Инструмент	Доступ	Описание
`activate_trial`	Запись	Сохранить способ оплаты и активировать 7-дневный бесплатный пробный период с кредитом $10.
`add_passkey`	Запись	Начать добавление passkey для аккаунта аутентифицированного пользователя: получить параметры создания WebAuthn.
`delete_passkey`	Деструктивный	Удалить один из passkey аутентифицированного пользователя.
`get_current_user`	Чтение	Получить аутентифицированного пользователя, его организацию и краткую статистику аккаунта.
`list_passkeys`	Чтение	Перечислить зарегистрированные passkey аутентифицированного пользователя.
`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`	Запись	Начало проверки телефона путем отправки кода по SMS.
`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`	Чтение	Возврат спецификации OpenAPI 3.0 REST API Bynn (из /openapi.json).
`describe_cli`	Чтение	Возврат инструкций по установке, аутентификации и использованию CLI Bynn (`bynn`).

Интерактивные виджеты

Два семейства инструментов возвращают интерактивные карточки вместо необработанного JSON в хостах, поддерживающих MCP-приложения (ChatGPT и Claude):

Мошенничество с документами (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

Асинхронный шаблон везде одинаков: инструменты создания возвращают идентификатор, инструменты 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 сохраняет ключ в связке ключей вашей ОС) или неинтерактивно с помощью BYNN_API_KEY, --token или bynn auth login --with-token. Песочные ключи (private_sandbox_...) распознаются автоматически.

Дружелюбен к агентам по дизайну: -o json для структурированного вывода, --jq для фильтрации, --dry-run для предпросмотра запросов, --poll для асинхронных результатов и чистый контракт вывода (stdout = данные, stderr = прогресс). Дерево команд генерируется из живой спецификации OpenAPI Bynn, а bynn api <METHOD> <PATH> — это необработанный аутентифицированный пропуск к любому endpoint. CLI охватывает сессии, проверку возраста, приглашения AutoDoc, документы, модерацию, NFC и лицо; для биллинга, API-ключей, досье, оркестраторов и веб-сайтов используйте этот MCP-сервер.

Для агентов: вызовите инструмент describe_cli на этом сервере, чтобы получить все это руководство в машиночитаемой форме.

Самодискавери для агентов

Сервер документирует сам себя. Если вы LLM, подключенный к нему:

describe_api возвращает полную спецификацию Bynn OpenAPI 3.0: каждый endpoint, параметр и схему, включая те, что не обернуты как MCP-инструменты. Аутентификация не требуется.
describe_cli возвращает структурированное руководство по установке, аутентификации и запуску CLI bynn локально, для работы с локальными файлами. Аутентификация не требуется.
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 / соединение не удается сразу	Вы добавили `/mcp` к URL. Endpoint — это корень: `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.