> 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ù le 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 vos données de projet directement depuis votre outil IA (Claude, ChatGPT, Perplexity, Copilot ou tout autre outil prenant en charge le MCP). Posez des questions sur vos journaux, vos tâches, ce qui a bougé et qui l'a déplacé, ainsi que sur la façon dont les choses se comparent à votre plan publié, et votre IA peut s'appuyer sur le journal et le plan ensemble pour répondre. Aphex fournit les données mot pour mot, et votre IA fait le raisonnement et 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 du MCP

***

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

#### Exemples de questions

<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 nous en sommes-nous sortis 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 [task] 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 de [subcontractor] sur [scope] 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 alertes précoces que nous devrions émettre ? »</td></tr><tr><td>Les deux</td><td>« Comment [subcontractor] se situe-t-il par rapport au plan ? »</td></tr><tr><td>Les deux</td><td>« Quel impact les retards consignés dans les journaux de la semaine dernière ont-ils eu sur le programme ? »</td></tr></tbody></table>

Votre IA lit les enregistrements, repère les tendances et rédige la réponse. Aphex fournit les données exactement telles qu'elles ont été enregistrées, avec l'identité de la personne qui les a saisies ou modifiées et à quel moment.

{% 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 %}

### Activation du 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">Prendre contact</a> avec notre équipe pour que la fonctionnalité soit activée.

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é, tous les utilisateurs de l'organisation peuvent connecter leur outil IA à Aphex.

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

### Vérification de l'activation du MCP

***

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 forfait :** Il vous sera demandé de nous contacter

## Connectez vos outils IA

***

Une fois le MCP activé pour l'organisation, tous les utilisateurs de l'organisation peuvent connecter leur outil 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 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 n'importe laquelle de vos organisations (vous aurez toujours accès aux projets dans toutes vos organisations où le MCP est activé)
* Cliquez sur <kbd>Autoriser</kbd> à accorder l'accès
* Retournez à Claude et commencez à poser des questions sur vos projets

**Conseils de dépannage :**

* « Aucun outil disponible » - Votre organisation n'a pas encore le MCP activé. Demandez à votre administrateur système de l'activer dans Paramètres de l'organisation → IA.
* Vous ne trouvez pas un projet auquel vous vous attendiez ? - Vérifiez que vous pouvez l'ouvrir dans Aphex avec le même compte que celui que vous avez connecté. Le connecteur voit exactement ce que voit votre compte Aphex.
* Vous ne voyez pas les projets d'une de vos organisations ? Vérifiez que le MCP a été activé pour cette organisation (Admin → IA). S'il est activé et que vous ne les voyez toujours pas, déconnectez puis reconnectez le connecteur Aphex.

</details>

<details>

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

* Ouvrez ChatGPT → <kbd>Paramètres</kbd>
* Accédez à <kbd>Sécurité et connexion</kbd> → activez <kbd>Mode développeur</kbd>
* Accédez à <kbd>Connecteurs</kbd> (toujours dans Paramètres)
* Cliquez sur le + pour créer un nouveau connecteur
* Saisissez 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 sélectionnez une organisation (vous aurez toujours accès aux projets de toutes vos organisations où le MCP est activé).
* Dans une conversation, sélectionnez le menu des outils et activez <kbd>Aphex</kbd>

**Conseils de dépannage :**

* Mode développeur non disponible - Vérifiez que vous êtes sur Plus, Pro, Business ou Edu. Les administrateurs du forfait Workspace devront peut-être l'activer séparément.
* « Aucun outil disponible » - Votre organisation n'a pas le MCP activé. Demandez à votre administrateur système de vérifier Paramètres de l'organisation → IA.

</details>

<details>

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

* Ouvrez Perplexity → <kbd>Paramètres</kbd>
* Sélectionnez <kbd>Connecteurs</kbd>
* Cliquez sur <kbd>+ Connecteur personnalisé</kbd>
* Choisissez <kbd>Distant</kbd>
* Saisissez 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 diffusible</kbd>
* Cliquez sur <kbd>Créer</kbd>
* Connectez-vous avec votre compte Aphex et choisissez n'importe laquelle de vos organisations (vous aurez toujours accès aux projets de toutes vos organisations où le MCP est activé)

