--- title: "Configurer le MCP Optimi" description: "Connecter votre assistant de code au MCP Optimi avec OpenCode, Claude Code, Codex ou un autre client compatible pour consulter l'analytique et les jobs." canonical_url: https://optimi.com/fr/docs/mcp md_url: https://optimi.com/fr/docs/mcp.md last_updated: 2026-10-09 --- # Configurer le MCP Optimi Le point d'accès Model Context Protocol (MCP) d'Optimi permet à votre assistant de code de consulter l'analytique et l'état des jobs avec votre compte Optimi. Connectez-le avec OpenCode, Claude Code, Codex ou un autre client MCP prenant en charge le transport et l'authentification décrits ci-dessous. Le service est hébergé à l'adresse `https://dash.optimi.com/mcp`. Vous vous connectez à ce service distant ; aucun serveur MCP Optimi n'est à installer localement. ## Avant de commencer - Installez l'assistant de code compatible MCP de votre choix. - Disposez d'un compte Optimi ayant accès à au moins un tenant. - Pour un autre déploiement, utilisez son URL d'origine suivie de `/mcp` à la place de l'adresse ci-dessous. La connexion MCP doit y être configurée. ## 1. Ajouter le serveur MCP Utilisez ces paramètres de connexion dans votre assistant : | Paramètre | Valeur | | --- | --- | | Nom du serveur | `optimi` | | URL | `https://dash.optimi.com/mcp` | | Transport | Streamable HTTP | | Authentification | OAuth avec découverte de la ressource protégée et enregistrement dynamique des clients | Ne renseignez pas d'identifiant client, de secret client, d'en-tête de tenant ni de scope OAuth. Le client découvre les paramètres d'authentification, s'enregistre et demande les scopes annoncés par le point d'accès. Il doit demander un jeton pour l'URL MCP via le paramètre OAuth `resource`. Suivez les instructions correspondant à votre client ci-dessous. ### OpenCode Ajoutez la configuration suivante à `opencode.json` à la racine de votre projet, ou à `~/.config/opencode/opencode.json` pour l'utiliser dans tous vos projets. Si un fichier de configuration existe déjà, ajoutez l'entrée `optimi` à son objet `mcp`. ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "optimi": { "type": "remote", "url": "https://dash.optimi.com/mcp" } } } ``` Redémarrez OpenCode après avoir enregistré la configuration. Consultez la [documentation MCP d'OpenCode](https://opencode.ai/docs/mcp-servers/) pour les options de configuration du client. ### Claude Code Depuis le répertoire de votre projet, ajoutez le serveur HTTP distant : ```sh claude mcp add --transport http optimi https://dash.optimi.com/mcp ``` Par défaut, l'entrée est privée et disponible uniquement pour vous dans le projet courant. Ajoutez `--scope user` pour la rendre disponible dans tous vos projets. Consultez la [documentation MCP de Claude Code](https://code.claude.com/docs/en/mcp) pour les portées et les options de configuration. ### Codex Ajoutez le serveur distant avec la CLI Codex : ```sh codex mcp add optimi --url https://dash.optimi.com/mcp ``` Vous pouvez aussi ajouter cette entrée à `~/.codex/config.toml` : ```toml [mcp_servers.optimi] url = "https://dash.optimi.com/mcp" ``` La CLI Codex et l'extension IDE partagent cette configuration. Consultez la [documentation MCP de Codex](https://developers.openai.com/codex/extend/mcp) pour les options de configuration du client. ### Autres clients MCP Dans les paramètres MCP de votre client, ajoutez un serveur distant nommé `optimi` avec l'URL ci-dessus, choisissez Streamable HTTP et activez l'authentification OAuth automatique. Le client doit prendre en charge la découverte de la ressource protégée, l'enregistrement dynamique des clients et les indicateurs de ressource OAuth. Un client limité aux serveurs locaux stdio ou aux clés API statiques ne peut pas effectuer cette connexion. ## 2. Se connecter Lancez l'authentification avec la commande ou les paramètres MCP de votre client : | Client | Se connecter | Vérifier l'état de la connexion | | --- | --- | --- | | OpenCode | Lancez `opencode mcp auth optimi` depuis le répertoire de votre projet. | `opencode mcp list` | | Claude Code | Lancez `claude`, ouvrez `/mcp`, sélectionnez `optimi` et choisissez **Authenticate**. | `/mcp` ou `claude mcp list` | | Codex | Lancez `codex mcp login optimi`. | `codex mcp list` ou `/mcp` dans l'interface terminal Codex | | Autres clients | Utilisez l'action **Connecter**, **Se connecter** ou **Authentifier** du serveur. | Consultez l'état du serveur MCP dans le client. | Terminez la connexion dans votre navigateur avec votre compte Optimi. Votre client conserve les identifiants obtenus pour les requêtes suivantes. MCP utilise un jeton dont l'audience correspond exactement à l'URL MCP. Un jeton de connexion au tableau de bord ou à la CLI ne peut pas le remplacer. ## 3. Choisir un tenant et lancer une requête Demandez à votre assistant : > Utilise le MCP Optimi pour lister les tenants auxquels j'ai accès, puis > affiche les jeux de données analytiques du tenant que je choisirai. L'assistant doit d'abord appeler `list_tenants`. Si vous avez accès à plusieurs tenants, il vous demande lequel utiliser et transmet l'identifiant retourné dans `tenantId` lors des appels suivants. Avec un seul tenant, `tenantId` peut être omis. Une fois le tenant sélectionné, essayez : > Utilise le MCP Optimi pour résumer mon trafic sur les dernières 24 heures et > afficher l'état de mes jobs d'export récents. L'assistant utilise `analytics_catalog` pour découvrir les jeux de données et les métriques avant d'appeler `query_analytics`. Les outils disponibles dépendent de vos permissions existantes et des fonctionnalités auxquelles le tenant sélectionné a droit. ## Outils disponibles | Outil | Fonction | | --- | --- | | `list_tenants` | Liste les tenants auxquels votre compte a accès. | | `get_context` | Affiche le tenant sélectionné et vos scopes effectifs. | | `analytics_catalog` | Liste les jeux de données analytiques, métriques, dimensions et filtres disponibles. | | `query_analytics` | Exécute une requête analytique avec un nombre de résultats limité. | | `list_jobs` | Liste les jobs récents, y compris les exports. | | `get_job` | Consulte l'état d'un job précis. | Tous les outils sont en lecture seule. Ils ne peuvent pas modifier la configuration CDN, purger du contenu, modifier la facturation ni changer les appartenances aux tenants. Les requêtes analytiques retournent 100 lignes par défaut, avec un maximum de 500. Les réponses des jobs n'incluent pas leur payload. ## Dépannage En cas de problème de connexion ou d'authentification, vérifiez d'abord l'état MCP dans votre client. OpenCode propose aussi `opencode mcp debug optimi` pour diagnostiquer la connexion et la découverte OAuth. Dans Claude Code, utilisez `/mcp` ou `claude mcp get optimi` ; dans Codex, utilisez `/mcp` ou `codex mcp list`. | Symptôme | Vérification | | --- | --- | | `optimi` n'apparaît pas dans la liste des serveurs | Vérifiez l'emplacement ou la portée de la configuration et redémarrez votre client. Exécutez les commandes propres au projet depuis son répertoire. | | La connexion ne se termine pas | Vérifiez que l'URL se termine par `/mcp`. Pour un autre déploiement, demandez à son opérateur de vérifier la ressource MCP et l'enregistrement dynamique des clients dans Auth0. | | HTTP 401 | Reconnectez-vous avec l'action d'authentification de votre client décrite ci-dessus. Si l'en-tête de réponse `WWW-Authenticate` ne contient pas `resource_metadata`, la requête n'a pas atteint le point d'accès MCP Optimi ; vérifiez l'URL et le routage. | | HTTP 403 après connexion | Le point d'accès a rejeté l'identité connectée. Demandez à votre administrateur Optimi de vérifier les accès de votre compte. | | `insufficient_permissions` | Vous êtes connecté, mais vos permissions ne permettent pas d'utiliser cet outil. Demandez à l'administrateur du tenant de vérifier votre rôle. | | `entitlement_required` | Le tenant sélectionné ne dispose pas du droit d'accès à la fonctionnalité requise par cet outil. | ## Se déconnecter Utilisez les paramètres MCP de votre client pour vous déconnecter ou effacer l'authentification enregistrée du serveur. Dans OpenCode, lancez `opencode mcp logout optimi`. Dans Claude Code, ouvrez `/mcp`, sélectionnez `optimi` et choisissez **Clear authentication**. Pour ne plus charger l'intégration, supprimez ou désactivez le serveur `optimi` dans votre client. Dans OpenCode, définissez `"enabled": false` dans l'entrée JSON du serveur ; dans Codex, définissez `enabled = false` dans l'entrée TOML du serveur. Dans Claude Code, utilisez `/mcp` pour désactiver le serveur ou lancez `claude mcp remove optimi` pour le supprimer.