EduBase MCP Server

Servidor MCP EduBase

Este repositório contém a implementação do Model Context Protocol (MCP) servidor para a plataforma EduBase. Ele permite que clientes MCP (por exemplo, Claude Desktop) e LLMs interajam com sua conta EduBase e realizem tarefas em seu nome. Suporta os protocolos de transporte stdio, SSE e HTTP transmissível.

O que é EduBase?

EduBase é uma plataforma educacional online inovadora, modular, que torna o aprendizado mais agradável, simples e interativo, adequada para instituições de ensino ou empresas.

Por que escolher EduBase?

EduBase revoluciona o aprendizado digital com sua combinação única de recursos:

• Sistema Avançado de Questionários com parametrização permitindo infinitas variações da mesma pergunta, detecção de trapaça em tempo real, bela tipografia LaTeX, suporte avançado a STEM e correção automática
• Ambiente de Aprendizado Unificado que centraliza todo o seu conteúdo educacional — vídeos, exames, documentos e módulos SCORM — em um sistema intuitivo
• Segurança de Nível Empresarial com recursos como integração SSO, controles de acesso granulares, auditoria abrangente e conformidade com GDPR
• Integração com seus sistemas existentes através de LTI, API abrangente e opções de integração personalizadas
• Ferramentas Assistidas por IA, como o Assistente EduBase, que podem transformar instantaneamente seu conteúdo existente em questionários e avaliações interativas, ou traduzir seus materiais de um idioma para outro

De instituições de ensino superior a departamentos de treinamento corporativo, EduBase escala para atender às suas necessidades específicas, mantendo uma experiência de usuário intuitiva em todos os dispositivos.

Vídeo de demonstração

Criação e upload colaborativo de perguntas, agendamento de exames e análise de resultados de usuários com Claude:

Obtendo suas credenciais de API

Uma vez logado, no seu Painel, procure o menu Integrações, clique em "adicionar integração" e escolha o tipo "EduBase API".

Se você não vir esta opção, insira o código de ativação MCPGITHUB ou sinta-se à vontade para nos contatar para solicitar acesso em [email protected].

Ferramentas

Cada endpoint de API documentado está disponível como uma ferramenta separada, nomeada edubase_<method>_<endpoint>. Por exemplo, a ferramenta para o endpoint GET /user:me é nomeada edubase_get_user_me. Veja nossa documentação do desenvolvedor para mais informações.

Configuração

O servidor MCP pode ser configurado usando variáveis de ambiente. As seguintes variáveis estão disponíveis:

Variável	Descrição	Obrigatória	Valor padrão
EDUBASE_API_URL	A URL base da API EduBase, provavelmente https://subdomain.edubase.net/api.	Sim	https://www.edubase.net/api
EDUBASE_API_APP	O App ID do seu aplicativo de integração no EduBase, o app na API EduBase. Encontre isso na janela de detalhes da integração no EduBase.	Não se o transporte HTTP for usado com autenticação, caso contrário Sim	-
EDUBASE_API_KEY	A Chave Secreta do seu aplicativo de integração no EduBase, o secret na API EduBase. Encontre isso junto com o App ID na janela de detalhes da integração no EduBase.	Não se o transporte HTTP for usado com autenticação, caso contrário Sim	-
EDUBASE_SSE_MODE	Iniciar servidor MCP em modo HTTP com transporte SSE. O valor deve ser true.	Não	false
EDUBASE_STREAMABLE_HTTP_MODE	Iniciar servidor MCP em modo HTTP com transporte HTTP transmissível. O valor deve ser true.	Não	false
EDUBASE_HTTP_PORT	O servidor HTTP escutará nesta porta se o modo de transporte SSE ou HTTP transmissível for usado.	Não	3000
EDUBASE_OAUTH	Habilita o comportamento de recurso protegido OAuth 2.1: requisições não autenticadas são rejeitadas com 401 + WWW-Authenticate apontando para /.well-known/oauth-protected-resource, e tokens bearer são encaminhados para a API EduBase.	Não	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	URL base pública da implantação EduBase atuando como o IdP OAuth. Usada para anunciar o servidor de autorização no documento de metadados do recurso protegido.	Não	derivada de EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	URL base pública deste servidor MCP (o indicador de recurso OAuth). Usada no cabeçalho WWW-Authenticate e metadados do recurso.	Não	derivada de EDUBASE_API_URL

