Bynn Intelligence

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

Connectez n'importe quel client IA compatible MCP à Bynn : vérification d'identité (KYC), détection de fraude documentaire, vérification d'âge, modération de contenu, recherche de visages, workflows AutoDoc, agents de raisonnement anti-fraude et gestion de compte. 143 outils via l'API Bynn, une seule connexion. Fonctionne dans Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf et Zed.

https://mcp.bynn.com

Le point de terminaison est le chemin racine. N'ajoutez pas /mcp ; https://mcp.bynn.com/mcp ne fonctionnera pas. La seule autre route est GET /health.

---

Démarrage rapide (30 secondes)

Claude Code :

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

Claude ou ChatGPT (hébergé) : ajoutez https://mcp.bynn.com comme connecteur personnalisé et connectez-vous avec votre compte Bynn lorsque le navigateur s'ouvre. Aucune gestion de clé nécessaire.

Clients de type API : obtenez un jeton sur dashboard.bynn.com/authenticate et envoyez-le comme Authorization: Bearer <token> sur la connexion.

Essayez ensuite votre première invite :

Check whether this image is AI-generated.

Joignez une image, et le résultat s'affiche sous forme de carte interactive avec le verdict, la probabilité IA et le générateur le plus probable.

---

Exemples d'invites

Fraude et 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.

Vérification

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.

Modération et médias

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

Compte et opérations

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.

Les résultats de fraude documentaire et d'images IA s'affichent sous forme de cartes interactives dans ChatGPT et Claude (voir Widgets interactifs).

---

Installation

Claude Code

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

Claude Desktop et claude.ai

Paramètres → Connecteurs → Ajouter un connecteur personnalisé → URL https://mcp.bynn.com. La connexion OAuth démarre automatiquement lors de la première utilisation.

ChatGPT

Paramètres → Applications et connecteurs → activer le mode développeur → Créer → URL du serveur MCP https://mcp.bynn.com. Bynn est conçu comme une application ChatGPT : les rapports de fraude et les vérifications d'images IA s'affichent sous forme de cartes interactives, et les images jointes sont transmises nativement aux outils.

Cursor

Un clic ci-dessus, ou ajoutez manuellement à ~/.cursor/mcp.json (ou .cursor/mcp.json par projet) :

{
  "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 se connecte via le pont 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"]
      }
    }
  }
}

---

Authentification

OAuth 2.1 (connecteurs)

Les connecteurs hébergés (Claude, ChatGPT) s'authentifient avec OAuth 2.1 + PKCE. Le serveur d'autorisation est dashboard.bynn.com ; votre client MCP ouvre une connexion navigateur, vous approuvez les autorisations demandées, et le client se connecte en tant qu'utilisateur de votre tableau de bord Bynn. Les clients qui prennent en charge l'enregistrement dynamique des clients (Claude, Cursor) s'enregistrent automatiquement.

Jetons Bearer (clients de type API)

Pour une utilisation côté serveur, scriptée ou auto-hébergée, envoyez un en-tête d'autorisation sur la connexion MCP :

Authorization: Bearer <token>

Obtenez un jeton sur dashboard.bynn.com/authenticate. Trois types de jetons fonctionnent :

