Developer HubDeveloper Hub

MCP — Model Context Protocol

O que é o MCP?

O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA — como o Cursor e o Claude Desktop — se conectem a serviços externos de forma segura. Pense nele como um "tradutor" entre a IA e a API da Eduzz: você faz perguntas em linguagem natural e a IA executa as chamadas de API automaticamente.

Em termos simples: em vez de escrever código para consultar a API da Eduzz, você apenas conversa com a IA e ela faz o trabalho pesado por você.

O que o servidor MCP da Eduzz oferece?

O servidor MCP da Eduzz gera automaticamente uma ferramenta para cada endpoint ativo da nossa API pública. Isso significa que todas as operações disponíveis na API — como consultar vendas, listar produtos, gerenciar conteúdos e muito mais — ficam acessíveis diretamente pelo assistente de IA.

Principais características:

  • Cobertura completa: todos os endpoints ativos e em beta da API pública viram ferramentas disponíveis para a IA.
  • Sempre atualizado: quando novos endpoints são adicionados à documentação, eles ficam disponíveis automaticamente no MCP.
  • Autenticação segura com OAuth 2.0 + PKCE: você faz login diretamente na Eduzz pelo navegador, sem precisar copiar e colar tokens manualmente. O token de acesso é obtido e renovado automaticamente pelo seu assistente de IA.
  • Respostas em JSON: os resultados são retornados em formato estruturado, facilitando a interpretação pela IA.

Autenticação com OAuth 2.0 + PKCE

O servidor MCP da Eduzz usa OAuth 2.0 com PKCE (Proof Key for Code Exchange), o padrão recomendado para clientes públicos como aplicativos de desktop e ferramentas de IA.

Como funciona, na prática:

  1. Na primeira vez que você usar o MCP, seu assistente de IA abre uma janela do navegador com a tela de login da Eduzz.
  2. Você faz login e autoriza o acesso.
  3. O assistente recebe um token de acesso de forma segura e o utiliza nas chamadas à API.
  4. O token é renovado automaticamente quando expira — você não precisa fazer login de novo a cada uso.

Por que PKCE? O fluxo PKCE dispensa o uso de um client secret no seu dispositivo. Em vez disso, o cliente gera dinamicamente um code_verifier e um code_challenge a cada autenticação, protegendo o fluxo mesmo em ambientes onde não é possível guardar segredos com segurança.

Você não precisa mais copiar tokens manualmente. A autenticação acontece 100% pelo navegador.

Pré-requisitos

Para usar o MCP você só precisa de uma conta ativa na Eduzz. O login e a autorização são feitos pelo navegador no primeiro uso — não é necessário criar um aplicativo nem gerar uma token pessoal.

O client-id público usado na configuração já identifica o aplicativo oficial do MCP da Eduzz:

5236e8ee-6d48-4e0d-8cba-82a682bbd0f6

Esse client-id concede acesso a todos os endpoints da API pública da Eduzz — no login pelo navegador você autoriza o acesso completo.

Usando escopos mais restritos (client_id próprio)

Se você prefere limitar o acesso a apenas alguns escopos, pode registrar um aplicativo próprio no Console Eduzz e usar o client-id gerado no lugar do público.

Passo a passo:

  1. Acesse console.eduzz.com
  2. No menu principal, selecione Meus Aplicativos
  3. Clique em Novo Aplicativo
  4. Preencha os campos e selecione apenas os escopos que deseja liberar para o MCP
  5. Copie o Client ID gerado para o seu aplicativo
  6. Use esse client-id na configuração do MCP (no lugar de 5236e8ee-6d48-4e0d-8cba-82a682bbd0f6)

Com um client-id próprio, a IA só conseguirá executar as operações permitidas pelos escopos que você selecionou — ideal para restringir a apenas leitura, por exemplo.

Para mais detalhes, veja a documentação completa: Criando um Aplicativo

Configuração

O endereço do servidor MCP da Eduzz é:

https://mcp.eduzz.com/mcp

Configurando no Cursor

O Cursor é um editor de código com IA integrada. Para conectá-lo à API da Eduzz via MCP:

1. Na raiz do seu projeto (ou na configuração global do Cursor), crie o arquivo .cursor/mcp.json

2. Adicione o seguinte conteúdo:

{
  "mcpServers": {
    "eduzz": {
      "url": "https://mcp.eduzz.com/mcp",
      "auth": {
        "CLIENT_ID": "5236e8ee-6d48-4e0d-8cba-82a682bbd0f6"
      }
    }
  }
}

3. Reinicie o Cursor para que a configuração seja carregada.

4. Na primeira interação, o Cursor abrirá o navegador para você fazer login na Eduzz e autorizar o acesso.

5. Pronto! Agora o assistente do Cursor já consegue interagir com a API da Eduzz. Basta conversar com ele no chat.

Configurando no Claude

Você pode adicionar o servidor MCP da Eduzz ao Claude com um único comando via Claude CLI:

claude mcp add eduzz --transport http https://mcp.eduzz.com/mcp --client-id 5236e8ee-6d48-4e0d-8cba-82a682bbd0f6

Como alternativa, no Claude Desktop você pode editar o arquivo de configuração manualmente:

1. Abra o arquivo de configuração do Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Adicione a configuração do servidor MCP da Eduzz:

{
  "mcpServers": {
    "eduzz": {
      "type": "streamableHttp",
      "url": "https://mcp.eduzz.com/mcp",
      "auth": {
        "CLIENT_ID": "5236e8ee-6d48-4e0d-8cba-82a682bbd0f6"
      }
    }
  }
}

3. Reinicie o Claude Desktop.

4. Na primeira interação, o Claude abrirá o navegador para você fazer login na Eduzz e autorizar o acesso.

5. Pronto! Agora o Claude consegue acessar a API da Eduzz diretamente pelo chat.

Como usar

Após configurar o MCP no seu assistente de IA, basta enviar mensagens em linguagem natural. A IA vai identificar qual ferramenta (endpoint) usar e executar a chamada.

Login no primeiro uso

Na primeira vez que você pedir algo à IA, ela abrirá automaticamente o navegador com a tela de login da Eduzz:

  1. Faça login na sua conta Eduzz.
  2. Autorize o acesso do assistente de IA.
  3. Volte ao seu assistente — a partir daí as chamadas são executadas normalmente.

Dica: não é necessário copiar nem colar tokens. A autenticação é feita via OAuth 2.0 + PKCE pelo navegador, e o token é renovado automaticamente quando expira.

Exemplos de Perguntas

Aqui estão alguns exemplos do que você pode perguntar ao assistente:

Consultar vendas

"Quais foram minhas vendas de hoje?"

"Me mostre as últimas 10 vendas do meu produto X"

"Qual foi o faturamento total desta semana?"

Gerenciar produtos

"Liste todos os meus produtos ativos"

"Quais são os detalhes do produto com ID 12345?"

Consultar assinaturas

"Me mostre as assinaturas ativas"

"Quantas assinaturas foram canceladas este mês?"

Gerenciar webhooks

"Liste meus webhooks cadastrados"

"Quais eventos de webhook estão disponíveis?"

Casos de Uso

Para produtores de conteúdo digital

Acompanhamento de vendas em tempo real: Imagine que você acabou de lançar um curso e quer acompanhar as vendas sem ficar abrindo painéis. Basta perguntar à IA: "Quantas vendas do meu curso X tiveram hoje?" e ela retorna os dados atualizados.

Análise rápida de desempenho: Precisa preparar um relatório semanal? Peça à IA: "Resuma minhas vendas da última semana, agrupadas por produto" e use os dados como base.

Para desenvolvedores

Exploração da API sem esforço: Está desenvolvendo uma integração e quer entender o que um endpoint retorna? Em vez de montar a request manualmente, pergunte à IA: "Faça uma chamada GET para listar meus produtos e me mostre a estrutura da resposta". Isso é especialmente útil para explorar endpoints que você ainda não conhece.

Prototipagem rápida: Precisa testar um fluxo de integração? Use o MCP para fazer chamadas rápidas à API enquanto desenvolve, sem precisar sair do editor de código.

Debugging de integrações: Encontrou um problema na sua integração? Peça à IA: "Consulte a venda com ID 12345 para eu comparar com o que minha aplicação está retornando".

Para equipes de suporte e operações

Consultas rápidas a dados de clientes: Precisa verificar o status de uma venda ou assinatura para atender um cliente? Basta perguntar à IA e ter a resposta na hora.

Automação de tarefas repetitivas: Combine o MCP com o poder da IA para criar pequenos scripts e automações diretamente no Cursor. Por exemplo: "Para cada venda pendente, me gere um resumo com nome do comprador e valor".

Perguntas Frequentes

Como funciona a autenticação? Preciso copiar tokens?

Não. A autenticação usa OAuth 2.0 + PKCE. No primeiro uso, você faz login pelo navegador e autoriza o acesso. O token de acesso é obtido e renovado automaticamente pelo assistente de IA — nenhuma token precisa ser copiada ou colada manualmente.

Minhas credenciais ficam armazenadas no servidor MCP?

Não. Suas credenciais de login nunca passam pelo servidor MCP. O fluxo PKCE garante que apenas o seu assistente de IA receba o token de acesso, que é usado para as chamadas à API e mantido localmente no seu dispositivo.

Quais endpoints estão disponíveis?

Todos os endpoints ativos e em beta da API pública da Eduzz estão disponíveis como ferramentas no MCP. A lista é gerada automaticamente a partir da documentação.

Preciso pagar algo a mais para usar o MCP?

Não. O servidor MCP da Eduzz é gratuito. Você só precisa de uma conta na Eduzz. O uso do Cursor ou Claude Desktop pode ter seus próprios custos, conforme o plano de cada ferramenta.

A IA pode alterar dados da minha conta?

A IA só consegue executar as operações que os endpoints da API permitem e que os escopos autorizados no login concedem. Endpoints de escrita (como criar ou atualizar recursos) só funcionam se os escopos necessários tiverem sido autorizados. Você tem controle total sobre o que é permitido.

O que acontece se meu acesso expirar?

O token de acesso é renovado automaticamente. Caso a renovação falhe ou você revogue o acesso, o assistente abrirá o navegador novamente para um novo login.

Mais informações