Belin Doc IconBelin Doc

MCP · Model Context Protocol

Serveur MCP de traduction IA

Laissez votre IA s'occuper de la traduction.

Branchez la traduction de PDF et de documents de Belin Doc sur le client MCP que vous utilisez déjà — Claude, Cursor, tout ce qui parle MCP. Une phrase suffit pour soumettre un fichier, suivre l'avancement et récupérer la traduction. Même compte, même quota que sur le site.

dans votre client MCP

userTraduis ce PDF en japonais.

↳translate_document · contract.pdf → ja

↳get_document_translation_status · 12 pages

aiC'est fait — mise en page intacte, voici le fichier traduit.

Point d'accès
https://mcp.belindoc.com/api/mcp
Transport
Streamable HTTP · distant
Clés par compte
5
Mise à jour
2026-09-24

Ce que ça fait

Quatre choses à savoir avant de traduire un PDF via MCP

01

Une phrase, tout le travail

Dites « traduis ce PDF en japonais ». Le choix du modèle, la soumission et la récupération se font derrière cette seule ligne.

02

La mise en page reste

Le fichier traduit conserve la mise en page d'origine, les tableaux, les figures et la position des formules.

03

Le modèle, c'est vous

Gemini 3, GPT-5.x et le reste du catalogue : on change de modèle selon le document, sans être enfermé dans un seul.

04

Même compte, même quota

Les appels puisent dans le quota et les commandes que vous avez déjà sur le site. Rien à recharger séparément.

Comment brancher

Streamable HTTP · distant

Brancher le serveur MCP en trois étapes

Une clé, un bloc de JSON. Tout le reste se fait en langage naturel.

  1. 01

    Créer une clé API

    Connectez-vous, ouvrez le menu de votre avatar en haut à droite et allez dans Espace développeur. La clé complète n'apparaît qu'une fois, juste après sa création : enregistrez-la à ce moment-là.

  2. 02

    Coller la configuration

    Ajoutez ce bloc au fichier de configuration MCP de votre client et placez votre clé après Bearer dans l'en-tête Authorization.

  3. 03

    Demander, simplement

    Dites ce que vous voulez faire traduire. Le client choisit l'outil, Belin Doc fait le travail.

mcp.json
{
  "mcpServers": {
    "belindoc-mcp": {
      "type": "http",
      "url": "https://mcp.belindoc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <votre clé API>"
      }
    }
  }
}

La valeur de type varie selon le client : Claude Code attend http. Streamable HTTP, indiqué plus haut, est le nom du protocole, pas une valeur à recopier.

Installation locale

Plutôt le faire tourner sur votre machine ?

L'adresse ci-dessus correspond à l'accès distant partagé. Si vous préférez faire tourner le serveur sur votre propre machine, ou si votre client se prête mal à la saisie d'une URL distante et d'en-têtes, passez par stdio en local. Mêmes outils, même compte, même quota.

uvx récupère le paquet au premier lancement : rien à installer au préalable. Notez qu'ici la clé se place dans le bloc env, pas dans un en-tête.

PyPI · belindoc-mcp

Pas d'installateur en ligne de commande pour ce client. Ajoutez le bloc ci-dessous à son fichier de configuration : ~/Library/Application Support/Claude/claude_desktop_config.json · %APPDATA%\Claude\claude_desktop_config.json

config mcp
{
  "mcpServers": {
    "belindoc-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["belindoc-mcp"],
      "env": {
        "BELINDOC_API_KEY": "<votre clé API>"
      }
    }
  }
}

Nécessite uv sur votre machine (uvx est fourni avec). Après l'installation de uv, ouvrez un nouveau terminal avant de lancer votre client : sans cela le PATH n'est pas à jour et le client signalera que uvx est introuvable.

Les chemins et clés racines des clients évoluent ; reportez-vous à la documentation à jour de votre client avant de commencer. Les trois lignes propres à Belin Doc — command, args et env — sont identiques d'un client à l'autre.

En pratique

Demandez, ne câblez pas

Six demandes possibles une fois le serveur branché. Chacune correspond à un outil que le client appelle pour vous.

  • Traduire

    “Traduis ce PDF en japonais.”

    ↳ translate_document

  • Choisir le modèle

    “Traduis ce contrat avec Gemini 3.”

    ↳ translate_document

  • Vidéo

    “Traduis cette vidéo en anglais, avec sous-titres bilingues.”

    ↳ translate_video

  • Avancement

    “Celui que je viens d'envoyer est terminé ?”

    ↳ get_document_translation_status

  • Résultat

    “Télécharge-moi le fichier traduit.”

    ↳ get_document_translation_result

  • Quota

    “Il me reste combien de pages ce mois-ci ?”

    ↳ get_account_status

Questions

Avant de brancher le serveur MCP

Comment est-ce facturé ? C'est le même quota que le site ?
Le même. MCP est une porte d'entrée de plus, pas un autre produit : les appels consomment le même quota de pages et de vidéo, aux mêmes coefficients de modèle, et il n'existe pas de tarif propre à MCP.
Combien de clés par compte ?
Cinq par défaut. Vous les créez, renommez, datez et restreignez par IP dans l'espace développeur, et vous pouvez les désactiver ou les supprimer à tout moment.
Et si je perds ma clé ?
La valeur complète n'est affichée qu'une fois, à la création : nous n'en gardons qu'une empreinte, elle est donc irrécupérable. Si elle est perdue, régénérez la clé dans l'espace développeur pour obtenir une nouvelle valeur : le nom, la date d'expiration et la liste d'IP autorisées sont conservés, et l'ancienne valeur cesse de fonctionner immédiatement.
Quels clients fonctionnent ?
Tout client capable de dialoguer avec un serveur MCP distant en Streamable HTTP et d'envoyer votre clé dans un en-tête de requête — Claude Code et Cursor, entre autres. Pour Claude Desktop, utilisez la configuration stdio locale décrite plus haut.
Et si une clé fuite ?
Désactivez-la ou supprimez-la immédiatement dans l'espace développeur, puis créez-en une nouvelle. Vous pouvez aussi lui associer une liste d'IP autorisées pour que seuls vos serveurs puissent l'utiliser.

Apprenez à votre IA à traduire

Créez une clé, collez un bloc de configuration. C'est toute l'installation.