> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/mcp.md).

# MCP

{% hint style="info" %}
**Qui peut utiliser cette fonctionnalité ?**

Tout utilisateur d'une organisation Aphex où MCP est activé peut utiliser cette fonctionnalité. Pour la configuration initiale, les administrateurs système doivent activer la fonctionnalité.
{% endhint %}

Le connecteur MCP d’Aphex lit votre journal et votre plan, afin que vous puissiez travailler avec les données de votre projet directement depuis votre outil d’IA (Claude, ChatGPT, Perplexity, Copilot ou tout autre outil compatible MCP). Posez des questions sur vos journaux, vos tâches, ce qui a bougé et qui l’a déplacé, et sur la comparaison entre les éléments et votre plan publié, et votre IA peut s’appuyer à la fois sur le journal et sur le plan pour répondre. Aphex fournit les données mot pour mot, et votre IA se charge de la réflexion et de la rédaction.

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FhZWlIZ3QCrcumQt9hYYD%2FMCP%20Intro.svg?alt=media&amp;token=1a6d95a2-baf8-4429-8f60-633859494b67" alt=""><figcaption></figcaption></figure>

### Fonctionnalités MCP

***

Avec le connecteur MCP d’Aphex, vous pouvez interroger votre outil d’IA sur vos journaux, votre plan ou les deux à la fois.

#### Questions d’exemple

<table><thead><tr><th width="117.65625">Application</th><th width="645.8359375">Question</th></tr></thead><tbody><tr><td><i class="fa-chart-gantt">:chart-gantt:</i> Planificateur</td><td>« Comment s’est-on débrouillés la semaine dernière ? »</td></tr><tr><td><i class="fa-chart-gantt">:chart-gantt:</i> Planificateur</td><td>« Des jalons ont-ils bougé depuis la publication de vendredi ? Pourquoi ? »</td></tr><tr><td><i class="fa-chart-gantt">:chart-gantt:</i> Planificateur</td><td>« Qui a déplacé les dates de la [tâche] la semaine dernière ? »</td></tr><tr><td><i class="fa-notebook">:notebook:</i> Journal</td><td>« Résumez le total des heures des ferrailleurs sur les journaux de la semaine dernière. »</td></tr><tr><td><i class="fa-notebook">:notebook:</i> Journal</td><td>« Trouvez chaque enregistrement mentionnant l’avancement du [sous-traitant] sur le [périmètre] au cours des deux derniers mois - je rédige une lettre. »</td></tr><tr><td><i class="fa-notebook">:notebook:</i> Journal</td><td>« Lisez les journaux de la semaine dernière sur ce projet - y a-t-il des signes avant-coureurs que nous devrions émettre ? »</td></tr><tr><td>Les deux</td><td>« Comment le [sous-traitant] se situe-t-il par rapport au plan ? »</td></tr><tr><td>Les deux</td><td>« Qu’ont fait les retards des journaux de la semaine dernière au programme ? »</td></tr></tbody></table>

Votre IA lit les enregistrements, repère les schémas et rédige le résultat. Aphex fournit les données exactement telles qu’elles ont été enregistrées, ainsi que l’identité de la personne qui les a saisies ou modifiées et le moment où cela a eu lieu.

{% hint style="info" %}
**Astuce :** Les réponses sont plus précises lorsque votre question mentionne une semaine, une zone, un sous-traitant ou une tâche.
{% endhint %}

### Activer le MCP pour l’organisation

***

Avant de pouvoir configurer le MCP pour l’organisation, vous devrez <a href="https://www.aphex.co/contact-sales" class="button primary">Nous contacter</a> avec notre équipe pour faire activer la fonctionnalité.

Une fois activée, les administrateurs système peuvent activer la fonctionnalité pour l’organisation.

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FSxXY0S9lGnpDKsQH8mtN%2FAI%20-%20MCP.svg?alt=media&amp;token=25ed4365-5f93-49c1-9c2e-939d77d94ea5" alt=""><figcaption></figcaption></figure>

**Pour activer le MCP pour l’organisation :**

* Depuis votre page d’accueil Aphex, allez dans <kbd>Admin</kbd> → <kbd>IA</kbd>
* Activez ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fi95XyOgpy7hzTLYWhvru%2FControl.svg?alt=media\&token=b4440363-6bc5-4836-8d65-19a701f9a308) <kbd>MCP</kbd>
* Une fois activée, tous les utilisateurs de l’organisation peuvent connecter leur outil d’IA à Aphex.

{% hint style="warning" %}
Seuls les administrateurs système ont l’autorisation d’activer le MCP pour l’organisation
{% endhint %}

### Vérifier si le MCP est activé

***

