Bynn Intelligence

официальный

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

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

Обнаружение изображений, созданных ИИ — Попросите вашего ассистента проверить, является ли изображение сгенерированным ИИ, с выдачей вердикта, вероятности и вероятного генератора через detect_ai_generated_image.
Проведение анализа документов на мошенничество — Отправьте банковскую выписку или счет на судебно-медицинский анализ мошенничества и опрашивайте get_document, пока оценка рисков не завершится.
Создание сессий верификации KYC — Генерируйте сессии проверки личности с размещенными ссылками, затем отслеживайте прогресс через get_session_preflight и get_session.
Оценка возраста по фотографиям — Подтверждайте возраст человека по селфи или изображению, с опциями проверки живости и порогов юридического возраста через verify_age_from_selfie.
Поиск лиц в коллекциях — Добавляйте лица в коллекции и ищите их с помощью пробного изображения через search_faces для нахождения совпадений.
Управление рабочими процессами AutoDoc — Создавайте, дублируйте и отслеживайте рабочие процессы сбора документов, досье и утверждения с участием человека.

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

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. Клиенты, поддерживающие Dynamic Client Registration (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`	Запись	Начать добавление ключа доступа к учётной записи аутентифицированного пользователя: получить параметры создания 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`	Запись	Начало проверки телефона путем отправки кода по 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.