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

# Conecte-se ao Yoplanning via MCP

O Yoplanning disponibiliza um servidor **MCP** em `https://yoplanning.pro/mcp`. Este artigo explica o que é o MCP, o que ele permite fazer com o Yoplanning e o que você precisa para conectar seu assistente de IA (Claude ou qualquer outro cliente compatível com MCP).

{% hint style="info" %}
Recurso em fase de implementação. Caso encontre algum problema após a leitura deste artigo, entre em contato com <support@yoplanning.com>.
{% endhint %}

### O que é o MCP?

O **MCP (Model Context Protocol)** é um padrão aberto que permite que um assistente de IA se conecte diretamente a um serviço para ler seus dados e agir de acordo com eles — em vez de ter que descrever tudo manualmente ou copiar e colar informações entre o Yoplanning e o seu assistente.

Na prática, assim que seu assistente estiver conectado ao servidor MCP do Yoplanning, você poderá pedir a ele, em linguagem natural, que consulte ou execute ações com base nos dados da sua equipe (por exemplo, sua agenda, seus pedidos, seus clientes), sem sair da conversa.

### Um ponto importante: o MCP respeita os seus direitos.

O MCP do Yoplanning não concede novas permissões: ele é **limitado pelos direitos da pessoa a quem pertence**. Seu assistente de IA só poderá ver e fazer, por meio do MCP, o que você mesmo poderia ver e fazer ao acessar o Yoplanning com sua conta. Se sua função restringir o acesso a determinadas equipes, dados ou ações, essa restrição também se aplica ao MCP.

### O que você precisa para fazer login

São necessárias duas informações para configurar seu assistente:

* Seu **ID da Equipe**
* Seu **token de API pessoal**

{% stepper %}
{% step %}

#### Abra suas preferências avançadas.

No Yoplanning, clique no ícone de engrenagem no canto superior direito e, em seguida, acesse **Configurações**.

#### Mostrar preferências avançadas

Nas configurações, clique em **Mostrar preferências avançadas**.

#### Copie o ID da sua equipe e o token da API.

Ambas as informações estão exibidas aqui. Copie-as: você precisará delas para a próxima etapa.

{% hint style="warning" %}
Seu token de API é pessoal e concede acesso à sua conta Yoplanning com suas próprias permissões. Compartilhe-o apenas com ferramentas confiáveis ​​e nunca o publique (repositório de código público, mensagens de equipe não criptografadas etc.).
{% endhint %}
{% endstep %}
{% endstepper %}

### Configure seu assistente de IA

O endereço do servidor MCP da Yoplanning é:

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

A maioria dos clientes MCP (Claude Desktop, Claude Code, conectores personalizados do Claude ou qualquer outro cliente compatível) se configuram usando este URL e suas credenciais passadas nos cabeçalhos HTTP. Um exemplo de configuração:

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

Substitua `YOUR_TOKEN_API` e `YOUR_TEAM_ID` pelos valores obtidos na etapa anterior.

### Para ir mais longe

O MCP é uma forma de conectar uma ferramenta externa ao Yoplanning. Para integração de desenvolvedor mais tradicional (API REST, webhooks), consulte a seção [Desenvolvedor](https://docs.yoplanning.support/pt/developpeur.md) e o artigo [Conectividade e integrações do Yoplanning](https://docs.yoplanning.support/pt/perguntas-frequentes/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.yoplanning.support/pt/developpeur/se-connecter-a-yoplanning-via-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.