Si vous n’êtes pas administrateur système, vous pouvez vérifier si le MCP est activé au niveau du projet.

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FKcgWPdB1WUn7GzXSgiBX%2FProject%20Level%20MCP.svg?alt=media&amp;token=2e11b2ac-a349-46c1-a74a-1d9df6451e66" alt=""><figcaption></figcaption></figure>

**Pour voir si le MCP est activé :**

* Ouvrez votre projet
* Cliquez sur le <kbd>nom du projet</kbd> → <kbd>IA</kbd>
* **Si le MCP a été activé :** Vous verrez les étapes de configuration du MCP
* **Si votre administrateur système n’a pas encore activé la fonctionnalité :** Il vous sera demandé de solliciter l’activation de la fonctionnalité
* **Si le MCP n’est pas inclus dans votre formule :** Il vous sera demandé de nous contacter

## Connectez vos outils d’IA

***

Une fois le MCP activé pour l’organisation, tous les utilisateurs de l’organisation peuvent connecter leur outil d’IA à Aphex.

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FDetVroC21E4JkovZgZiU%2FMCP%20Claude.svg?alt=media&amp;token=f527389b-e472-4efb-b22b-73bd9c99dddf" alt=""><figcaption></figcaption></figure>

**Comment connecter vos outils d’IA :**

<details>

<summary><strong>Claude</strong></summary>

* Ouvrez Claude → <kbd>Paramètres</kbd>
* Sélectionnez <kbd>Connecteurs</kbd>
* Cliquez sur <kbd>Parcourir</kbd>
* Rechercher <kbd>Aphex</kbd>
* Cliquez sur le + à côté du connecteur Aphex
* Votre navigateur s’ouvrira et vous demandera de vous connecter - utilisez votre compte Aphex
* Choisissez l’organisation à laquelle vous voulez vous connecter
* Cliquez sur <kbd>Autoriser</kbd> à accorder l’accès
* Retournez dans Claude et commencez à poser des questions sur vos projets

**Conseils de dépannage :**

* « Aucun outil disponible » - Votre organisation n’a pas encore activé MCP. Demandez à votre administrateur système de l’activer dans Paramètres de l’organisation → IA.
* Connecté à la mauvaise organisation ? - Déconnectez le connecteur Aphex dans les paramètres de Claude et reconnectez-vous ; il vous sera demandé de choisir à nouveau votre organisation.
* Impossible de trouver un projet auquel vous vous attendiez ? - Vérifiez que vous pouvez l’ouvrir dans Aphex avec le même compte que celui connecté. Le connecteur voit exactement ce que voit votre compte Aphex.

</details>

<details>

<summary><strong>ChatGPT</strong></summary>

* Ouvrez ChatGPT → <kbd>Paramètres</kbd>
* Allez dans <kbd>Sécurité et connexion</kbd> → activez <kbd>Mode développeur</kbd>
* Allez dans <kbd>Connecteurs</kbd> (toujours dans Paramètres)
* Cliquez sur le + pour créer un nouveau connecteur
* Entrez l’URL du serveur Aphex
* Définissez l’authentification sur <kbd>OAuth</kbd>
* Cliquez sur <kbd>Créer</kbd>
* Connectez-vous avec votre compte Aphex et choisissez votre organisation
* Dans une conversation, sélectionnez le menu des outils et activez <kbd>Aphex</kbd>

**Conseils de dépannage :**

* Le mode développeur n’est pas disponible - Vérifiez que vous êtes sur Plus, Pro, Business ou Éducation. Les administrateurs de formule de l’espace de travail devront peut-être l’activer séparément.
* « Aucun outil disponible » - Votre organisation n’a pas activé MCP. Demandez à votre administrateur système de vérifier Paramètres de l’organisation → IA.
* Connecté à la mauvaise organisation ? - Allez dans les connecteurs ChatGPT, déconnectez Aphex, puis reconnectez-vous pour en choisir une autre.

</details>

<details>

<summary><strong>Perplexity</strong></summary>

* Ouvrez Perplexity → <kbd>Paramètres</kbd>
* Sélectionnez <kbd>Connecteurs</kbd>
* Cliquez sur <kbd>+ Connecteur personnalisé</kbd>
* Choisir <kbd>Distant</kbd>
* Entrez le nom <kbd>Aphex</kbd> et collez l’URL du serveur
* Définissez l’authentification sur <kbd>OAuth</kbd>
* Définissez le transport sur <kbd>HTTP diffusable</kbd>
* Cliquez sur <kbd>Créer</kbd>
* Connectez-vous avec votre compte Aphex et choisissez votre organisation

**Conseils de dépannage :**

