arrow_back Voltar para o início

Integração com IA

Conecte o Minha Prova ao Claude, ChatGPT e outros assistentes.

Minha Prova + Inteligência Artificial

Última atualização: 17 de maio de 2026

O Minha Prova oferece um conector oficial baseado no Model Context Protocol (MCP) que permite que assistentes de IA — como o Claude da Anthropic, o ChatGPT da OpenAI e o Gemini do Google — trabalhem diretamente com a sua conta do Minha Prova. Você pode pedir ao assistente para gerar uma prova, importar uma turma, analisar o desempenho de uma avaliação ou imprimir cartões-resposta sem sair do chat.

Este documento explica em linhas gerais o que o conector faz, como conectá-lo, quais ferramentas estão disponíveis e como suas informações são tratadas. Para detalhes específicos sobre privacidade e proteção de dados, consulte a Política de Privacidade, em especial a Seção 6 ("Integrações com assistentes de IA").

1. O que é o conector

O conector é um servidor MCP remoto, hospedado pela Minha Prova, que expõe um conjunto de ferramentas seguras (criar questão, listar provas, gerar PDF de preview, montar cartão-resposta, consultar resultados, etc.) para que o assistente de IA da sua escolha possa executar essas ações em seu nome — sempre vinculado à sua conta, sempre com sua autorização explícita e sempre com permissão revogável.

A autenticação é feita via OAuth 2.1 com PKCE: você autoriza uma única vez no navegador, recebe um token vinculado ao seu usuário do Minha Prova e o assistente passa a poder agir somente dentro do que esse token permite (suas próprias provas, suas próprias turmas, seus próprios alunos). O conector não tem acesso a dados de outros professores ou outras instituições.

2. Como conectar (passo a passo)

2.1 No Claude.ai

  1. Acesse claude.ai/settings/connectors e clique em Add custom connector.
  2. Em Server URL, informe: https://mcp.minhaprova.com.br.
  3. O Claude redireciona para a tela de login do Minha Prova. Use suas credenciais habituais.
  4. Confirme que você quer autorizar o conector. A tela resume os escopos pedidos.
  5. Pronto. O conector aparece como Minha Prova na barra lateral do Claude e já está utilizável em qualquer chat.

2.2 No ChatGPT (OpenAI)

O suporte oficial do ChatGPT a servidores MCP remotos ainda está em rollout gradual. Quando a opção Custom MCP server aparecer nas suas preferências, use a mesma URL https://mcp.minhaprova.com.br — o fluxo de login é idêntico ao do Claude. Caso a opção ainda não esteja disponível na sua conta, fale com a gente em suporte@minhaprova.com.br que indicamos uma alternativa.

2.3 No Gemini, Cursor, Cline e outros clientes MCP

Qualquer cliente compatível com a especificação MCP (transporte Streamable HTTP) consegue se conectar usando a mesma URL e o mesmo fluxo OAuth descritos acima. Em clientes de linha de comando, basta adicionar https://mcp.minhaprova.com.br à sua configuração de servidores MCP.

3. O que você pode fazer pelo chat

As ferramentas do conector cobrem o ciclo completo de criação, aplicação e análise de provas. Algumas das ações mais comuns:

Banco de questões

  • Buscar e listar questões do seu banco por disciplina, assunto, dificuldade ou texto livre.
  • Criar novas questões com enunciado, alternativas, resposta correta, explicação, tabelas e fórmulas matemáticas (MathML).
  • Editar questões existentes (enunciado, alternativas, gabarito, dificuldade, taxonomia).
  • Cadastrar disciplinas e assuntos que ainda não existem na sua conta — de forma idempotente: se já existir, reutiliza.

Provas

  • Listar suas provas e ver detalhes (estrutura, número de alternativas, template de PDF, configurações de correção).
  • Criar novas provas, anexar questões em lote, atualizar configurações pedagógicas (peso por disciplina, método de correção, TRI etc.) e mudar o template de diagramação.
  • Gerar o PDF de preview da prova e baixar o link pronto para imprimir.

Turmas, alunos e aplicação

  • Listar suas turmas, listar alunos de uma turma e buscar alunos por nome.
  • Cadastrar alunos individualmente ou em lote (cole uma lista CSV no chat).
  • Aplicar uma prova a uma turma e gerar o cartão-resposta (PDF com QR Code para leitura óptica) personalizado por aluno.

Resultados e relatórios

  • Listar resultados por aluno e exportar o gabarito oficial.
  • Pedir ao assistente um resumo do dashboard ou os gráficos analíticos de uma prova específica (distribuição de notas, dificuldade por questão, alunos que mais erraram, etc.).

