> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/developpeur/se-connecter-a-yoplanning-via-mcp.md).

# Se connecter à Yoplanning via MCP

Yoplanning expose un serveur **MCP** à l'adresse `https://yoplanning.pro/mcp`. Cet article explique ce qu'est le MCP, ce qu'il permet de faire avec Yoplanning, et ce qu'il vous faut pour connecter votre assistant IA (Claude, ou tout autre client compatible MCP).

{% hint style="info" %}
Fonctionnalité en cours de déploiement. Si vous rencontrez un blocage en suivant cet article, contactez <support@yoplanning.com>.
{% endhint %}

### Qu'est-ce que le MCP ?

Le **MCP (Model Context Protocol)** est un standard ouvert qui permet à un assistant IA de se connecter directement à un service pour lire ses données et agir dessus — au lieu de devoir tout lui décrire à la main ou faire des copier-coller entre Yoplanning et votre assistant.

Concrètement, une fois votre assistant connecté au serveur MCP de Yoplanning, vous pouvez lui demander en langage naturel de consulter ou d'agir sur les données de votre team (par exemple votre planning, vos commandes, vos clients), sans quitter la conversation.

### Un point important : le MCP respecte vos droits

Le MCP Yoplanning n'ouvre pas de nouvelles permissions : il est **contraint par les droits de la personne dont c'est le token**. Votre assistant IA ne pourra voir et faire, via le MCP, que ce que vous pourriez voir et faire vous-même en vous connectant à Yoplanning avec votre compte. Si votre rôle a un accès restreint à certaines teams, certaines données ou certaines actions, cette restriction s'applique aussi côté MCP.

### Ce qu'il vous faut pour vous connecter

Deux informations sont nécessaires pour configurer votre assistant :

* votre **Team ID**
* votre **token API personnel**

{% stepper %}
{% step %}

#### Ouvrez vos préférences avancées

Dans Yoplanning, cliquez sur la roue crantée en haut à droite, puis allez dans **Paramètres**.
{% endstep %}

{% step %}

#### Affichez les préférences avancées

Dans les paramètres, cliquez sur **Afficher les préférences avancées**.
{% endstep %}

{% step %}

#### Copiez votre Team ID et votre token API

Les deux informations sont affichées à cet endroit. Copiez-les : vous en aurez besoin pour l'étape suivante.

{% hint style="warning" %}
Votre token API est personnel et donne accès à votre compte Yoplanning avec vos propres droits. Ne le partagez qu'avec des outils de confiance, et ne le publiez jamais (dépôt de code public, message d'équipe non chiffré, etc.).
{% endhint %}
{% endstep %}
{% endstepper %}

### Configurer votre assistant IA

L'adresse du serveur MCP Yoplanning est :

```
https://yoplanning.pro/mcp
```

La plupart des clients MCP (Claude Desktop, Claude Code, les connecteurs personnalisés de Claude, ou tout autre client compatible) se configurent avec cette URL et vos identifiants passés en en-têtes HTTP. Un exemple de configuration :

```json
{
  "mcpServers": {
    "yoplanning": {
      "url": "https://yoplanning.pro/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_TOKEN_API",
        "X-Team-Id": "VOTRE_TEAM_ID"
      }
    }
  }
}
```

Remplacez `VOTRE_TOKEN_API` et `VOTRE_TEAM_ID` par les valeurs récupérées à l'étape précédente.

### Pour aller plus loin

Le MCP est une des façons de connecter un outil externe à Yoplanning. Pour une intégration développeur plus classique (API REST, webhooks), consultez la section [Développeur](/developpeur.md) et l'article [Connectivité & Intégrations de Yoplanning](/faq/faq-generale/connectivite-and-integrations-de-yoplanning.md).


---

# 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 dynamically by asking a question.

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

```
GET https://docs.yoplanning.support/developpeur/se-connecter-a-yoplanning-via-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.