* **« Aucun outil disponible »** - Votre organisation n’a pas activé MCP. Demandez à votre administrateur système.
* **Vous n’arrivez pas à vous connecter ?** - Assurez-vous d’utiliser la bonne URL du serveur et de sélectionner **OAuth** comme méthode d’authentification.

</details>

<details>

<summary><strong>Microsoft 365 Copilot</strong></summary>

Aphex est disponible en tant qu’agent dans l’Agent Store Microsoft 365 - aucune URL de serveur ni connecteur personnalisé n’est nécessaire.

* Ouvrez Microsoft 365 Copilot (dans Teams, Office ou l’application Microsoft 365)
* Sélectionnez <kbd>Agents</kbd> ou <kbd>Autres agents</kbd> dans la barre latérale gauche
* Rechercher <kbd>Aphex</kbd> dans l’Agent Store et cliquez sur <kbd>Ajouter</kbd>
* Dans une conversation, tapez <kbd>@Aphex</kbd> suivi de votre question
* La première fois, il vous sera demandé de vous connecter - utilisez votre compte Aphex et choisissez votre organisation

**Conseils de dépannage :**

* Impossible de trouver Aphex dans l’Agent Store ? - Votre administrateur informatique devra peut-être autoriser l’application Aphex pour votre organisation : Centre d’administration Teams → Applications Teams → Gérer les applications → Aphex → Autoriser.
* Copilot répond sans consulter Aphex ? - Commencez votre message par @Aphex pour diriger la question vers l’agent.
* « Aucun outil disponible » ou pas de données - Votre organisation n’a pas activé MCP dans Aphex (demandez à votre administrateur système de vérifier Paramètres de l’organisation → IA), ou vous vous êtes connecté à la mauvaise organisation - déconnectez-vous de l’agent et reconnectez-vous pour en choisir une autre.

</details>

<details>

<summary><strong>Autres outils</strong></summary>

Tout outil d’IA qui prend en charge le protocole client MCP avec transport HTTP diffusable et OAuth 2.0 basé sur navigateur peut se connecter à l’aide de la même URL du serveur. Chaque utilisateur se connecte individuellement - il n’existe pas de méthode par clé API ou par compte de service pour MCP.

* Allez dans les <kbd>Paramètres</kbd> → <kbd>Connecteurs</kbd>
* Sélectionnez <kbd>Ajouter un connecteur personnalisé</kbd> ou <kbd>Ajouter MCP</kbd>
* Collez l’URL du serveur Aphex
* Définissez l’authentification sur <kbd>OAuth</kbd> et le transport sur <kbd>HTTP diffusable</kbd> (si des options sont disponibles)
* Suivez le flux de connexion, authentifiez-vous avec votre compte Aphex et choisissez votre organisation
* Une fois connecté, activez Aphex dans le menu des outils de votre application et commencez à poser des questions

</details>

### Changer d’organisation

***

Une seule connexion fonctionne avec une organisation à la fois. Vous choisissez votre organisation lors de la connexion.

<figure><img src="https://2817901885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FijOrQE6esre2T6KZkmlA%2FMCP%20Claude%20-%20org.svg?alt=media&amp;token=4f44321d-53b5-4180-b7ea-dd8cec21444e" alt=""><figcaption></figcaption></figure>

**Pour changer d’organisation :**

* Allez dans les paramètres du connecteur de votre outil d’IA
* Cliquez sur <kbd>Déconnecter</kbd> à côté d’Aphex
* Cliquez sur <kbd>Reconnecter</kbd>
* Reconnectez-vous et choisissez cette fois une autre organisation
* Vous êtes maintenant connecté à la nouvelle organisation

<details>

<summary>Travailler avec plusieurs organisations</summary>

Si vous devez travailler avec deux organisations en même temps, ajoutez deux fois le connecteur Aphex :

1. Ajoutez le connecteur une première fois et choisissez l’organisation A lors de la connexion
2. Ajoutez-le à nouveau et choisissez l’organisation B lors de la connexion

Chaque connexion sera distincte, et vous pourrez passer de l’une à l’autre dans les paramètres du connecteur de votre outil.

</details>

### Ce à quoi le connecteur peut accéder

***

Le connecteur peut accéder exactement à ce que vous voyez dans Aphex, et pas à plus. Le connecteur se connecte en tant que vous et respecte les mêmes autorisations que l’application. Si vous pouvez ouvrir un projet, consulter ses journaux ou voir son plan dans votre navigateur, votre IA peut les lire. Sinon, elle ne le peut pas.

