Configurer la connexion MCP

Connectez-vous aux outils du compte via une connexion authentifiée, puis vérifiez l’organisation et l’inventaire des outils.

Connectez votre assistant à votre compte Lingo.dev, puis confirmez l’organisation souhaitée à l’aide d’une requête de lecture. Le serveur agit au nom de l’utilisateur Lingo.dev connecté.

Connexion au compte #

Définissez l’URL du serveur distant sur https://mcp.lingo.dev/mcp et sélectionnez HTTP en streaming avec OAuth. Lancez le processus d’autorisation du client, connectez-vous au compte Lingo.dev souhaité et approuvez la connexion. Le client découvre le serveur d’autorisation à partir du point de terminaison MCP et gère ses identifiants d’accès et de renouvellement.

La requête MCP transmet un jeton d’accès utilisateur dans Authorization: Bearer <access-token>. Ce jeton n’est ni une clé API personnelle permanente ni lié à une seule organisation. Le serveur vérifie que l’utilisateur a accès aux ressources désignées par chaque outil. La page Identifiants du compte explique ces droits et la gestion des identifiants.

Une clé API placée dans x-api-key, ou utilisée comme valeur du jeton porteur, ne permet pas de s’authentifier auprès de ce serveur hébergé. Utilisez un client qui prend en charge sa connexion OAuth plutôt que de copier une clé API dans un en-tête statique.

Les valeurs de connexion sont résumées ci-dessous. Cette fiche n’est pas un fichier de configuration propre à un client :

json
{
  "endpoint": "https://mcp.lingo.dev/mcp",
  "transport": "Streamable HTTP",
  "authentication": "OAuth user session"
}

Associez ces valeurs aux champs pris en charge par votre client. Le stockage des identifiants d’authentification et la syntaxe de configuration varient selon la version. Le point de terminaison accepte les requêtes MCP POST : sans jeton valide, il renvoie 401 avec les métadonnées de découverte OAuth ; une requête GET authentifiée renvoie 405 Method Not Allowed. Ouvrir l’URL dans un navigateur ne permet pas de tester une connexion MCP initialisée.

URL hébergées existantes #

https://mcp.lingo.dev/main fournit les mêmes outils et les mêmes droits utilisateur. Son processus de découverte OAuth diffère de celui de /mcp ; une connexion /main qui fonctionne peut donc conserver sa configuration d’autorisation actuelle. Pour passer à /mcp, ajoutez cette URL comme nouvelle connexion et effectuez son processus d’autorisation OAuth jusqu’au bout. N’utilisez pas les paramètres d’autorisation enregistrés pour une ancienne connexion avec la nouvelle URL.

L’ancienne adresse https://mcp.lingo.dev/account renvoie 401 jusqu’à réception d’un jeton utilisateur valide, puis effectue une redirection 308 vers /main, en conservant la méthode et le corps de la requête. Cette redirection ne rétablit ni l’authentification par clé API ni l’ancien catalogue d’outils lié à une organisation. Si vous migrez une connexion qui utilisait une clé API, reconnectez-vous via OAuth.

Terminer la configuration d’une nouvelle organisation #

Lors de la connexion, la personne qui utilise un nouveau compte nomme son organisation dans l’application web. La personne qui crée l’organisation y effectue ensuite trois étapes supplémentaires : les intégrations, les membres de l’équipe et le premier moteur, que l’application web renseigne à partir du site de l’organisation. Il est possible de passer les étapes des intégrations et des membres de l’équipe. Tant que ces trois étapes ne sont pas terminées, chaque outil qui désigne cette organisation renvoie une erreur précisant les étapes restantes et un lien vers https://lingo.dev/orgs/<orgId>. Ce lien ouvre l’étape en cours pour la personne ayant créé l’organisation. members_listMemberships répertorie toujours l’organisation, ce qui permet à l’assistant de trouver son ID.

Ouvrez le lien, terminez les étapes, puis répétez l’appel. L’assistant fonctionne alors normalement et peut créer d’autres moteurs avec engines_create ou provisioningJobs_create. Les membres invités et les organisations créées avant la mise en place de ce parcours de configuration ne sont pas concernés.

Vérifier le périmètre du compte #

  1. Ouvrez l’inventaire des outils du client et recherchez members_listMemberships et engines_list.
  2. Appelez members_listMemberships pour lire la liste des organisations de l’utilisateur. S’il n’y en a qu’une, utilisez-la ; si plusieurs sont disponibles, choisissez celle souhaitée et conservez son ID pour cette tâche.
  3. Appelez engines_list avec le orgId de cette organisation, puis choisissez un ID de moteur dans le data renvoyé.
  4. Avant d’utiliser un outil sélectionné, lisez le schéma qu’il déclare. Les outils au niveau de l’organisation acceptent un champ d’organisation explicite ; ceux au niveau d’un objet peuvent accepter un ID de ressource à la place. Limitez les écritures au périmètre convenu pour la tâche.

