# Serveur MCP (bêta fermée)

### Guide de configuration du Commanders Act MCP Server

Ce guide explique comment connecter Claude (ou chatGPT, etc.) au serveur Commanders Act MCP afin que votre équipe puisse expérimenter l’accès à l’IA à Commanders Act via le protocole standard Model Context Protocol.

### 1. Vue d’ensemble

Le serveur Commanders Act MCP expose les capacités de la plateforme Commanders Act sous forme d’outils appelables par l’IA via le protocole standard Model Context Protocol.

Il est conçu pour être utilisé par des clients IA compatibles MCP, sans nécessiter d’intégration propriétaire.

Le serveur utilise OAuth 2.1 avec PKCE pour l’authentification et expose un large éventail d’outils couvrant Sources, Destinations, Enrichments, Cleansing, Tag Management, Health, Reports et Admin.

Le serveur MCP est actuellement en **closed beta**. À ce stade, seul un nombre limité d’utilisateurs le teste.

Les cas d’usage typiques incluent :

* découvrir les sites disponibles pour l’utilisateur authentifié
* explorer les données de Sources, Destinations, Enrichments, Cleansing, Health, Reports, Tag Management et Admin
* utiliser les données Commanders Act via des workflows d’IA sans construire d’intégration propriétaire

### 2. Conditions d’accès

Comme le serveur MCP est actuellement en closed beta, l’accès n’est pas encore généralement disponible. À ce stade, nous n’acceptons pas de nouveaux utilisateurs, mais vous pouvez contacter l’équipe support pour être ajouté à la liste d’attente.

### 3. Prérequis

Pour utiliser le serveur Commanders Act MCP, vous avez besoin de :

* un compte Commanders Act
* un accès au serveur MCP dans le cadre de la closed beta
* un client IA compatible MCP
* un navigateur disponible pour le flux d’authentification

***

### 4. Authentification

Le serveur Commanders Act MCP utilise OAuth 2.1 avec PKCE.

Le flux d’authentification est entièrement automatique et sécurisé. Aucun token n’est manipulé manuellement ni exposé à l’utilisateur.

Flux typique :

1. Le client tente d’appeler le serveur MCP
2. Le serveur indique qu’une authentification est requise
3. Le client découvre automatiquement le flux d’authentification
4. Une fenêtre de navigateur s’ouvre avec la page de connexion Commanders Act
5. L’utilisateur se connecte avec ses identifiants Commanders Act
6. Le client termine le processus d’authentification de manière sécurisée
7. Le client inclut le token dans tous les appels d’outils suivants

Une fois authentifié, la connexion est établie et toutes les interactions avec le serveur MCP sont fluides.

***

### 5. Connexion d’un client MCP

Le serveur Commanders Act MCP est exposé via une interface MCP standard.

Pour connecter un client IA compatible, vous devez enregistrer le serveur MCP à l’aide des informations de connexion fournies par l’équipe support de Commanders Act.

Selon le client, cela peut impliquer :

* d’ajouter le serveur MCP dans une UI
* ou de le déclarer dans un fichier de configuration

Une fois configuré, le flux d’authentification démarrera automatiquement lors de la première utilisation.

***

### 6.a. Exemple d’environnement client : Claude Code

Claude Code est un exemple de client compatible MCP.

Pour connecter le serveur Commanders Act MCP :

1. Ouvrez Claude
2. Allez dans Settings → Integrations
3. Activez le connecteur nommé “Commanders Act MCP”
4. Lorsque vous y êtes invité, saisissez l’URL du serveur MCP fournie par Commanders Act
5. Terminez le flux d’authentification dans le navigateur

Une fois connecté, vous pouvez commencer à utiliser le serveur MCP directement dans les conversations.

Pour vérifier la connexion, vous pouvez demander :

“Can you list the available tools from the Commanders Act MCP?”

Vous devriez voir tous les outils disponibles exposés par le serveur.

### 6.b. Exemple d’environnement client : ChatGPT

ChatGPT est un autre client compatible MCP.

Pour connecter le serveur Commanders Act MCP :

1. Ouvrez ChatGPT
2. Allez dans Settings → Apps & Connectors → Advanced
3. Activez Developer Mode
4. Allez dans Connectors et créez un nouveau connecteur
5. Utilisez les informations de connexion du serveur MCP fournies par Commanders Act
6. Sélectionnez OAuth comme méthode d’authentification
7. Enregistrez le connecteur