Geração de imagens pedagógicas

  • Quando uma questão precisa de uma figura (geometria, diagrama de biologia, gráfico, mapa), o assistente pode oferecer o uso da geração interna de imagens. A imagem é gerada pela API do Gemini, hospedada no Cloud Storage da Minha Prova e embutida na questão.
  • Esse fluxo consome créditos de IA. Antes de gerar, o assistente sempre pergunta se você prefere usar créditos ou anexar a imagem manualmente no editor de questões.
  • Você consulta o saldo a qualquer momento pedindo algo como "quanto tenho de crédito?" — o conector retorna o saldo via a ferramenta whoami.

4. Privacidade, segurança e limites

  • Escopo da conexão. O assistente acessa exclusivamente os dados da sua conta. Não compartilhamos dados de outros professores nem de outras instituições.
  • Conteúdo enviado ao assistente. Quando você pede para o assistente trabalhar com uma questão, prova, turma ou resultado, o conteúdo dessas entidades passa pelo servidor do provedor de IA escolhido (Anthropic, OpenAI, Google) — exatamente como em qualquer outra conversa que você teria com esse assistente. Detalhes em Política de Privacidade, Seção 6.
  • Tokens. Os tokens OAuth são armazenados na sua sessão do assistente (Claude, ChatGPT, etc.). Você pode revogar a conexão a qualquer momento nas preferências do assistente; na revogação, o token perde a validade no servidor da Minha Prova imediatamente.
  • Geração de imagens. Quando você opta por gerar uma imagem com créditos de IA, o prompt de geração é enviado à Gemini API pela infraestrutura da Minha Prova. A imagem resultante é hospedada em storage.googleapis.com/minhaprova-questions-images/ com URLs não-listáveis e fica vinculada à sua conta.
  • Conteúdo proibido. O conector bloqueia automaticamente data URIs em base64 no <img src>, URLs de hosts externos (DALL-E CDN, imgur, Drive etc.) e elementos <svg> inline, por motivos de segurança e de longevidade do conteúdo gerado.
  • Operações destrutivas. Toda ação que modifica dados (criar questão, atualizar prova, gerar PDF, etc.) é marcada como destructive no protocolo MCP, o que faz o assistente exibir uma confirmação por chamada antes de executar.

5. Suporte e contato

6. Perguntas frequentes

Preciso de uma assinatura para usar o conector?

Você precisa ter uma conta ativa do Minha Prova (professor independente ou usuário de instituição). O conector em si não tem custo extra. O que tem custo são as gerações de imagem com IA, descontadas do saldo de créditos da sua conta — e somente quando você opta por usá-las. Tudo o mais (criar questão, gerar PDF, listar turmas, etc.) usa o seu plano normal, igual ao app web.

O assistente vai ler o conteúdo das minhas provas?

Apenas quando você pede. O conector não envia nada de forma proativa: cada chamada é resposta a uma pergunta ou ordem sua dentro do chat. O conteúdo retornado pelas ferramentas (questões, alternativas, resultados) passa pelo provedor do assistente como qualquer outra mensagem que você teria escrito manualmente.

O conector pode apagar meus dados?

Apenas algumas ferramentas modificam dados (por exemplo, update_question, update_exam). O conector não expõe nenhuma operação de exclusão em massa, e toda operação destrutiva exige confirmação no chat antes de ser executada.

Como removo o conector?

Em Claude.ai: Settings → Connectors → Minha Prova → Remove. Em ChatGPT e outros clientes: o caminho equivalente nas preferências do assistente. Após a remoção, o token associado é invalidado no servidor da Minha Prova; nenhuma chamada futura terá efeito.

O conector funciona em português E inglês?

Sim. Você pode interagir com o assistente em qualquer idioma. Os retornos das ferramentas são neutros em relação ao idioma — o conteúdo das suas questões e provas é devolvido tal como armazenado.

7. Para desenvolvedores e revisores

Esta seção resume informações técnicas para integradores e para o processo de revisão da Anthropic Connectors Directory.

  • Endpoint MCP: https://mcp.minhaprova.com.br (também em /mcp) — transporte Streamable HTTP, modo stateless.
  • Autenticação: OAuth 2.1 com PKCE + Dynamic Client Registration (RFC 7591). Metadados em https://mcp.minhaprova.com.br/.well-known/oauth-authorization-server.
  • Anotações de ferramentas: todas as ferramentas declaram title e o readOnlyHint / destructiveHint aplicável; ferramentas idempotentes carregam idempotentHint e ferramentas que tocam serviços externos openWorldHint.
  • Origin validation: a camada de transporte valida o cabeçalho Origin contra a lista de clientes MCP autorizados.
  • Política de Privacidade: privacy-policy.html (cobre coleta, uso, compartilhamento com Anthropic / OpenAI / Google, retenção, contato e revogação).
  • Logo / favicon: servido em https://mcp.minhaprova.com.br/favicon.ico.
  • Repositório / docs técnicas: README do servidor disponível mediante solicitação a suporte@minhaprova.com.br.

A lista completa de ferramentas (com nome técnico, título legível, anotações e descrição) é exposta pelo próprio servidor MCP via tools/list — basta conectar com o MCP Inspector ou qualquer cliente compatível.