Passer d’une organisation à une autre dans la même liste d’appartenances ne nécessite pas de nouvelle connexion OAuth. Transmettez l’ID sélectionné dans le champ déclaré par l’outil, par exemple orgId ou le id d’une organisation. Le serveur n’injecte pas d’organisation fixe à partir du jeton. Si la personne connectée n’est pas la bonne, reconnectez-vous depuis la gestion des comptes du client.

members_listMemberships #

Cet appel ne nécessite aucun ID d’organisation. intent est facultatif et décrit la tâche :

json
{
  "intent": "Find the organization whose French translation guidance I should inspect."
}

Le data de la réponse contient les organisations accessibles, avec leurs ID et leurs noms. Les entrées facultatives de ssoRequired signalent les appartenances qui nécessitent une connexion SSO non encore effectuée dans cette session. Connectez-vous à Lingo.dev via le fournisseur d’identité de l’organisation concernée, puis reconnectez le client. Une organisation figurant dans ssoRequired n’est pas encore accessible aux appels ordinaires au niveau de l’organisation.

Si les deux listes sont vides, ouvrez https://lingo.dev/orgs/start pour configurer la première organisation, puis répétez cette lecture. N’inventez pas d’ID d’organisation et ne créez pas de deuxième organisation au seul motif qu’une appartenance existante nécessite une connexion SSO.

engines_list #

Remplacez org_example par un ID figurant dans la réponse contenant les appartenances :

json
{
  "orgId": "org_example",
  "intent": "Find the localization engine used for French translations."
}

Utilisez un ID de moteur figurant dans le data renvoyé pour les lectures ultérieures au niveau du moteur. Il s’agit des arguments complets des outils, et non d’enveloppes de données HTTP. Les outils utilisent le champ facultatif intent en complément des champs propres à chaque opération. Consultez Fonctionnalités pour connaître les opérations du compte.

Emplacement de la configuration selon le client #

Consultez la documentation à jour du client pour connaître sa syntaxe de configuration et les transports pris en charge. Ces choix sont importants, même lorsque deux clients utilisent le même point de terminaison.

Claude Code #

Choisissez une connexion HTTP distante avec OAuth pour /mcp. Avant de l’enregistrer, décidez si elle doit figurer dans votre configuration utilisateur ou dans celle du projet. Les paramètres partagés du projet ne doivent pas contenir d’identifiants ; chaque utilisateur doit autoriser la connexion à son propre compte. Vérifiez l’inventaire après avoir activé la connexion.

Codex #

Codex utilise une configuration TOML, généralement dans ~/.codex/config.toml. Configurez l’URL du compte à l’aide des fonctionnalités MCP distantes prises en charge par votre version. Ne copiez pas la configuration JSON d’un autre client dans TOML. Si votre version nécessite une passerelle de transport, vérifiez ses mécanismes d’authentification et de stockage des jetons avant de l’utiliser : cette passerelle est un processus supplémentaire qui détient des identifiants.

Cursor #

Choisissez en connaissance de cause entre les paramètres utilisateur et un .cursor/mcp.json de projet. Une connexion de projet permet aux membres de l’équipe de découvrir la définition du serveur, mais ne doit pas partager une clé de compte en clair. Chaque utilisateur doit autoriser la connexion à son propre compte.

Claude Desktop et claude.ai #

Lingo.dev figure dans le répertoire des connecteurs Claude : aucune URL ni aucun fichier de configuration n’est nécessaire. Les étapes sont les mêmes dans Claude Desktop et sur claude.ai :

  1. Ouvrez Paramètres > Personnaliser > Découvrir.
  2. Recherchez Lingo.dev et cliquez sur Connecter dans le connecteur Lingo.dev.
  3. Sur la page Autoriser de Lingo.dev, connectez-vous au compte souhaité et cliquez sur Approuver.

Claude stocke et renouvelle les identifiants. Vérifiez l’inventaire après la connexion.

ChatGPT #

La disponibilité des applications personnalisées distantes et la prise en charge d’OAuth dépendent du compte et de la version du client. Lorsque ces fonctionnalités sont disponibles, utilisez l’URL /mcp et autorisez l’utilisateur Lingo.dev souhaité.

Confier à l’agent une première tâche bien délimitée #

Voici un exemple de première demande :

Examinez le glossaire français et les instructions du moteur de localisation sélectionné. Expliquez quelles ressources sont associées et si elles couvrent le terme produit que j’ai fourni. Proposez toute modification avant de l’appliquer. Cette tâche n’autorise ni la traduction, ni la génération de suggestions, ni la création de clés, ni la gestion des membres.

Associez cette instruction à une approbation côté client ou à une liste adaptée d’outils autorisés. Une consigne définit le travail demandé, mais ne supprime pas les droits d’écriture associés à un identifiant.

Si la découverte ou la première lecture échoue, consultez Dépannage pour résoudre le problème avant de continuer.