Aperçu

Connectez des agents de codage à vos projets Glossia via le Model Context Protocol.

Glossia expose un Model Context Protocol (MCP) serveur qui permet aux agents de codage d'interagir avec vos projets de localisation. Le serveur implémente OAuth 2.1 avec PKCE et l'enregistrement dynamique de client (RFC 7591), donc tout client compatible MCP peut s'authentifier sans configuration manuelle des identifiants.

Ce que le serveur MCP fournit

Une fois connecté, un agent de codage peut :

Consulter le statut de traduction sur vos projets
Lancer les traductions et les révisions
Inspecter les entrées de configuration et de contenu
Accéder au contexte du projet pour des suggestions de code plus intelligentes

URL du serveur

Environnement	URL
Production	`https://glossia.ai/mcp`
Développement local	`http://localhost:4050/mcp`

Flux d'authentification

Le serveur MCP utilise le flux standard d'autorisation par code OAuth 2.1 avec PKCE. Vous n'avez pas besoin de créer manuellement des clients OAuth. Le flux fonctionne comme ceci :

L'agent découvre votre serveur via /.well-known/oauth-authorization-server
Il s'enregistre comme client OAuth via le point d'enregistrement dynamique
Il ouvre votre navigateur pour la connexion et le consentement
Après votre approbation, l'agent reçoit un jeton d'accès et l'attache à toutes les requêtes MCP.

Ajout de Glossia à un agent de codage

OpenAI Codex

Ajoutez le serveur à votre fichier de configuration Codex à ~/.codex/config.toml:

[mcp_servers.glossia]
url = "https://glossia.ai/mcp"

Ensuite, exécutez la connexion OAuth :

codex mcp login glossia

Votre navigateur s'ouvrira pour l'authentification. Une fois approuvé, Codex stocke le jeton localement et l'utilise pour les futures sessions.

Pour vérifier la connexion :

codex mcp list

Pour le développement local, remplacez l'URL :

[mcp_servers.glossia-local]
url = "http://localhost:4050/mcp"

Claude Code

Ajoutez le serveur à vos paramètres MCP Claude Code (,.claude/settings.json ou au fichier de paramètres global):

{
  "mcpServers": {
    "glossia": {
      "url": "https://glossia.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Claude Code gérera automatiquement le flux OAuth lors de sa première connexion.

Autres clients MCP

Tout client qui prend en charge la spécification d'autorisation MCP fonctionnera. Les exigences clés sont :

Transport: Transport HTTP
>Découverte: Le client doit prendre en charge les métadonnées de ressource protégée OAuth 2.0 (RFC 9728)
Enregistrement: Enregistrement dynamique du client (RFC 7591) ou Documents métadonnées Client ID
Flux d'authentification: Code d'autorisation avec PKCE (S256)

Dirigez le client vers l'URL de votre serveur Glossia MCP et laissez-le gérer automatiquement la découverte et l'enregistrement.

Points de terminaison de découverte

Le serveur publie deux documents métadonnées que les clients MCP utilisent pour démarrer le flux OAuth :

Point de terminaison	Description
`/.well-known/oauth-authorization-server`	Méta- données du serveur d'autorisation (points de terminaison, types d'octroi pris en charge, méthodes PKCE)
`/.well-known/oauth-protected-resource`	Métadonnées des ressources protégées (portées, serveurs d'autorisation)

Limites de débit

Les points de terminaison OAuth imposent des limites de débit pour prévenir les abus :

Point de terminaison	Limite
`POST /oauth/register`	5 requêtes par minute
`POST /oauth/token`	30 requêtes par minute
`POST /oauth/introspect`	30 requêtes par minute
`POST /oauth/revoke`	30 requêtes par minute

Lorsqu'une limite de débit est dépassée, le serveur renvoie HTTP 429 avec un Retry-After en-tête.

Dépannage

L'enregistrement échoue avec \"invalid_client_metadata\"

Le point de terminaison d'enregistrement dynamique n'accepte que les token_endpoint_auth_method valeurs. Les clients publics (la plupart des agents de codage) doivent envoyer "none", ce que Glossia gère automatiquement en recourant aux méthodes d'authentification par défaut avec contrainte de PKCE.

« Callback OAuth invalide » après approbation

Assurez-vous que votre serveur Glossia est en cours d'exécution et accessible à l'URL que vous avez configurée. Le callback s'effectue sur un port local que l'agent de codage ouvre temporairement. Les pare-feux ou les VPN peuvent parfois bloquer cela.

L'échange de jeton échoue

Vérifiez que le champ code_challenge_methods_supported est présent dans les métadonnées du serveur d'autorisation. Le serveur doit annoncer le support de S256 pour que PKCE fonctionne. Glossia inclut cela par défaut.

L'agent ne peut pas atteindre le serveur

Pour le développement local, assurez-vous que le serveur Phoenix est en cours d'exécution (mix phx.server) et écoute sur le port attendu (par défaut : 4050). Le point de terminaison MCP doit être accessible depuis le processus de l'agent.