> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.faaaster.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Comment configurer le MCP Faaaster ? # Utiliser le MCP Faaaster avec Codex ou Claude Le serveur MCP Faaaster permet de piloter vos sites depuis votre propre agent IA, notamment **Codex**, **Claude**, **Claude Desktop** ou **Claude Code**. Vous pouvez par exemple demander à votre agent de consulter l’état d’un site, lire ses logs, gérer ses sauvegardes, intervenir sur WordPress ou lancer une session de développement encadrée. Le modèle utilisé et sa facturation restent chez le fournisseur de votre agent. L’utilisation du MCP ne consomme donc pas les crédits de l’agent IA intégré à Faaaster. ## Choisir votre méthode * [Codex avec l’interface graphique](#configurer-faaaster-dans-codex-avec-linterface-graphique) * [Codex CLI](#configurer-faaaster-avec-codex-cli) * [Claude ou Claude Desktop](#configurer-faaaster-dans-claude-ou-claude-desktop) * [Claude Code CLI](#configurer-faaaster-avec-claude-code-cli) ## Prérequis Avant de commencer, vérifiez que : * vous disposez d’un compte Faaaster actif ; * vous êtes propriétaire ou administrateur d’au moins un site ; * vous avez accès à Codex, Claude, Claude Desktop ou Claude Code ; * l’accès MCP n’a pas été désactivé pour le site ou l’organisation. Vous n’avez besoin d’aucune clé API Faaaster et vous ne devez jamais transmettre votre mot de passe WordPress à l’agent. La connexion utilise l’authentification OAuth Faaaster dans votre navigateur. ## Adresse du serveur MCP Utilisez l’adresse suivante : ```text https://mcp.faaaster.io/mcp ``` Vous pouvez également la retrouver dans Faaaster, depuis votre site, dans **Développement → IA / MCP**. ## Configurer Faaaster dans Codex avec l’interface graphique La configuration graphique est recommandée si vous utilisez l’application Codex ou son extension IDE. ### 1. Ouvrir les réglages MCP 1. Ouvrez les réglages de Codex. 2. Sélectionnez **MCP servers**. 3. Cliquez sur **Add server**. ### 2. Ajouter Faaaster Renseignez les informations suivantes : | Champ | Valeur | | ---- | | Nom | `faaaster` | | Type | **Streamable HTTP** | | URL | https://mcp.faaaster.io/mcp | Enregistrez le serveur, puis redémarrez Codex ou l’extension si l’interface vous le demande. ### 3. Autoriser Codex Dans la liste des serveurs MCP, sélectionnez **Authenticate** pour `faaaster`. Votre navigateur s’ouvre sur la page de connexion. Connectez-vous avec votre compte Faaaster, vérifiez l’autorisation demandée, puis revenez dans Codex. ### 4. Vérifier la connexion Dans une conversation Codex, saisissez : ```text /mcp ``` Le serveur `faaaster` doit apparaître comme connecté. ## Configurer Faaaster avec Codex CLI ### 1. Ajouter le serveur Dans un terminal, exécutez : ```bash codex mcp add faaaster --url https://mcp.faaaster.io/mcp ``` Cette configuration est enregistrée par Codex et partagée par les clients Codex locaux utilisant le même fichier de configuration. ### 2. Se connecter à Faaaster Lancez ensuite l’authentification OAuth : ```bash codex mcp login faaaster ``` Votre navigateur s’ouvre sur la page de connexion. Connectez-vous avec votre compte Faaaster, puis autorisez Codex à accéder au serveur MCP. ### 3. Vérifier la connexion Listez les serveurs configurés : ```bash codex mcp list ``` Vous pouvez également ouvrir Codex et saisir : ```text /mcp ``` Le serveur `faaaster` doit apparaître comme connecté. Si Codex était déjà ouvert pendant la configuration, redémarrez la session. ## Configurer Faaaster dans Claude ou Claude Desktop Ce parcours utilise les connecteurs personnalisés de Claude. Il fonctionne dans Claude sur le web et dans Claude Desktop. ### Compte Free, Pro ou Max 1. Ouvrez **Customize → Connectors**. 2. Cliquez sur le bouton **+** à côté de Connectors. 3. Sélectionnez **Add custom connector**. 4. Saisissez `Faaaster` comme nom. 5. Saisissez https://mcp.faaaster.io/mcp comme URL. 6. Ne renseignez pas de Client ID ni de Client Secret dans les réglages avancés. 7. Cliquez sur **Add**, puis sur **Connect**. 8. Connectez-vous avec votre compte Faaaster dans la fenêtre OAuth qui s’ouvre. ### Compte Team ou Enterprise Un propriétaire de l’organisation Claude doit d’abord ajouter le connecteur : 1. Ouvrez **Organization settings → Connectors**. 2. Cliquez sur **Add**. 3. Survolez **Custom**, puis sélectionnez **Web**. 4. Ajoutez l’URL https://mcp.faaaster.io/mcp sans Client ID ni Client Secret personnalisé. 5. Enregistrez le connecteur. Chaque membre autorisé peut ensuite ouvrir **Customize → Connectors**, rechercher `Faaaster`, puis cliquer sur **Connect** pour s’authentifier avec son propre compte Faaaster. ### Activer Faaaster dans une conversation Dans une nouvelle conversation Claude : 1. cliquez sur le bouton **+** en bas à gauche du champ de saisie ; 2. sélectionnez **Connectors** ; 3. activez `Faaaster` pour cette conversation. Vous pouvez maintenant demander à Claude de lister vos sites Faaaster. Si le connecteur n’apparaît pas, vérifiez qu’il est bien connecté dans **Customize → Connectors**. ## Configurer Faaaster avec Claude Code CLI ### 1. Ajouter le serveur Pour rendre Faaaster disponible dans tous vos projets Claude Code, exécutez : ```bash claude mcp add --transport http faaaster --scope user https://mcp.faaaster.io/mcp ``` Le scope `user` conserve cette configuration pour votre compte local sans l’ajouter aux fichiers du projet. ### 2. Se connecter à Faaaster Vous pouvez démarrer directement l’authentification OAuth : ```bash claude mcp login faaaster ``` Vous pouvez aussi ouvrir une session Claude Code : ```bash claude ``` Puis saisir : ```text /mcp ``` Sélectionnez `faaaster`, choisissez l’option de connexion, puis terminez l’autorisation dans votre navigateur. ### 3. Vérifier la connexion Dans un terminal, exécutez : ```bash claude mcp list ``` Le serveur `faaaster` doit afficher l’état `Connected`. Dans Claude Code, la commande `/mcp` permet également de consulter son état et les outils disponibles. ## Premières demandes à essayer Une fois la connexion établie, formulez vos demandes normalement. Par exemple : ```text Liste mes sites Faaaster. ``` ```text Quel est l’état du site example.com ? ``` ```text Liste les extensions WordPress installées sur ce site et indique lesquelles sont actives. ``` ```text Analyse les dernières erreurs PHP de ce site. ``` ```text Crée une sauvegarde de ce site. ``` ```text Corrige le problème décrit sur ce site dans une session de développement. ``` Lorsque plusieurs sites correspondent à votre demande, l’agent vous demande de choisir la cible. Vous pouvez éviter cette étape en indiquant directement le nom ou le domaine du site. ## Confirmations et approbations Faaaster applique les mêmes règles de sécurité, quel que soit l’agent utilisé : * les lectures et diagnostics sans modification peuvent être exécutés directement ; * les mutations courantes demandent une confirmation dans Codex ou Claude ; * les opérations sensibles, comme une restauration ou une session de développement, peuvent afficher un lien d’approbation Faaaster ; * les droits, la cible et l’identité WordPress sont revérifiés avant chaque exécution ; * les opérations restent attribuées à votre compte dans l’historique Faaaster. Si un lien d’approbation apparaît, ouvrez-le, vérifiez l’opération et validez-la dans Faaaster. Revenez ensuite dans votre agent et demandez-lui de poursuivre. ## Résoudre les problèmes courants ### Le serveur demande une authentification Dans l’interface graphique de Codex, ouvrez **Réglages → MCP servers**, sélectionnez `faaaster`, puis cliquez sur **Authenticate**. Dans Claude ou Claude Desktop, ouvrez **Customize → Connectors**, recherchez `Faaaster`, puis cliquez sur **Connect**. Depuis un terminal, relancez la connexion OAuth : ```bash codex mcp login faaaster ``` ou : ```bash claude mcp login faaaster ``` Dans Claude Code, vous pouvez également utiliser `/mcp`, sélectionner `faaaster`, puis choisir **Re-authenticate**. ### Le navigateur ne s’ouvre pas Copiez l’adresse d’autorisation affichée dans le terminal et ouvrez-la manuellement dans votre navigateur. Après la connexion, revenez dans le terminal pour terminer le processus. ### Aucun site n’est disponible Vérifiez que vous utilisez le bon compte Faaaster et que ce compte est propriétaire ou administrateur du site concerné. Vérifiez également la politique MCP dans **Développement → IA / MCP**. ### Le serveur apparaît comme déconnecté Vérifiez d’abord l’adresse configurée : ```text https://mcp.faaaster.io/mcp ``` Consultez ensuite le détail de la connexion : ```bash codex mcp list ``` ou : ```bash claude mcp get faaaster ``` Une erreur `401` ou `403` indique généralement qu’une nouvelle authentification ou qu’une autorisation Faaaster est nécessaire. ### Une action attend toujours après validation Revenez dans la conversation et demandez à l’agent de vérifier l’état de l’action puis de poursuivre. Ne créez pas une seconde opération identique : Faaaster conserve un identifiant d’opération pour éviter les doubles exécutions. ## Sécurité et révocation Vous pouvez révoquer l’accès MCP depuis les réglages Faaaster ou effacer l’authentification depuis le client utilisé. Dans Claude ou Claude Desktop, ouvrez **Customize → Connectors**, sélectionnez `Faaaster`, puis déconnectez le connecteur. Dans Claude Code, ouvrez `/mcp`, sélectionnez `faaaster`, puis utilisez **Clear authentication**. Dans Codex, supprimez ou désactivez `faaaster` depuis **Réglages → MCP servers**. Pour consulter les commandes disponibles dans Codex CLI : ```bash codex mcp --help ``` Ne communiquez jamais à l’agent : * votre mot de passe WordPress ; * une clé API ou un secret d’hébergement ; * un token OAuth copié depuis le navigateur. Le serveur MCP Faaaster gère lui-même l’authentification, les permissions, les confirmations et l’audit. ## Documentation des clients * [Configurer un serveur MCP dans Codex](https://developers.openai.com/codex/mcp/) * [Ajouter un connecteur MCP personnalisé dans Claude ou Claude Desktop](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) * [Configurer un serveur MCP dans Claude Code](https://code.claude.com/docs/en/mcp)