**Conseils de dépannage :**

* **« Aucun outil disponible »** - Votre organisation n'a pas le MCP activé. Demandez à votre administrateur système.
* **Impossible de se 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 le Microsoft 365 Agent Store - 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>Plus d'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 sélectionnez une organisation (vous aurez toujours accès aux projets de toutes vos organisations où le MCP est activé).

**Conseils de dépannage :**

* Vous ne trouvez pas 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 vérifier Aphex ? - Commencez votre message par @Aphex pour diriger la question vers l'agent.
* « Aucun outil disponible » ou aucune donnée : votre organisation n'a pas le MCP activé dans Aphex. Demandez à votre administrateur système de vérifier Paramètres de l'organisation → IA.

</details>

<details>

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

Tout outil IA prenant en charge le protocole client MCP avec le transport HTTP diffusible et OAuth 2.0 basé sur le navigateur peut se connecter avec la même URL de serveur. Chaque utilisateur se connecte individuellement - il n'existe pas de méthode de clé API ou de compte de service pour le MCP.

* Accédez à <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 diffusible</kbd> (si des options sont disponibles)
* Suivez le flux de connexion, authentifiez-vous avec votre compte Aphex et sélectionnez une organisation (vous aurez toujours accès aux projets de toutes vos organisations où le MCP est activé).
* Une fois connecté, activez Aphex dans le menu des outils de votre outil et commencez à poser

</details>

#### Travailler entre plusieurs organisations

Si vous appartenez à plusieurs organisations Aphex, une seule connexion les couvre toutes. Vous n'avez pas besoin de changer d'organisation ni d'ajouter le connecteur plus d'une fois.

Votre outil IA peut accéder aux projets de chaque organisation où :

* Vous êtes membre de l'organisation, **et**
* Le MCP a été activé pour cette organisation par un administrateur système

Cela signifie que vous pouvez poser des questions qui s'appuient en même temps sur des projets de différentes organisations, par exemple :

* « Comparez les heures de travail de la semaine dernière sur tous mes projets. »
* « Résumez les retards enregistrés ce mois-ci sur tous les projets dont je fais partie. »

{% hint style="info" %}
**Astuce :** Si deux projets de différentes organisations ont des noms similaires, incluez le nom de l'organisation ou du projet dans votre question afin que votre IA choisisse le bon.
{% endhint %}

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

***

Le connecteur peut accéder exactement à ce que vous pouvez voir dans Aphex, et rien de 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 consulter son plan dans votre navigateur, votre IA peut les lire. Sinon, elle ne le peut pas.

Cela s'applique à chaque organisation dont vous êtes membre et où le MCP est activé. Votre IA voit les mêmes projets que vous verriez si vous ouvriez chaque organisation dans Aphex.

<table><thead><tr><th width="300.515625">Si vous avez l'accès projet suivant..</th><th>Votre outil IA peut…</th></tr></thead><tbody><tr><td>Accès au planificateur</td><td>Trouver et lire les 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 IA choisit les outils adaptés à votre question - vous n'avez pas besoin de les nommer.

<table><thead><tr><th width="244.984375">Outil</th><th>Ce qu'il 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>« Quels sont mes projets qui ont des journaux ? »</td></tr><tr><td><code>aphex_get_project_context</code></td><td>Donne un aperçu 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 de journal par plage de dates ou par tâche</td><td>« Quels journaux ont été complétés à 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 indiqué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 de 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 de 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 enregistrés dans les journaux et montre ce qu'ils ont fait au plan</td><td>« Quel impact les retards consignés dans les journaux de la semaine dernière ont-ils eu sur le 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 élargissons la gamme d'outils en fonction des retours, et cette page indiquera 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 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 du 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** - Le MCP n'est disponible que si le forfait de votre organisation l'inclut, et si votre administrateur système l'a activé.
* **Vos autorisations, reproduites à l'identique -** 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 ni créer, ni modifier, ni supprimer quoi que ce soit dans Aphex.
* **Votre compte, vos données** - Le compte de votre outil 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 IA dans Aphex (comme les résumés de journaux et l'assistant IA), consultez <a href="https://help.aphex.co/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.
