Étape 7 de 25
Connectez un outil de codage IA à Altified
MCP permet à des outils tels que Cursor, Claude et les agents VS Code de poser des questions Altified sur ce projet et d'effectuer des actions approuvées pour vous.
MCP signifie Protocole de contexte du modèleEn clair, il s'agit d'une connexion sécurisée entre un outil de programmation d'IA et votre projet Altified. L'outil d'IA ne se connecte pas directement à votre base de données. Il communique avec le serveur MCP Altified, qui vérifie votre jeton et vos autorisations avant toute utilisation Altified.
La connexion ressemble à ceci
Votre outil d'IA → Serveur MCP Altified → Votre projet Altified
Que sont les paramètres MCP ?
Les paramètres MCP sont l'endroit, dans un éditeur de code d'IA, où vous ajoutez des outils externes utilisables par l'IA. Il ne s'agit pas d'un paramètre du tableau de bord Altified. Recherchez dans votre éditeur un menu ou un fichier nommé MCP, Serveurs MCP, Outils, ou Intégrations.
L'éditeur doit prendre en charge MCP. Un éditeur de texte classique sans assistant IA ne peut pas utiliser cette connexion.
Mettez-le en place du début à la fin
- Ouvrez votre projet. Dans le tableau de bord Altified, ouvrez le projet que vous souhaitez utiliser avec votre outil de codage IA, puis choisissez MCP à partir des fiches de projet ou de la navigation du projet.
- Choisissez les autorisations. Prendre Laissez mon IA s'occuper de tout. si vous souhaitez que l'IA intègre Altified pour vous, ou Lecture seule Si le système ne doit qu'inspecter votre projet, chaque modification nécessitera votre confirmation.
- Créer un jeton. Donnez-lui un nom tel que
Cursor on my laptopLes jetons créés à partir d'un projet sont limités à ce projet. - Copiez immédiatement le jeton. Altified n'affiche le jeton complet qu'une seule fois. Il fonctionne comme un mot de passe pour l'outil d'IA.
- Ajoutez Altified à votre éditeur. Une fois le jeton créé, sélectionnez votre éditeur dans le panneau des jetons. Cursor et VS Code disposent d'un Installer bouton ; Claude Code vous donne une commande à exécuter ; les autres éditeurs reçoivent un JSON avec votre jeton déjà renseigné.
- Vous utilisez un autre éditeur ? Recherchez ses paramètres
MCP, puis choisissez une option telle que Ajouter un serveur, Nouveau serveur MCP, ou Modifier la configurationLa formulation diffère selon les éditeurs. - Collez et enregistrez la configuration. Si l'éditeur accepte le format JSON, collez la configuration que vous avez copiée depuis Altified. S'il demande des champs séparés, utilisez l'URL du serveur.
Authorizationen-tête et jeton affiché ci-dessous. - Redémarrez ou rechargez l'éditeur. Certains éditeurs ne se connectent aux nouveaux serveurs MCP qu'après le redémarrage de l'assistant IA ou de l'éditeur. Approuvez ou activez le serveur Altified si l'éditeur vous le demande.
- Demandez-lui d'intégrer Altified. Ouvrez le dossier de votre application dans l'éditeur et demandez : “Intégrez Altified dans ce projet.” L'IA lit les instructions de configuration de votre projet, vous présente un plan, attend votre approbation, puis installe le SDK, place le sélecteur de langue et vérifie que le SDK est connecté.
Run in your project's terminal.
claude mcp add --transport http altified https://mcp.altified.com/mcp \ --header "Authorization: Bearer YOUR_MCP_TOKEN"
Les exemples ci-dessus utilisent YOUR_MCP_TOKEN Il s'agit d'un jeton d'espace réservé. La page MCP de votre projet le renseigne automatiquement avec votre véritable jeton. Ne publiez jamais la configuration finale.
Autres questions à poser
- « Effectuez un bilan de santé de mon projet Altified. » — Connexion au SDK, clé secrète, sélecteur, progression de la traduction, utilisation et dernier audit SEO.
- « Aidez-moi à configurer le sélecteur de langue Altified. » — Vérifiez les langues, l'ordre, les étiquettes et le style, puis publiez après approbation.
- « Quelles traductions manquent pour le français ? » — Indiquez le contenu manquant ou défectueux et demandez les traductions après votre approbation.
Votre IA vous indiquera de créer la clé secrète du SDK dans le tableau de bord et de la coller dans .env vous-même. MCP ne crée ni ne révèle jamais de clés secrètes.
Si votre éditeur utilise des champs séparés
Server namealtifiedServer URLhttps://mcp.altified.com/mcpHeader nameAuthorizationHeader valueBearer YOUR_MCP_TOKENLe jeton est privé
NEXT_PUBLIC_ variable d'environnement. Si elle est exposée, révoquez-la dans Altified et créez une variable de remplacement.S'il ne se connecte pas
- Le serveur n'apparaît pas : Vérifiez que l'éditeur prend en charge MCP, puis redémarrez-le ou rechargez-le.
- Non autorisé ou 401 : Copiez à nouveau la configuration, vérifiez que le jeton est complet et assurez-vous qu'il n'a pas été révoqué.
- Accès refusé ou erreur 403 : Retournez à Altified et créez un jeton avec l'autorisation requise. Un jeton de projet ne peut pas non plus accéder à un autre projet.
- L'IA ne peut rien changer : vérifier que le jeton dispose de l'autorisation d'écriture requise et approuver l'action demandée lorsque Altified demande une confirmation.
Que signifient ces autorisations ?
projects:read— permet à l'IA de voir les noms des projets, les domaines, les langues et le statut.languages:read— permet à l'IA de voir les langues prises en charge par Altified.translations:read— permet à l'IA de suivre la progression de la traduction.seo:read— permet à l'IA de lire l'état et les résultats de l'audit SEO.integration:read— permet à l'IA de lire les informations de configuration SDK sécurisées.usage:read— permet à l'IA de lire les informations relatives au forfait et à l'utilisation.projects:write— permet à l'IA de demander des modifications de projet et de sélecteur de langue, y compris la publication du sélecteur.languages:write— permet à l'IA de demander l'ajout ou la suppression d'une langue.translations:write— permet à l'IA de demander, de réessayer ou de modifier des traductions, en utilisant votre quota de traductions.
Chaque modification nécessite toujours votre confirmation. Altified vérifie également la propriété du projet, les autorisations des jetons et les limites du forfait. seo:write est réservé pour des actions futures.
Ce que MCP ne fait pas
- Il ne remplace pas le tableau de bord Altified ni le SDK.
- Cela ne donne pas à l'IA votre base de données, vos informations de paiement ni vos secrets de backend.
- Il ne modifie pas automatiquement votre code source ; l’outil de codage IA effectue les modifications de code localement.
- Il ne permet pas à un jeton de projet d'accéder à un autre projet Altified.
Révocation de l'accès
Retour au projet MCP page, trouvez le jeton et choisissez RévoquerL'outil d'IA ne pourra plus se connecter à ce jeton. Créez un nouveau jeton si vous perdez l'ancien ou si vous le partagez accidentellement.
Vous préférez une intégration d'application classique ? Poursuivez avec la suite. guide d'installation du SDK.