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.
  • Seguro: cada chamada exige a sua Token de autenticação da Eduzz, garantindo que apenas você acesse seus dados.
  • Respostas em JSON: os resultados são retornados em formato estruturado, facilitando a interpretação pela IA.

Pré-requisitos

Antes de configurar o MCP, você precisa de duas coisas:

1. Criar um Aplicativo na Eduzz

Você precisa de um aplicativo registrado no Console Eduzz para obter suas credenciais de API.

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 os escopos que deseja utilizar

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

2. Gerar sua Token Pessoal

A Token Pessoal é o que autentica suas chamadas à API. Ela funciona como uma "senha" que identifica sua conta.

Passo a passo:

  1. Acesse a Listagem de Aplicativos
  2. Encontre seu aplicativo na lista
  3. Clique na ação "Copiar access token"
  4. Guarde essa token em um lugar seguro

Para mais detalhes, veja a documentação completa: Token Pessoal

Configuração

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-api": {
      "url": "https://developers.eduzz.com/api/mcp"
    }
  }
}

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

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

Configurando no Claude Desktop

O Claude Desktop é o aplicativo de desktop do Claude, assistente de IA da Anthropic. Para configurar:

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-api": {
      "type": "streamableHttp",
      "url": "https://developers.eduzz.com/api/mcp"
    }
  }
}

3. Reinicie o Claude Desktop.

4. 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 solicitar sua token para executar a chamada.

Informando a Token

Na primeira vez que você pedir algo à IA, ela vai solicitar sua Token de autenticação da Eduzz. Você pode:

  • Informar diretamente no chat: cole sua token quando solicitado
  • Incluir na mensagem: por exemplo, "Use a token abc123 para consultar minhas vendas recentes"

Dica: a token é enviada de forma segura diretamente para a API da Eduzz. Ela não é armazenada pelo servidor MCP.

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

A minha token fica armazenada no servidor MCP?

Não. A token é usada apenas durante a execução da chamada à API e não é armazenada em nenhum momento pelo servidor MCP. Ela é enviada diretamente da sua máquina para a API da Eduzz.

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 com um aplicativo criado e uma token válida. 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 do seu aplicativo autorizam. Endpoints de escrita (como criar ou atualizar recursos) só funcionam se o seu aplicativo tiver os escopos necessários configurados. Você tem controle total sobre o que é permitido.

O que acontece se minha token expirar ou for inválida?

A IA vai retornar uma mensagem de erro indicando que a autenticação falhou. Basta gerar uma nova token no Console Eduzz e informá-la novamente.

Mais informações