Jeton	Préfixe	Ce qu'il peut faire
Jeton de tableau de bord (JWT)	aucun	Tout. Lorsqu'un outil nécessite une clé API, le serveur échange automatiquement le JWT contre les clés de votre organisation.
Clé API privée	private_...	Outils de produit et de vérification (documents, modération, résultats d'âge). Pas suffisant pour les outils de tableau de bord comme les clés API ou la facturation.
Clé API publique	public_...	Création de session côté client (create_session, create_age_verification_session).

Par groupe d'outils :

Groupe d'outils	Identifiant minimal
Clés API, facturation, utilisateurs, AutoDoc, raisonnement, sites web	Jeton de tableau de bord (JWT)
Documents, modération, visage, NFC	Clé privée ou JWT
create_session, create_age_verification_session	Clé publique ou JWT
verify_age_from_selfie, get_age_verification_result	Clé privée ou JWT
Étapes de session (consentement, pré-vérification, vivacité, téléversements)	Aucun : le jeton de session dans l'URL est l'identifiant

Utilisez les clés privées uniquement dans des environnements serveur de confiance. Ne les exposez jamais dans du code frontend, des dépôts publics ou des discussions partagées.

Exemple de configuration client avec un jeton

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

export BYNN_API_KEY="private_your_bynn_key_here"

---

Référence des outils (143 outils)

Badges d'accès : Lecture = sûr, non modifiant. Écriture = crée ou modifie des données. Destructif = supprime, annule ou révoque (delete_*, cancel_*, rotate_api_key) ; gardez la confirmation activée pour ceux-ci dans votre client. Chaque outil porte également des annotations readOnlyHint / destructiveHint lisibles par machine, afin que les clients MCP puissent les contrôler automatiquement.

Documents (4)

Outil	Accès	Description
delete_document	Destructif	Supprimer une soumission de document.
get_document	Lecture	Récupérer une soumission de document et son résultat d'analyse forensique.
list_documents	Lecture	Lister et rechercher vos soumissions de documents.
submit_document	Écriture	Soumettre un document pour une analyse complète de fraude / authenticité.

L'analyse de documents est asynchrone : submit_document, puis interrogez get_document jusqu'à ce que status soit analyzed.

Vérification d'âge (5)

Outil	Accès	Description
complete_age_verification_liveness	Écriture	Finaliser une capture de vivacité.
create_age_verification_session	Écriture	Créer une nouvelle session de vérification d'âge par vivacité.
get_age_verification_result	Lecture	Lire le résultat d'une session de vérification d'âge par vivacité.
start_age_verification_liveness	Écriture	Démarrer la capture de vivacité pour une session.
verify_age_from_selfie	Écriture	Estimer l'âge à partir d'un selfie unique, sans vivacité.

verify_age_from_selfie prend un seuil age_verification_model (21, 18 et inférieur, par défaut 18) plus un indicateur de juridiction legal_age_21. Le flux de vivacité est : créer une session → démarrer la vivacité → terminer la vivacité → obtenir le résultat.

Modération de contenu (12)

Outil	Accès	Description
check_age	Écriture	Estimer l'âge des visages dans une image (vérification d'âge / détection de mineurs).
create_moderation_inference	Écriture	Exécuter une inférence de modération / détection IA.
detect_ai_generated_image	Écriture	Vérifier si une image est générée par IA ou est une vraie photo.
get_moderation_dashboard_stats	Lecture	Obtenir les statistiques du tableau de bord de modération pour votre organisation.
get_moderation_inference	Lecture	Récupérer une inférence de modération passée par son identifiant.
get_moderation_model	Lecture	Obtenir un modèle de modération avec documentation complète.
list_all_moderation_models	Lecture	Lister TOUS les modèles de modération publics de chaque type.
list_audio_moderation_models	Lecture	Lister les modèles de modération AUDIO groupés par catégorie.
list_image_moderation_models	Lecture	Lister les modèles de modération IMAGE groupés par catégorie.
list_text_moderation_models	Lecture	Lister les modèles de modération TEXTE groupés par catégorie.
list_video_moderation_models	Lecture	Lister les modèles de modération VIDÉO groupés par catégorie.
public_moderation_inference	Écriture	Exécuter une inférence de détection IA publique GRATUITE, sans identifiant requis.

detect_ai_generated_image renvoie result.is_ai_generated (le verdict), ai_probability, uncertain, top_generator, generators, c2pa_signer et detection_mode. check_age renvoie par visage age, from_age/to_age, is_minor, challenge_25, sex, confidence, uncertainty et bbox.

Recherche de visages (6)

Outil	Accès	Description
create_face_collection	Écriture	Créer une nouvelle collection de visages.
delete_face	Destructif	Supprimer un seul visage inscrit d'une collection.
delete_face_collection	Destructif	Supprimer une collection de visages et TOUS ses visages inscrits.
enroll_face	Écriture	Inscrire un seul visage dans une collection.
list_face_collections	Lecture	Lister les collections de visages de votre organisation.
search_faces	Lecture	Rechercher dans une collection des visages similaires à une image sonde.

AutoDoc (37)

