> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.memberkit.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Como funciona o Servidor MCP da MemberKit
> O Servidor MCP da MemberKit conecta sua área de membros a assistentes de IA como ChatGPT, permitindo que você converse em linguagem natural com os dados da sua plataforma.
**Em vez de navegar por vários relatórios, você pergunta e a IA busca a resposta direto na sua área de membros.**
Neste guia você vai entender o que é o MCP, como ativá-lo e como começar a usá-lo.
## O que é o MCP?
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA utilizem ferramentas externas de forma segura e estruturada. Na prática, ele funciona como uma **camada de integração** entre a inteligência artificial e a sua área de membros na Memberkit.
Com o MCP conectado, o assistente de IA passa a ter acesso a um conjunto de ferramentas de relatórios e consultas da sua área de membros. Você faz uma pergunta em português, e a IA escolhe a ferramenta certa, busca os dados e responde.
> **Importante:** o MCP da Memberkit é **somente leitura**. Ele foi construído para consultar e analisar informações — nunca para alterar, excluir ou criar dados na sua área de membros. Seus alunos, cursos e configurações permanecem intactos.
## O que dá para fazer
O servidor expõe ferramentas prontas para responder perguntas sobre a saúde e o engajamento da sua área de membros. Com ele, você pode, por exemplo:
* **Ter um panorama geral da área de membros** — total de membros, novos cadastros, membros ativos e quem nunca acessou.
* **Acompanhar o engajamento ao longo do tempo** — aulas concluídas, comentários e avaliações por período.
* **Analisar cursos** — matrículas, progresso médio, taxa de conclusão, aulas com pior avaliação e tendência de NPS.
* **Gerar rankings** — por pontuação ou por engajamento (aulas concluídas por período).
* **Investigar um aluno específico** — perfil completo, acessos, progresso por curso, atividade e desempenho em quizzes.
* **Identificar alunos em risco de evasão** — membros ativos que estão há X dias sem acessar.
* **Encontrar membros com filtros flexíveis** — por status de matrícula, último acesso, certificados e mais.
* **Analisar quizzes** — quais perguntas mais confundem os alunos.
* **Comparar turmas** — distribuição de progresso, taxa de engajamento e nível de domínio entre coortes.
* **Acompanhar a comunidade** — posts e comentários do fórum ao longo do tempo.
> As respostas refletem exatamente os dados da **sua** área de membros — o token de acesso é individual e isolado por área de membros.
## Ferramentas compatíveis
O MCP da Memberkit funciona em **qualquer cliente compatível com o protocolo MCP**, entre eles:
* Claude Code
* Claude Desktop
* ChatGPT
* Grok
* Outros clientes que suportem MCP via HTTP
## Como ativar: obtendo sua URL de acesso
Toda a autenticação acontece por meio de uma **URL única**, que já vem com um token secreto embutido. Não é preciso configurar cabeçalhos nem senhas separadas — basta copiar a URL.
Para encontrá-la:
1. Acesse o painel administrativo da sua área de membros.
2. Vá em **Configurações → Acesso via API**.
3. No campo **Servidor MCP**, copie a URL completa exibida. Ela terá o formato:
```
https://memberkit.com.br/mcp?token=SEU_TOKEN_SECRETO
```
O endereço do servidor é sempre o mesmo (`memberkit.com.br/mcp`) — é o **token** que identifica a sua área de membros e dá acesso apenas aos seus dados.
**Proteja essa URL como se fosse uma senha.**\
Qualquer pessoa com essa URL consegue consultar os dados da sua área de membros. Não a compartilhe publicamente nem a coloque em repositórios de código.
## Como configurar no seu assistente de IA
A configuração muda ligeiramente de acordo com o cliente. Em todos os casos, use a URL completa (com o token) que você copiou no passo anterior.
### Claude Code
No terminal, execute:
```bash theme={null}
claude mcp add memberkit --transport http "https://memberkit.com.br/mcp?token=SEU_TOKEN_SECRETO"
```
### Claude Desktop / Cursor / Windsurf
Adicione o servidor ao arquivo de configuração MCP do cliente:
```json theme={null}
{
"mcpServers": {
"memberkit": {
"type": "http",
"url": "https://memberkit.com.br/mcp?token=SEU_TOKEN_SECRETO"
}
}
}
```
Depois de salvar, reinicie o cliente. A Memberkit deve aparecer na lista de servidores/ferramentas conectadas.
> **Detalhes técnicos:** o servidor utiliza transporte **HTTP streamable** (JSON-RPC 2.0) no endpoint `POST /mcp`. Não é necessário instalar nada localmente — a conexão é feita direto com a sua área de membros.
## Exemplos de perguntas
Depois de conectado, é só conversar naturalmente. Alguns exemplos:
* *"Me dê um panorama geral da minha área de membros esta semana."*
* *"Quais alunos estão há mais de 30 dias sem acessar?"*
* *"Mostre o ranking dos 10 alunos mais engajados no último trimestre."*
* *"Como está o curso de Storytelling? Matrículas, progresso médio e conclusão."*
* *"Quais perguntas do quiz de boas-vindas mais confundem os alunos?"*
* *"Faça um relatório completo do aluno [joao@email.com](mailto:joao@email.com)."*
* *"Compare o desempenho das minhas turmas por taxa de conclusão."*
* *"Como evoluiu a atividade da comunidade nos últimos 3 meses?"*
O assistente escolhe automaticamente a ferramenta certa e traz a resposta.
## Boas práticas
* **Conecte o MCP apenas a clientes de IA que você confia.** O token dá acesso de leitura a todos os dados da sua área de membros.
* **Nunca versione ou publique a URL do MCP** em repositórios, prints ou mensagens públicas.
* **Revise as informações antes de tomar decisões.** A IA é uma ferramenta de apoio à análise; confira os números quando forem críticos.
* **Se suspeitar que a URL vazou,** entre em contato com o suporte para rotacionar o token da sua área de membros.
## Perguntas frequentes
Não. A conexão é feita por HTTP diretamente com a sua área de membros; basta configurar a URL no seu cliente de IA.
Não. O servidor é somente leitura — todas as ferramentas apenas consultam informações.
O token é único **por área de membros**. Ele dá acesso aos dados daquela área, independentemente de qual administrador o gerou.
Não. O endereço é sempre `https://memberkit.com.br/mcp` — o que muda é o token, que identifica a sua área de membros. Por isso o token deve ser mantido em segredo.