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

# Conéctate a Yoplanning a través de MCP

Yoplanning ofrece un servidor **MCP** en `https://yoplanning.pro/mcp`. Este artículo explica qué es MCP, qué permite hacer con Yoplanning y qué necesitas para conectar tu asistente de IA (Claude o cualquier otro cliente compatible con MCP).

{% hint style="info" %}
Esta función se está implementando actualmente. Si encuentra algún problema después de leer este artículo, póngase en contacto con <support@yoplanning.com>.
{% endhint %}

### ¿Qué es el MCP?

El **MCP (Protocolo de Contexto del Modelo)** es un estándar abierto que permite que un asistente de IA se conecte directamente a un servicio para leer sus datos y actuar en consecuencia, en lugar de tener que describirle todo manualmente o copiar y pegar entre Yoplanning y su asistente.

En la práctica, una vez que tu asistente esté conectado al servidor MCP de Yoplanning, podrás pedirle en lenguaje natural que consulte o actúe sobre los datos de tu equipo (por ejemplo, tu agenda, tus pedidos, tus clientes), sin salir de la conversación.

### Un punto importante: el MCP respeta sus derechos.

El MCP de Yoplanning no otorga nuevos permisos: está **limitado por los derechos de la persona cuyo token es**. Tu asistente de IA solo podrá ver y hacer, a través del MCP, lo que tú podrías ver y hacer al iniciar sesión en Yoplanning con tu cuenta. Si tu rol tiene acceso restringido a ciertos equipos, datos o acciones, esta restricción también se aplica al MCP.

### Lo que necesitas para iniciar sesión

Se necesitan dos datos para configurar su asistente:

* Tu **ID de equipo**
* tu **token API personal**

#### Abra sus preferencias avanzadas

En Yoplanning, haz clic en el icono de engranaje en la esquina superior derecha y luego ve a **Configuración**.

#### Mostrar preferencias avanzadas

En la configuración, haga clic en **Mostrar preferencias avanzadas**.

#### Copia tu ID de equipo y tu token de API.

Ambas informaciones se muestran aquí. Cópielas: las necesitará para el siguiente paso.

{% hint style="warning" %}
Tu token de API es personal y te otorga acceso a tu cuenta de Yoplanning con tus propios permisos. Compártelo solo con herramientas de confianza y nunca lo publiques (repositorio de código público, mensajes de equipo sin cifrar, etc.).
{% endhint %}

### Configura tu asistente de IA

La dirección del servidor MCP de Yoplanning es:

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

La mayoría de los clientes MCP (Claude Desktop, Claude Code, los conectores personalizados de Claude o cualquier otro cliente compatible) se configuran utilizando esta URL y sus credenciales pasadas en los encabezados HTTP. Ejemplo de configuración:

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

Reemplace `YOUR_TOKEN_API` y `YOUR_TEAM_ID` con los valores recuperados en el paso anterior.

### Para ir más allá

MCP es una forma de conectar una herramienta externa a Yoplanning. Para una integración más tradicional para desarrolladores (API REST, webhooks), consulte la sección [Desarrollador](/es/developpeur.md) y el artículo [Conectividad e integraciones de Yoplanning](/es/preguntas-frecuentes/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/es/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.