Outil	Accès	Description
add_dossier_note	Écriture	Ajouter une note d'administrateur à un dossier.
approve_approval	Écriture	Approuver une approbation HITL en attente.
attach_dossier_tag	Écriture	Attacher une étiquette d'organisation à un dossier.
create_document_collection	Écriture	Créer une collection de documents.
create_invitation	Écriture	Envoyer une invitation AutoDoc par e-mail ou SMS.
create_organization_tag	Écriture	Créer une étiquette d'organisation.
create_workflow	Écriture	Créer un workflow.
delete_document_collection	Destructif	Supprimer une collection de documents (suppression douce).
delete_invitation	Destructif	Annuler (suppression définitive) une invitation AutoDoc en attente.
delete_organization_tag	Destructif	Supprimer une étiquette d'organisation.
delete_workflow	Destructif	Supprimer un workflow (suppression douce).
detach_dossier_tag	Écriture	Détacher une étiquette d'organisation d'un dossier.
download_dossier_zip	Lecture	Empaqueter les documents et variables d'un dossier dans un ZIP.
duplicate_workflow	Écriture	Dupliquer un workflow.
get_autodoc_dashboard_stats	Lecture	Obtenir les statistiques agrégées du tableau de bord AutoDoc.
get_document_collection	Lecture	Obtenir une collection de documents et ses exigences.
get_dossier	Lecture	Obtenir un dossier avec sa progression et ses variables de workflow.
get_dossier_form_fields	Lecture	Lister les noms de champs de formulaire disponibles dans vos workflows actifs.
get_invitation	Lecture	Obtenir une invitation AutoDoc individuelle.
get_pending_approval_count	Lecture	Obtenir le nombre d'approbations HITL en attente.
get_workflow	Lecture	Obtenir un workflow individuel.
list_approvals	Lecture	Lister les approbations de workflow avec intervention humaine.
list_document_collections	Lecture	Lister les collections de documents de votre organisation.
list_document_types	Lecture	Lister les types de documents disponibles pour les exigences de collection.
list_dossier_documents	Lecture	Lister les documents téléchargés dans un dossier.
list_dossier_notes	Lecture	Lister les notes / la chronologie d'audit d'un dossier.
list_dossiers	Lecture	Lister et filtrer les dossiers AutoDoc.
list_invitation_locales	Lecture	Lister les locales d'invitation prises en charge.
list_invitations	Lecture	Lister les invitations AutoDoc.
list_organization_tags	Lecture	Lister les étiquettes de dossier de votre organisation.
list_workflows	Lecture	Lister les workflows de votre organisation.
reject_approval	Écriture	Rejeter une approbation HITL en attente.
resend_invitation	Écriture	Renvoyer une invitation AutoDoc.
update_document_collection	Écriture	Mettre à jour une collection de documents et (optionnellement) ses exigences.
update_dossier	Écriture	Renommer un dossier.
update_organization_tag	Écriture	Mettre à jour la couleur et/ou le nom d'une étiquette d'organisation.
update_workflow	Écriture	Mettre à jour un workflow.

Agents de raisonnement et de fraude (25)

