> 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/en/developpeur/se-connecter-a-yoplanning-via-mcp.md).

# Connect to Yoplanning via MCP

Yoplanning exposes an **MCP** server at `https://yoplanning.pro/mcp`. This article explains what MCP is, what it allows you to do with Yoplanning, and what you need to connect your AI assistant (Claude, or any other MCP-compatible client).

{% hint style="info" %}
Feature currently being rolled out. If you encounter any issues following this article, please contact <support@yoplanning.com>.
{% endhint %}

### What is the MCP?

The **MCP (Model Context Protocol)** is an open standard that allows an AI assistant to connect directly to a service to read its data and act on it — instead of having to describe everything to it by hand or copy-paste between Yoplanning and your assistant.

In practical terms, once your assistant is connected to Yoplanning's MCP server, you can ask it in natural language to consult or act on your team's data (for example, your schedule, your orders, your clients), without leaving the conversation.

### One important point: the MCP respects your rights.

The Yoplanning MCP does not grant new permissions: it is **constrained by the rights of the person whose token it is**. Your AI assistant will only be able to see and do, via the MCP, what you could see and do yourself by logging into Yoplanning with your account. If your role has restricted access to certain teams, data, or actions, this restriction also applies to the MCP.

### What you need to log in

Two pieces of information are needed to configure your assistant:

* your **Team ID**
* your **personal API token**

{% stepper %}
{% step %}

{% endstep %}

{% step %}

#### Open your advanced preferences

{% endstep %}

{% step %}
In Yoplanning, click on the gear icon in the top right corner, then go to **Settings**.
{% endstep %}

{% step %}

#### Show advanced preferences

In the settings, click on **Show advanced preferences**.
{% endstep %}

{% step %}

#### Copy your Team ID and API token

Both pieces of information are displayed here. Copy them: you will need them for the next step.

{% hint style="warning" %}
Your API token is personal and grants access to your Yoplanning account with your own permissions. Only share it with trusted tools, and never publish it (public code repository, unencrypted team messages, etc.).
{% endhint %}
{% endstep %}
{% endstepper %}

### Configure your AI assistant

The address of the Yoplanning MCP server is:

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

Most MCP clients (Claude Desktop, Claude Code, Claude's custom connectors, or any other compatible client) configure themselves using this URL and your credentials passed in HTTP headers. An example configuration:

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

Replace `YOUR_TOKEN_API` and `YOUR_TEAM_ID` with the values ​​retrieved in the previous step.

### To go further

MCP is one way to connect an external tool to Yoplanning. For more traditional developer integration (REST API, webhooks), see the [Developer](/en/developpeur.md) section and the article [Yoplanning Connectivity & Integrations](/en/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/en/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.