> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easyfy.click/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o MCP

> Ligue um assistente de IA à sua conta Easyfy para consultar promoções, gerar links e publicar em grupos WhatsApp e Telegram.

O **MCP** permite conectar um assistente de IA — como Claude, Cursor ou outro
compatível — à sua conta Easyfy. Pelo chat, você consulta promoções enviadas,
gera links de afiliado e publica em grupos **WhatsApp** e **Telegram** já
configurados no Easyfy.

> [!NOTE]
>
> Disponível nos planos **Pro** e **Elite** ativos. É preciso ser
> **proprietário** da empresa. Afiliados e grupos de destino devem estar
> configurados antes no Easyfy.

## Pré-requisitos

> [!TIP]
>
> Plano **Pro** ou **Elite** ativo.

> [!TIP]
>
> Ser **proprietário** da empresa no Easyfy.

> [!TIP]
>
> Ter credenciais de afiliado e grupos de destino configurados.

> [!TIP]
>
> Um assistente que aceite servidores MCP remotos com login pela conta Easyfy.

## Como conectar

**1. Abra as conexões MCP**

No Easyfy, vá em **Configurações → MCP** (`https://app.easyfy.click/settings/mcp`).

**2. Copie a URL do servidor**

Use `https://app.easyfy.click/mcp`.

Se você já tinha conectado com a URL antiga (`/api/mcp`), autorize de novo com a URL nova.

**3. Adicione o servidor no assistente**

No Claude, Cursor ou outro cliente, adicione um servidor MCP remoto e cole
a URL acima. Quando pedir login, escolha a opção de autorizar com a conta
Easyfy.

**4. Autorize no Easyfy**

Entre na conta, confira o nome do app que está pedindo acesso, escolha a
empresa e autorize.

> [!TIP]
>
> A conexão vale por até **30 dias**. Depois disso, ou se você revogar o
> acesso, é só autorizar de novo.

## O que o assistente consegue fazer

| Pedido | O que acontece |
| - | - |
| Listar promoções | Mostra o histórico enviado, com filtros de período e busca |
| Preparar promoção | Monta um rascunho e já sugere os grupos ativos do seu padrão de envio |
| Gerar links | Converte até 30 URLs com as suas credenciais de afiliado |
| Listar grupos | Mostra grupos e canais ativos de destino |
| Enviar mensagem | Publica texto e, se quiser, uma imagem nos grupos que você escolher |
| Status do envio | Diz como foi a publicação em cada grupo |
| Analytics | Consulta cliques, produtos em alta e melhores horários |

Exemplos:

* “Consulte as promoções enviadas no WhatsApp ontem.”
* “Gere meu link de afiliado para este produto.”
* “Prepare uma promoção deste produto para eu revisar antes de publicar.”
* “Liste meus grupos do Telegram e publique esta promoção no grupo Achadinhos.”
* “Quais grupos receberam este envio?”

## Preparar antes de publicar

Peça ao assistente para **preparar** a promoção a partir de uma URL. Ele
monta um rascunho com texto, link de afiliado, dados do produto e a lista dos
**grupos e canais ativos** e o **template de mensagem** do Easyfy — **sem
enviar** a mensagem.

Revise o rascunho, confira os grupos sugeridos e confirme o envio. Título e
preço vêm do que a loja informou; se faltar alguma informação, o assistente
avisa em vez de inventar. Links gerados por aqui aparecem no histórico com
origem **MCP**.

> [!WARNING]
>
> A foto de prévia do produto **não** vai junto no envio. Para publicar com
> imagem, use uma imagem que já esteja salva no Easyfy.

## O que ainda não dá pra fazer

Nesta versão, o MCP **não**:

* cria grupos
* conecta WhatsApp ou Telegram por você
* agenda mensagens para depois

O texto pode ter até **4.000** caracteres, e cada envio pode ir para até
**100** destinos.

## Acompanhar o envio (e evitar duplicar)

Depois de pedir a publicação, pergunte o **status do envio**. O assistente
mostra se ainda está andando, se terminou, se falhou ou se ficou incerto —
e o resultado **em cada grupo**.

Se a resposta demorar ou parecer que “travou”, **não peça de novo na hora**.
Pergunte o status primeiro. Pedir outra vez a mesma publicação pode mandar
**duas vezes** para o mesmo grupo.

Se só alguns grupos receberam, confira o histórico no Easyfy antes de pedir
um novo envio para os que faltaram.

## Desconectar

Em **MCP**, revogue o acesso. Envios que ainda não começaram param.
Uma mensagem **já sendo enviada** não dá para cancelar no meio.

Se você mudar para Free, a assinatura ficar inativa ou você deixar de ser
proprietário da empresa, o assistente para de conseguir usar o MCP.

## Problemas comuns

> [accordion] O assistente pede login e a tela do Easyfy não abre
>
> Confira se a URL colada é exatamente `https://app.easyfy.click/mcp` e
> se o app que você está usando aceita servidores MCP remotos com login.

> [accordion] Autorizei, mas o assistente não consegue usar
>
> Verifique se o plano Pro/Elite está ativo, se você é proprietário da
> empresa e se afiliados e grupos de destino estão configurados.

> [accordion] Aparece como concluído, mas um grupo não recebeu
>
> “Concluído” quer dizer que o Easyfy terminou de tentar o envio — não que
> todos os grupos aceitaram. Peça o status por grupo e confira o histórico
> de promoções antes de republicar.

> [accordion] Posso mandar a mesma promoção de novo?
>
> Sim, depois de conferir quais grupos já receberam. Evite pedir o mesmo
> envio em seguida sem olhar o status — isso pode duplicar a mensagem.

## Recursos úteis

> [card] [Conexões MCP](https://app.easyfy.click/settings/mcp)
>
> Copiar a URL do servidor e gerenciar autorizações

> [card] [Integrações](https://app.easyfy.click/integracoes)
>
> Ver o cartão MCP junto das outras conexões


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.