Outil	Accès	Description
create_fraud_agent	Écriture	Créer un agent / opérateur d'analyse de fraude.
create_orchestrator	Écriture	Créer un agent orchestrateur (coordinateur).
create_reasoning_job	Écriture	Mettre en file d'attente un travail de raisonnement de fraude ASYNCHRONE pour un document.
delete_fraud_agent	Destructif	Supprimer un agent / opérateur d'analyse de fraude.
delete_orchestrator	Destructif	Supprimer un agent orchestrateur.
generate_fraud_agent_prompt	Écriture	Rédiger une invite système d'agent d'analyse de fraude avec l'IA.
generate_orchestrator_prompt	Écriture	Rédiger une invite système d'orchestrateur avec l'IA.
get_agent	Lecture	Obtenir un agent individuel (orchestrateur ou opérateur) par jeton.
get_agent_stats	Lecture	Obtenir les statistiques agrégées des agents de votre organisation.
get_reasoning_job	Lecture	Obtenir le statut et les résultats complets d'un travail de raisonnement.
list_agent_categories	Lecture	Lister les options de catégories d'agents disponibles.
list_agent_ratings	Lecture	Lister les évaluations et le résumé des évaluations pour un agent public.
list_document_content_types	Lecture	Lister les types de contenu de documents et lesquels sont déjà revendiqués.
list_fraud_agents	Lecture	Lister les agents / opérateurs d'analyse de fraude de VOTRE organisation.
list_orchestrators	Lecture	Lister les agents orchestrateurs de VOTRE organisation.
list_public_fraud_agents	Lecture	Parcourir les modèles d'agents d'analyse de fraude publics de la communauté mondiale.
list_public_orchestrators	Lecture	Parcourir les modèles d'orchestrateurs publics de la communauté mondiale.
list_reasoning_jobs	Lecture	Lister les travaux de raisonnement avec filtres et statistiques à l'échelle de l'organisation.
publish_agent	Écriture	Publier l'un de vos agents sur la place de marché publique communautaire.
rate_agent	Écriture	Évaluer un agent public de 1 à 5 étoiles.
reorder_orchestrator_agents	Écriture	Réordonner les agents d'analyse de fraude assignés à un orchestrateur.
test_orchestrator	Écriture	Exécuter un orchestrateur de manière SYNCHRONE sur un document existant.
unpublish_agent	Écriture	Retirer l'un de vos agents de la place de marché publique.
update_fraud_agent	Écriture	Mettre à jour un agent / opérateur d'analyse de fraude.
update_orchestrator	Écriture	Mettre à jour un agent orchestrateur.

Facturation (14)

Outil	Accès	Description
cancel_billing_plan	Destructif	Planifier l'annulation de l'abonnement actuel.
change_billing_plan	Écriture	Changer le plan d'abonnement de l'organisation.
confirm_payment_method	Écriture	Enregistrer la carte confirmée comme méthode de paiement par défaut.
create_setup_intent	Écriture	Créer un SetupIntent Stripe pour collecter une méthode de paiement.
download_invoice	Lecture	Télécharger une facture au format PDF.
get_billing_info	Lecture	Obtenir l'instantané complet de facturation de l'organisation.
get_current_usage	Lecture	Obtenir l'utilisation non facturée de la période de facturation actuelle.
get_stripe_config	Lecture	Obtenir la configuration côté client Stripe.
list_billing_plans	Lecture	Lister tous les plans d'abonnement disponibles avec prix et fonctionnalités.
list_inference_history	Lecture	Lister l'historique des demandes d'inférence IA / vérification de l'organisation.
list_invoices	Lecture	Lister les factures de l'organisation, de la plus récente à la plus ancienne.
topup_balance	Écriture	Ajouter des fonds prépayés au solde du compte via la carte enregistrée.
update_company_details	Écriture	Mettre à jour les informations de société / facturation de l'organisation.
validate_vat_number	Lecture	Valider un numéro de TVA UE via une recherche externe.

topup_balance est en dollars américains, minimum 10 $, maximum 10 000 $ par rechargement.

Utilisateurs et compte (7)

Outil	Accès	Description
activate_trial	Écriture	Enregistrer une méthode de paiement et activer l'essai gratuit de 7 jours avec un crédit de 10 $.
add_passkey	Écriture	Commencer à ajouter une clé d'accès au compte de l'utilisateur authentifié : obtenir les options de création WebAuthn.
delete_passkey	Destructif	Supprimer l'une des clés d'accès de l'utilisateur authentifié.
get_current_user	Lecture	Obtenir l'utilisateur authentifié, son organisation et des statistiques rapides du compte.
list_passkeys	Lecture	Lister les clés d'accès enregistrées de l'utilisateur authentifié.
report_public_data	Écriture	Signaler des données incorrectes dans le profil public de l'utilisateur authentifié.
submit_onboarding_survey	Écriture	Enregistrer le sondage d'intégration de l'organisation de l'utilisateur actuel.

Sites Web (8)

Outil	Accès	Description
create_website	Écriture	Créer une nouvelle configuration de site Web de vérification d'âge.
delete_website	Destructif	Supprimer définitivement une configuration de site Web de vérification d'âge.
get_website	Lecture	Obtenir un site Web de vérification d'âge par ID.
list_countries	Lecture	Lister tous les pays avec codes et attributs.
list_verifications	Lecture	Parcourir l'historique de vérification d'âge de l'organisation.
list_websites	Lecture	Lister chaque site Web de vérification d'âge de l'organisation authentifiée.
pause_website	Écriture	Mettre en pause ou reprendre la vérification d'âge pour un site Web.
update_website	Écriture	Mettre à jour une configuration existante de site Web de vérification d'âge.