Uso como um servidor MCP remoto

Você pode usar o servidor MCP EduBase como um servidor MCP remoto para seu cliente MCP. Para fazer isso, você precisa hospedar o servidor MCP onde os clientes possam acessá-lo e, em seguida, configurar o cliente para se conectar ao servidor. Inicie-o com o modo de transporte SSE ou HTTP transmissível e sempre use HTTPS ao acessar o servidor remotamente pela internet!

Autenticação com servidores remotos

Você pode usar o servidor em dois modos:

• Sem autenticação do cliente: Neste modo, o servidor não exigirá nenhuma autenticação do cliente. Isso é útil para fins de teste ou desenvolvimento, ou em uma rede fechada, mas não é recomendado para uso em produção. Para isso, você também precisa configurar o servidor com o EDUBASE_API_APP e EDUBASE_API_KEY!
• Com autenticação Bearer token: Neste modo, o servidor exigirá que um token Bearer seja enviado com cada requisição. Esta é a maneira recomendada de usar o servidor em produção. Você pode obter o token Bearer da sua conta EduBase criando um aplicativo de integração e fornecendo o App ID e a Chave Secreta no formato {app}:{secret}, codificado em base64 como um token. O servidor então usará este token para autenticar o cliente e autorizar o acesso aos endpoints da API.
• Com OAuth 2.1 (EduBase como IdP): Quando EDUBASE_OAUTH=true, clientes compatíveis (Claude Desktop, conectores Claude.ai, Cursor, conectores ChatGPT, etc.) descobrem o servidor de autorização EduBase através de /.well-known/oauth-protected-resource, registram-se dinamicamente (RFC 7591), guiam o usuário por uma tela de consentimento EduBase e trocam um código de autorização (com PKCE S256) por um token de acesso opaco. O servidor MCP encaminha esse token literalmente para a API EduBase, que o resolve para a integração MCP provisionada automaticamente, criada no primeiro consentimento. Sem App ID/Secret para copiar — os usuários apenas clicam em "Conectar EduBase" em seu cliente.

Uso com Claude Desktop

Para um passo a passo, veja nossa postagem no blog sobre como conectar EduBase com Claude: O Guia Completo de Integração MCP.

Usando o servidor MCP EduBase fornecido

Você pode usar o servidor MCP EduBase fornecido (se disponível) sem nenhuma configuração, apenas adicionando-o como um servidor remoto em seu cliente com a URL https://domain.edubase.net/mcp (substitua pelo domínio real), se ele suportar autenticação OAuth, ou com o token Bearer apropriado no cabeçalho Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Recomendado para usuários do www.edubase.net, pois o servidor é mantido e atualizado por nós, e você não precisa se preocupar em hospedá-lo ou configurá-lo. Apenas certifique-se de usar a URL e o método de autenticação corretos ao conectar seu cliente.

Instalando manualmente

Adicione o seguinte ao seu claude_desktop_config.json:

Usando Node.js

Antes de executar o servidor MCP, certifique-se de ter o Node.js instalado. Você pode baixá-lo em nodejs.org ou usar um gerenciador de pacotes como brew.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "-y",
        "@edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Ou baixe a versão do servidor MCP EduBase ou clone o repositório e execute npm run build para construir o servidor. Não se esqueça de ajustar /path/to/dist para o diretório real e configurar as variáveis de ambiente!

{
  "mcpServers": {
    "edubase": {
      "command": "node",
      "args": [
        "/path/to/dist/index.js"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Usando Docker

Antes de executar o servidor MCP, certifique-se de ter o Docker instalado e em execução. Você pode baixá-lo em docker.com ou usar um gerenciador de pacotes. Não se esqueça de configurar as variáveis de ambiente!

{
  "mcpServers": {
    "edubase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EDUBASE_API_URL",
        "-e",
        "EDUBASE_API_APP",
        "-e",
        "EDUBASE_API_KEY",
        "edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Instalando via servidor MCP remoto

Você pode usar o servidor MCP EduBase fornecido (se disponível) como um servidor remoto. Recomendamos codificar em Base64 seu EDUBASE_API_APP e EDUBASE_API_KEY e usá-lo como um token Bearer no cabeçalho Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

Instalando via Smithery

Para instalar o servidor MCP EduBase para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @EduBase/MCP --client claude

Contato

Website: www.edubase.net
Documentação do Desenvolvedor: developer.edubase.net
Email: [email protected]