Pour utiliser le serveur MCP dans une conversation :

1. Démarrez un nouveau chat
2. Activez Developer Mode dans le chat
3. Ajoutez le connecteur Commanders Act comme source

Une fois connecté, ChatGPT pourra appeler directement les outils MCP.

Pour valider la connexion, vous pouvez demander :

Can you list the available tools from the Commanders Act MCP?

ChatGPT affichera les appels d’outils dans l’interface. Certaines actions peuvent nécessiter une confirmation.

***

### 7. Familles d’outils disponibles

Le serveur MCP expose plus de 35 outils dans les domaines suivants :

**Profile**

* lister les sites accessibles pour l’utilisateur authentifié

**Sources**

* lister les catégories de sources
* lister les sources configurées
* récupérer les détails d’une source

**Destinations**

* lister les catégories de destinations
* lister les destinations configurées
* récupérer les détails d’une destination

**Enrichments and Cleansing**

* lister les enrichments
* récupérer les détails d’un enrichment
* lister les transformations de cleansing
* récupérer les détails d’une transformation

**Health and Monitoring**

* récupérer la qualité des données source
* récupérer les cookie scanners
* récupérer les cookies du scanner
* récupérer le code d’installation du scanner
* récupérer les données de monitoring de collecte
* récupérer les statistiques de privacy
* récupérer les alertes de health
* récupérer les notifications de health

**Tag Management**

* lister les web containers
* récupérer les détails d’un container
* lister les variables du web datalayer
* lister les web triggers
* lister les web constraints
* lister les web perimeters
* lister les server-side containers
* lister les variables du server-side datalayer
* lister les server-side tags

**Explore and Reports**

* lister les reports
* récupérer les données d’un report

**Data Management**

* récupérer le datalayer normalisé

**Admin**

* récupérer les journaux d’activité
* lister les utilisateurs
* lister les règles de redirection

***

### 8. Première validation

Après la connexion et l’authentification, vous pouvez valider l’intégration avec une simple requête en langage naturel.

Prompt recommandé :

Can you list the sites available to my Commanders Act account?

Vous pouvez également vérifier que le serveur MCP est correctement connecté en demandant :

Can you list the available tools from the Commanders Act MCP?

Cela confirme :

* l’authentification fonctionne
* la connexion MCP est active
* les outils sont correctement exposés
* vos permissions sont correctement appliquées

Vous pouvez ensuite continuer avec des prompts tels que :

Can you list the configured sources for my account?\
Can you show me the configured destinations?\
Can you show me current health alerts?\
Can you list the available web containers?\
Can you list the available reports?

***

### 9. Durée de vie du token

Les access tokens sont limités dans le temps.

La durée de vie par défaut est de 8 heures.

Lorsque le token expire, une nouvelle authentification est nécessaire.

***

### 10. Dépannage

La page de connexion ne s’ouvre pas\
Assurez-vous que votre client prend en charge MCP avec authentification et qu’un navigateur peut être lancé

L’authentification ne se termine pas\
Vérifiez que les informations de connexion au serveur MCP fournies par le support sont correctes et accessibles

Les outils n’apparaissent pas dans Claude\
Assurez-vous que le connecteur “Commanders Act MCP” est activé et que l’authentification est terminée

Vous pouvez valider en demandant :

Can you list the available tools from the Commanders Act MCP?

Si aucun outil n’apparaît, essayez de reconnecter le serveur MCP ou de redémarrer la session

La connexion fonctionne mais aucune donnée n’est renvoyée\
Commencez par une demande simple, comme lister les sites disponibles, pour vérifier les permissions

***

### 11. Sécurité et gouvernance

Le serveur Commanders Act MCP s’appuie sur :

* une interface MCP standard
* une authentification basée sur OAuth
* une connexion via navigateur
* une utilisation sécurisée du token gérée par le client

Cela permet d’expérimenter via des clients IA compatibles MCP approuvés sans nécessiter d’intégration personnalisée.

Comme le serveur est actuellement en closed beta, l’accès reste restreint.

***

### 12. Support

Pour des informations d’accès ou de configuration, contactez l’équipe support de Commanders Act.

Elle peut fournir :

* les informations de connexion
* des conseils de configuration
* les premières étapes recommandées


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/mcp-server-closed-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