Vérifications Agemin (3)

Outil	Accès	Description
get_age_verification_status	Lecture	Revérifier un résultat de vérification d'âge précédent côté serveur.
verify_age_with_email	Écriture	Estimer l'âge minimum d'une personne à partir de son adresse e-mail.
verify_age_with_selfie	Écriture	Estimer l'âge d'une personne à partir d'une seule photo selfie.

Sessions de vérification (16)

Outil	Accès	Description
cancel_session	Destructif	Annuler / interrompre une session.
check_email_verification	Lecture	Terminer la vérification par e-mail avec le code.
check_phone_verification	Lecture	Terminer la vérification par téléphone avec le code SMS.
complete_liveness	Écriture	Terminer une capture de vivacité faciale.
create_session	Écriture	Créer une nouvelle session de vérification d'identité.
get_session	Lecture	Afficher les informations sur une session ouverte.
get_session_preflight	Lecture	Obtenir l'étape de vérification suivante pour une session.
give_session_consent	Écriture	Enregistrer la décision de consentement du demandeur.
send_session_sms	Écriture	Envoyer par SMS au demandeur un lien pour continuer sur son téléphone.
start_email_verification	Écriture	Démarrer la vérification par e-mail en envoyant un code.
start_liveness	Écriture	Démarrer une capture de vivacité faciale.
start_phone_verification	Écriture	Démarrer la vérification par téléphone en envoyant un code par SMS.
submit_address_verification	Écriture	Téléverser un justificatif de domicile.
submit_funds_verification	Écriture	Téléverser un justificatif de fonds.
update_session	Écriture	Mettre à jour les informations du demandeur d'une session ouverte.
upload_session_media	Écriture	Téléverser des médias capturés vers une session.

Clés API (3)

Outil	Accès	Description
get_api_key	Lecture	Récupérer la valeur COMPLÈTE, non masquée, d'une clé API existante.
list_api_keys	Lecture	Lister toutes les clés API de l'organisation authentifiée.
rotate_api_key	Destructif	Pivoter (régénérer) une clé API pour l'organisation authentifiée.

list_api_keys renvoie des valeurs masquées ; seul get_api_key révèle le secret complet, donc gardez la confirmation activée pour celui-ci dans des contextes partagés. rotate_api_key conserve l'ancienne clé valide pendant une période de grâce de 12 heures par défaut ; passez immediate: true pour la révoquer instantanément.

NFC (1)

Outil	Accès	Description
submit_nfc_data	Écriture	Soumettre les données d'un document d'identité scanné par NFC à une session de vérification.

Serveur et auto-découverte (2)

Outil	Accès	Description
describe_api	Lecture	Renvoyer la spécification OpenAPI 3.0 de l'API REST Bynn (depuis /openapi.json).
describe_cli	Lecture	Renvoyer les instructions d'installation, d'authentification et d'utilisation pour la CLI Bynn (bynn).

---

Widgets interactifs

Deux familles d'outils renvoient des cartes interactives au lieu de JSON brut dans les hôtes qui prennent en charge les applications MCP (ChatGPT et Claude) :

• Fraude documentaire (submit_document, get_document) : une carte de rapport en direct avec la jauge de risque, les signaux médico-légaux, les champs extraits et les étiquettes de risque. Les analyses en attente s'interrogent elles-mêmes jusqu'à leur achèvement.
• Vérification d'image IA (detect_ai_generated_image) : carte de verdict avec probabilité IA et une répartition par générateur. Si aucune image n'a été fournie, la carte affiche un téléverseur par glisser-déposer, et le fichier déposé va directement au détecteur sans entrer dans le contexte de la conversation.

Les autres clients MCP reçoivent simplement les mêmes données sous forme de JSON structuré.

---

Exemple de flux de travail

Une session KYC complète, pilotée de manière conversationnelle :

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

