> 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/it/developpeur/se-connecter-a-yoplanning-via-mcp.md). # Connettiti a Yoplanning tramite MCP Yoplanning mette a disposizione un server **MCP** all'indirizzo `https://yoplanning.pro/mcp`. Questo articolo spiega cos'è MCP, cosa permette di fare con Yoplanning e cosa è necessario per connettere il proprio assistente IA (Claude o qualsiasi altro client compatibile con MCP). {% hint style="info" %} Funzionalità attualmente in fase di implementazione. In caso di problemi dopo aver letto questo articolo, si prega di contattare . {% endhint %} ### Cos'è l'MCP? Il **MCP (Model Context Protocol)** è uno standard aperto che consente a un assistente IA di connettersi direttamente a un servizio per leggerne i dati e agire di conseguenza, invece di dover descrivere tutto manualmente o copiare e incollare informazioni tra Yoplanning e l'assistente. In termini pratici, una volta che il tuo assistente è connesso al server MCP di Yoplanning, puoi chiedergli in linguaggio naturale di consultare o agire sui dati del tuo team (ad esempio, il tuo programma, i tuoi ordini, i tuoi clienti), senza interrompere la conversazione. ### Un punto importante: l'MCP rispetta i vostri diritti. Il pannello di controllo utente (MCP) di Yoplanning non concede nuove autorizzazioni: è **vincolato dai diritti della persona a cui appartiene il token**. Il tuo assistente AI potrà visualizzare e fare, tramite l'MCP, solo ciò che potresti visualizzare e fare tu stesso accedendo a Yoplanning con il tuo account. Se il tuo ruolo prevede un accesso limitato a determinati team, dati o azioni, tale limitazione si applica anche all'MCP. ### Cosa ti serve per accedere Per configurare il tuo assistente sono necessarie due informazioni: * il tuo **ID squadra** * il tuo **token API personale** #### Apri le tue preferenze avanzate In Yoplanning, fai clic sull'icona a forma di ingranaggio nell'angolo in alto a destra, quindi vai su **Impostazioni**. #### Mostra le preferenze avanzate Nelle impostazioni, fai clic su **Mostra preferenze avanzate**. #### Copia il tuo ID team e il token API Entrambe le informazioni sono visualizzate qui. Copiale: ti serviranno per il passaggio successivo. {% hint style="warning" %} Il tuo token API è personale e ti garantisce l'accesso al tuo account Yoplanning con le tue autorizzazioni. Condividilo solo con strumenti di fiducia e non pubblicarlo mai (repository di codice pubblico, messaggi di team non crittografati, ecc.). {% endhint %} ### Configura il tuo assistente IA L'indirizzo del server MCP di Yoplanning è: ``` https://yoplanning.pro/mcp ``` La maggior parte dei client MCP (Claude Desktop, Claude Code, i connettori personalizzati di Claude o qualsiasi altro client compatibile) si configurano utilizzando questo URL e le credenziali trasmesse nelle intestazioni HTTP. Ecco un esempio di configurazione: ```json { "mcpServers": { "yoplanning": { "url": "https://yoplanning.pro/mcp", "headers": { "Authorization": "Bearer VOTRE_TOKEN_API", "X-Team-Id": "VOTRE_TEAM_ID" } } } } ``` Sostituisci `YOUR_TOKEN_API` e `YOUR_TEAM_ID` con i valori recuperati nel passaggio precedente. ### Per andare oltre MCP è un modo per connettere uno strumento esterno a Yoplanning. Per integrazioni più tradizionali per sviluppatori (API REST, webhook), consultare la sezione [Sviluppatore](/it/developpeur.md) e l'articolo [Connettività e integrazioni di Yoplanning](/it/domande-frequenti/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/it/developpeur/se-connecter-a-yoplanning-via-mcp.md?ask=&goal= ``` `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.