<table><thead><tr><th width="300.515625">Si vous disposez de l’accès projet suivant..</th><th>Votre outil d’IA peut…</th></tr></thead><tbody><tr><td>Accès au planificateur</td><td>Trouver et lire des tâches, les comparer aux plans publiés, et voir comment elles ont changé et ce qu’elles impactent</td></tr><tr><td>Accès complet au journal</td><td>Lister, lire et rechercher ces journaux</td></tr><tr><td>Aucun accès au projet</td><td>Rien - il n’apparaîtra pas du tout</td></tr></tbody></table>

#### Outils disponibles

Votre outil d’IA choisit les bons outils pour votre question - vous n’avez pas besoin de les nommer.

<table><thead><tr><th width="244.984375">Outil</th><th>Ce que cela fait</th><th>Essayez de demander</th></tr></thead><tbody><tr><td><code>aphex_list_projects</code></td><td>Trouve les projets auxquels vous avez accès</td><td>« Lequel de mes projets ont des journaux ? »</td></tr><tr><td><code>aphex_get_project_context</code></td><td>Donne une vue d’ensemble d’un projet : zones, sous-traitants, lots et publications récentes</td><td>« Donnez-moi un aperçu de Riverside - ses zones, ses sous-traitants et ses publications récentes. »</td></tr><tr><td><code>aphex_list_diary_entries</code></td><td>Liste les entrées du journal par plage de dates ou par tâche</td><td>« Quels journaux ont été complétés sur Riverside la semaine dernière ? »</td></tr><tr><td><code>aphex_get_diary_entries</code></td><td>Lit le contenu complet du journal - retards, main-d’œuvre, matériel, notes et photos</td><td>« Lisez le journal de mercredi et résumez les retards avec les raisons données. »</td></tr><tr><td><code>aphex_find_tasks</code></td><td>Trouve des tâches par nom ou description, zone, sous-traitant ou date, et ce qui a bougé depuis une publication</td><td>« Quelles tâches de niveau 3 ont bougé depuis la publication de vendredi ? »</td></tr><tr><td><code>aphex_get_tasks</code></td><td>Affiche les tâches telles qu’elles sont maintenant, ou telles qu’elles étaient à une date ou une publication passée</td><td>« Montrez-moi les tâches de façade telles qu’elles étaient dans la publication du 1er septembre. »</td></tr><tr><td><code>aphex_get_task_history</code></td><td>Montre comment une tâche a changé et qui l’a modifiée</td><td>« Qui a déplacé les dates de coulage du niveau 4 la semaine dernière ? »</td></tr><tr><td><code>aphex_get_task_impact</code></td><td>Montre ce qu’une tâche impacte plus loin dans le plan, y compris les jalons</td><td>« Qu’est-ce que le coulage du niveau 4 impacte plus loin dans le plan ? Des jalons ? »</td></tr><tr><td><code>aphex_trace_delay_impact</code></td><td>Prend les retards consignés dans les journaux et montre ce qu’ils ont fait au plan</td><td>« Qu’ont fait les retards des journaux de la semaine dernière au programme ? »</td></tr></tbody></table>

Tous ces outils se contentent de lire vos enregistrements. Rien de ce que vous demandez ne peut créer, modifier ou supprimer quoi que ce soit dans votre plan ou votre journal. Nous enrichissons l’ensemble d’outils en fonction des retours, et cette page listera toujours ce qui est disponible.

### Confidentialité et sécurité des données

***

Lorsque vous utilisez le connecteur MCP, vos données Aphex sont envoyées à votre outil d’IA - le compte Claude, ChatGPT ou Copilot que vous avez connecté - et nulle part ailleurs. Aphex n’envoie pas vos données aux fournisseurs d’IA dans le cadre de MCP, et vos données ne sont jamais utilisées par Aphex pour entraîner des modèles d’IA.

#### Ce qui est intégré :

* **Le MCP est désactivé par défaut** - MCP n’est disponible que si la formule de votre organisation l’inclut, et si votre administrateur système l’a activé.
* **Vos autorisations, reproduites -** Chaque utilisateur se connecte individuellement et ne voit que ce qu’il voit déjà dans Aphex.
* **Les outils d’aujourd’hui lisent, n’écrivent pas** - L’ensemble d’outils actuel ne peut rien créer, modifier ou supprimer dans Aphex.
* **Votre compte, vos données** - Le compte de votre outil d’IA est distinct de votre compte Aphex. Vos adresses e-mail n’ont pas besoin de correspondre.

{% hint style="info" %}
Pour savoir comment fonctionnent les fonctionnalités d’IA dans Aphex (comme les résumés de journal et l’assistant IA), voir <a href="/docs/aphex-help-fr/politiques/comment-aphex-utilise-lia.md" class="button secondary">Comment Aphex utilise l’IA</a>
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.aphex.co/docs/aphex-help-fr/integrations-et-api/mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.