> For the complete documentation index, see [llms.txt](https://help.maisfy.com.br/maisfy-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.maisfy.com.br/maisfy-help/ferramentas/mcp-ia.md).

# MCP (IA)

Menu lateral → **Ferramentas** → **MCP (IA)**.

O MCP deixa você **perguntar sobre suas vendas e comissões em linguagem natural** no Claude, no ChatGPT ou num agente próprio.

![Tela do MCP](https://3344509428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0KchSWN381W9S4GFEfY%2Fuploads%2Fi6DXngmCOINoBnLVDXSo%2Fft-mcp.jpg?alt=media)

{% hint style="info" %}
**O acesso é somente leitura.** Nenhuma ferramenta conectada consegue alterar dados ou movimentar dinheiro — ela só consulta.
{% endhint %}

## Como conectar

É a mesma URL em todas as ferramentas:

```
https://api-store.maisfy.com.br/mcp
```

Copie, cole na ferramenta e entre com a sua conta Maisfy. **Não precisa de token.**

### No Claude

1. Abra **Configurações → Conectores**
2. Clique em **Adicionar conector personalizado** e cole a URL
3. Salve e ative o conector numa conversa nova
4. Entre com a sua conta Maisfy e escolha o que ele pode ver

### No ChatGPT

1. Abra **Configurações → Aplicativos e conectores**
2. Crie um conector novo e cole a URL
3. Ative o conector na conversa
4. Entre com a sua conta Maisfy e escolha o que ele pode ver

{% hint style="info" %}
Essas telas mudam com frequência. Se algum passo estiver diferente, procure por **"conectores"** ou **"MCP"** nas configurações da ferramenta.
{% endhint %}

## As cinco permissões

Você escolhe o que a IA pode ver — no consentimento do Claude e do ChatGPT, e ao criar um token. São as mesmas cinco:

| Permissão                | O que ela entrega                                                                                              |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Produtos e ofertas**   | Seus produtos e os que você promove, com preços e ofertas                                                      |
| **Vendas e faturamento** | Quanto vendeu, por produto, por campanha e de onde veio cada venda                                             |
| **Ganhos e comissões**   | Quanto sobrou de fato — líquido, taxas e reembolsos — e o que você ganha como afiliado, coprodutor ou parceiro |
| **Afiliados**            | Quem vendeu para você e quanto custou em comissão                                                              |
| **Área de membros**      | Quantos alunos cada turma tem, quem começou, quem concluiu e onde cada um parou                                |

{% hint style="info" %}
**Marque o que a sua pergunta precisa.** Elas não se sobrepõem: quem liga só **Vendas e faturamento** e pergunta *"quanto lucrei?"* recebe uma recusa, porque valor líquido está em **Ganhos e comissões**. Quando falta permissão, a IA diz qual — pelo mesmo nome que está nesta tabela.
{% endhint %}

## ⚠️ Duas delas entregam nome de outras pessoas

**Afiliados** e **Área de membros** não devolvem só número seu: devolvem **nome de gente** — os seus afiliados e os seus alunos. Na tela elas aparecem marcadas com **nomes de pessoas**, exatamente por isso.

{% hint style="danger" %}
Esses nomes saem da Maisfy e são **lidos por uma inteligência artificial** na ferramenta onde você conectou. **Quem responde por esses dados é você.**

Antes de marcar, pense se a pergunta que você quer fazer precisa do nome. Muita coisa não precisa: *"quantos alunos concluíram?"* e *"quanto paguei de comissão?"* são número, não pessoa.
{% endhint %}

## Token para automações

Só para ferramentas que **não abrem navegador**, como n8n e scripts próprios. Para Claude e ChatGPT use o passo a passo acima — não crie token à toa.

Você dá um **nome** (que serve para você saber depois qual é qual), marca as **permissões** e clica em **Gerar token**.

{% hint style="warning" %}
**O token aparece uma única vez.** Depois disso a lista mostra só os primeiros caracteres dele — não dá para consultar de novo. Copie e guarde na hora, num lugar seguro; se perder, revogue e gere outro.
{% endhint %}

{% hint style="warning" %}
**Token criado pelo painel não expira.** Na lista, a coluna Expira mostra *"Não expira"*. Ele vale até você revogar — então trate como senha e revise a lista de vez em quando.
{% endhint %}

### Tokens ativos

A lista mostra, de cada token: **nome**, o **começo** do token, as **permissões**, a data de **criação**, quando **expira** e um botão de **Revogar**.

Revogar corta o acesso na hora. É o que fazer quando uma automação sai do ar, quando alguém que tinha o token deixa a equipe, ou quando você não lembra para que aquele token servia.

## Aplicativos autorizados

A tela lista o que você já autorizou pelo navegador, com a data. Vale revisar de vez em quando e remover o que não usa mais.

## O que dá para perguntar

Coisas como *"quanto vendi este mês?"*, *"quais são meus melhores afiliados?"* ou *"qual produto teve mais reembolso?"* — em português comum, sem precisar montar relatório.

Com a permissão de **Área de membros**, também dá para perguntar sobre o curso: *"quantos alunos concluíram a turma?"* ou *"em que aula a maioria parou?"*