Le modèle asynchrone est le même partout : les outils de création renvoient un identifiant, les outils get_* l'interrogent. Pour la fraude documentaire, submit_document → get_document jusqu'à status: "analyzed" ; pour les tâches de raisonnement, create_reasoning_job → get_reasoning_job.

---

CLI Bynn : travailler avec des fichiers locaux

Le serveur MCP hébergé ne peut pas lire les fichiers sur votre machine. La CLI Bynn le peut. Les agents qui s'exécutent localement (Claude Code, Cursor, un terminal) peuvent analyser des fichiers locaux directement :

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

Installation (macOS/Linux) :

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

Installation (Windows) :

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

Les téléchargements directs (plus .deb/.rpm et les sommes de contrôle) sont disponibles sur la page des versions.

Authentifiez-vous une fois (bynn auth login stocke la clé dans votre trousseau système), ou de manière non interactive avec BYNN_API_KEY, --token ou bynn auth login --with-token. Les clés sandbox (private_sandbox_...) sont reconnues automatiquement.

Conçu pour les agents : -o json pour la sortie structurée, --jq pour le filtrage, --dry-run pour prévisualiser les requêtes, --poll pour les résultats asynchrones, et un contrat de sortie propre (stdout = données, stderr = progression). L'arborescence des commandes est générée à partir de la spécification OpenAPI Bynn en direct, et bynn api <METHOD> <PATH> est un passage direct authentifié brut vers n'importe quel point de terminaison. La CLI couvre les sessions, la vérification d'âge, les invitations AutoDoc, les documents, la modération, le NFC et le visage ; pour la facturation, les clés API, les dossiers, les orchestrateurs et les sites web, utilisez ce serveur MCP.

Pour les agents : appelez l'outil describe_cli sur ce serveur pour obtenir ce guide complet sous forme lisible par machine.

---

Auto-découverte pour les agents

Le serveur se documente lui-même. Si vous êtes un LLM connecté à celui-ci :

• describe_api renvoie la spécification complète Bynn OpenAPI 3.0 : chaque point de terminaison, paramètre et schéma, y compris ceux non encapsulés en tant qu'outils MCP. Aucune authentification requise.
• describe_cli renvoie un guide structuré pour installer, authentifier et exécuter la CLI bynn localement, pour travailler sur des fichiers locaux. Aucune authentification requise.
• file://server/status (ressource MCP) renvoie la liste d'outils en direct et l'état du serveur.

Ceux-ci sont également annoncés dans les instructions initialize du serveur, donc vous n'avez pas besoin de ce README pour les trouver.

---

Avancé

Annotations et contrat de réponse

Chaque outil porte des ToolAnnotations MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), appliqués de manière cohérente par verbe : get_*/list_*/ search_*/describe_*/download_*/validate_* sont en lecture seule ; delete_*/cancel_*/ rotate_api_key sont destructifs. Les échecs reviennent sous forme de charges utiles {error: true, error_type, message} structurées plutôt que d'erreurs de protocole, afin que les agents puissent les lire et y réagir.

Dépannage

Symptôme	Correctif
404 / échec de connexion immédiat	Vous avez ajouté /mcp à l'URL. Le point de terminaison est la racine : https://mcp.bynn.com
authentication_error / authentication_required	Obtenez un jeton sur dashboard.bynn.com/authenticate et définissez-le comme en-tête Authorization. Ne réessayez pas aveuglément.
Un outil renvoie 401 avec une connexion valide	Type d'identifiants incorrect pour ce groupe d'outils ; voir le tableau d'authentification. Les clés API et la facturation nécessitent un jeton de tableau de bord, pas une clé private_ brute.
L'outil d'image indique qu'aucune image n'a été fournie	La carte qui apparaît accepte le glisser-déposer ; déposez l'image dedans. Ou passez un image_url public.
Document bloqué dans pending	L'analyse est asynchrone ; interrogez get_document jusqu'à ce que status soit analyzed. N'interrogez pas plus d'une fois toutes les quelques secondes.
Le connecteur OAuth cesse de fonctionner	Déconnectez et reconnectez le connecteur pour relancer le flux de connexion.

Support

Problèmes et questions : github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

Sous licence MIT.