Configurar o servidor MCP do Google Sala de Aula

O Google Sala de Aula oferece um servidor remoto do Protocolo de Contexto de Modelo (MCP) que permite que agentes de IA interajam com segurança com os dados do Google Sala de Aula. Ao configurar o servidor MCP do Google Sala de Aula, você permite que aplicativos de IA, como o Google Antigravity e o Claude, realizem ações no Google Sala de Aula.

O servidor MCP do Google Sala de Aula oferece uma maneira padronizada para os agentes de IA:

  • Ler dados: listar cursos, recuperar conteúdo e metadados de cursos e visualizar envios e notas.
  • Entre em ação: criar e atualizar atividades e avisos.
  • Respeitar a segurança: herdar as mesmas permissões e controles de governança de dados do usuário.

Para saber mais sobre os principais conceitos e benefícios dos servidores MCP remotos do Google, consulte a visão geral dos servidores MCP do Google Cloud.

Referência de ferramentas

As seguintes ferramentas estão disponíveis para o servidor MCP do Google Sala de Aula:

  • list_courses
  • list_course_work_submissions
  • get_course_work
  • create_course_work
  • update_course_work
  • list_course_work_submissions
  • list_topics
  • create_topic
  • list_announcement_summaries
  • get_announcements
  • create_announcement
  • get_course_work_rubric
  • create_course_work_rubric
  • get_course_roster
  • get_guardian_info
  • search_course_standards

Pré-requisitos

Configurar o servidor MCP do Google Sala de Aula

Para usar o servidor MCP do Google Sala de Aula, é necessário ativar os serviços de API e MCP no projeto do Google Cloud e, em seguida, configurar a conexão do cliente MCP.

Ativar os serviços de API e MCP do Google Sala de Aula

  1. Ative a API Google Classroom no seu projeto na nuvem do Google Cloud:

    Ativar as APIs

  2. Ative o serviço MCP do Google Sala de Aula no seu projeto na nuvem do Google Cloud:

    Ativar o serviço MCP

O servidor MCP do Google Sala de Aula usa o OAuth 2.0 para autenticação e autorização. É necessário configurar a tela de permissão OAuth antes de criar um ID do cliente OAuth.

  1. No console do Google Cloud, acesse Plataforma Google Auth > Branding.

    Acessar Branding

  2. Se você já configurou a Plataforma de autenticação do Google, é possível definir as seguintes configurações da tela de permissão OAuth em Branding, Público-alvo e Acesso a dados. Se aparecer a mensagem A plataforma de autenticação do Google ainda não está configurada, clique em Começar:

    1. Em Informações do app, em Nome do app, digite Classroom MCP Server.
    2. Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou um Grupo do Google adequado.
    3. Clique em Próxima.
    4. Em Público-alvo, selecione Interno. Se não for possível selecionar Interno, selecione Externo.
    5. Clique em Próxima.
    6. Em Dados de contato, insira um endereço de e-mail para receber notificações sobre mudanças no projeto.
    7. Clique em Próxima.
    8. Em Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
    9. Clique em Continuar.
    10. Clique em Criar.
    11. Se você selecionou Externo como tipo de usuário, adicione usuários de teste:
      1. Clique em Público-alvo.
      2. Em Usuários de teste, clique em Adicionar usuários.
      3. Insira seu endereço de e-mail e os outros usuários de teste autorizados. Depois, clique em Salvar.

  3. Clique em Acesso a dados > Adicionar ou remover escopos. Um painel vai aparecer com uma lista de escopos para cada API que você ativou no projeto na nuvem do Google Cloud.

    1. Em Adicionar escopos manualmente, cole os escopos do servidor MCP do Google Sala de Aula. Os escopos necessários para os comandos de exemplo são:

      • https://www.googleapis.com/auth/classroom.announcements
      • https://www.googleapis.com/auth/classroom.courses.readonly

    2. Clique em Adicionar à tabela.

    3. Clique em Atualizar.

    4. Depois de selecionar os escopos necessários para o app, na página Acesso a dados, clique em Salvar.

Configurar o cliente MCP

Para adicionar o servidor MCP remoto do Google Sala de Aula ao seu cliente MCP, siga as instruções do cliente. As instruções para dois clientes comuns são fornecidas aqui. Consulte Configurar o MCP em um aplicativo de IA para saber como conectar diferentes tipos de clientes.

Os IDs do cliente OAuth 2.0 delegados pelo usuário que chamam o servidor MCP do Google Sala de Aula precisam ter a opção Usar este cliente para um agente com tecnologia de IA selecionada em Plataforma de autenticação do Google > Clientes. Para atualizar um ID do cliente OAuth 2.0, selecione essa configuração em Plataforma de autenticação do Google > Clientes, conforme descrito em Gerenciar clientes OAuth. Se não for possível mudar essa configuração em um cliente atual ou se o cliente também oferecer suporte a recursos que não são de agente, crie um novo ID do cliente OAuth 2.0 para seu agente de IA. Para solicitações rejeitadas, contas de serviço com delegação em todo o domínio ou Google Apps Script, consulte Solução de problemas.

Antigravity

Para adicionar o servidor MCP remoto do Google Sala de Aula ao Antigravity, adicione a configuração do servidor ao arquivo mcp_config.json. Estas instruções são compatíveis com o Antigravity 2.0, o IDE do Antigravity e a CLI do Antigravity.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta:

    1. No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

    2. Selecione Aplicativo da Web como o tipo de aplicativo.

    3. Digite um Nome.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione https://antigravity.google/oauth-callback no campo URIs.

    5. Selecione Usar este cliente para um agente com tecnologia de IA.

    6. Clique em Criar e copie o ID do cliente e a chave secreta do cliente.

  2. Abra ou crie o arquivo de configuração ~/.gemini/config/mcp_config.json.

  3. Adicione a configuração mcpServers a mcp_config.json:

    {
  "mcpServers": {
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Substitua:

    • OAUTH_CLIENT_ID: o ID do cliente que você criou.
    • OAUTH_CLIENT_SECRET: a chave secreta do cliente que você criou.

  4. Economize mcp_config.json.

  5. Autentique o servidor MCP. É possível autenticar usando as configurações da GUI ou da CLI:

    • Para o IDE do Antigravity ou a GUI (Antigravity 2.0):

      1. Abra a tela de configurações (por exemplo, clique em Configurações no canto inferior esquerdo ou abra Configurações do usuário do Antigravity).
      2. Acesse Personalizações.
      3. Em Servidores MCP instalados, clique em Atualizar.
      4. Encontre classroom na lista, clique em Autenticar, faça login na sua Conta do Google, copie o código de autorização, cole-o na caixa de diálogo de entrada e clique em Enviar.

    • Para a CLI do Antigravity:

      1. Inicie a CLI do Antigravity:

        agy

      2. Abra o painel interativo de gerenciamento do MCP executando:

        /mcp

      3. Use as teclas de seta para selecionar classroom, vá até a ação Autenticar e pressione Enter. Conclua o fluxo de login no navegador, copie o código de autorização, cole-o no prompt do terminal e pressione Enter.

  6. Verifique se o servidor está configurado corretamente e em execução:

    • Para o IDE do Antigravity ou a GUI: um botão Sair é exibido ao lado do servidor em Personalizações > Servidores MCP instalados.
    • Para a CLI do Antigravity: abra o painel /mcp para conferir os servidores MCP configurados. Os servidores verificados e autenticados mostram Autenticado ao lado dos nomes no painel interativo da TUI. Selecione o servidor na visualização do painel para inspecionar o status dele e listar todas as ferramentas disponíveis.

O servidor MCP remoto está pronto para uso no Antigravity.

Claude

Para usar o servidor MCP remoto do Google Sala de Aula com o Claude.ai ou o Claude Desktop, você precisa ter o plano Claude Enterprise, Pro, Max ou Team.

Para adicionar o servidor MCP remoto do Google Sala de Aula ao Claude, configure um conector personalizado com um ID e uma chave secreta do cliente OAuth.

  1. Crie um ID do cliente OAuth 2.0 e uma chave secreta:

    1. No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente.

      Acesse "Criar cliente"

    2. Selecione Aplicativo da Web como o tipo de aplicativo.

    3. Digite um Nome.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Selecione Usar este cliente para um agente com tecnologia de IA.

    6. Clique em Criar e copie o ID do cliente e a chave secreta do cliente.

  2. Configure o servidor MCP no Claude:

    1. No Claude.ai ou no Claude Desktop, acesse Configurações > Conectores ou Configurações de administrador > Conectores.
    2. Clique em Adicionar conector personalizado.
    3. Insira os detalhes de conexão do produto Google Sala de Aula:
      • Nome do servidor: Google Classroom.
      • URL do servidor MCP remoto: https://classroommcp.googleapis.com/mcp/v1
    4. Em Autenticação, selecione Fazer login agora. Em Cliente OAuth, selecione Usar seu próprio cliente OAuth e insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
    5. Clique em Adicionar e em Conectar.

Outros

Muitos aplicativos de IA têm maneiras de se conectar a um servidor MCP remoto. Normalmente, é necessário inserir detalhes sobre o servidor, como nome, endpoints, protocolo de transporte e método de autenticação. Para o servidor MCP remoto do Google Sala de Aula, insira o seguinte:

  • Nome do servidor: classroom

  • URL do servidor: https://classroommcp.googleapis.com/mcp/v1

  • Transporte: HTTP com streaming

  • Autenticação: o servidor MCP remoto do Google Sala de Aula usa o OAuth 2.0. Ao criar seu cliente OAuth 2.0, selecione Usar este cliente para um agente com tecnologia de IA. Para mais detalhes, consulte Saiba mais sobre autenticação e autorização.

Testar o servidor MCP do Google Sala de Aula

Depois de configurar o cliente MCP, verifique a conexão executando alguns comandos de teste.

Faça as seguintes perguntas ao seu cliente do MCP:

  • "Quais turmas estou ensinando atualmente?"

    O cliente verifica sua programação usando o classroom.list_courses e resume os cursos ativos em que você tem a função de professor.

  • "Para minha aula de geologia, escreva um aviso sobre a próxima excursão."

    O cliente usa o classroom.create_announcement para criar o rascunho do aviso, que você pode revisar e postar no app Google Sala de Aula.

Se as ferramentas forem executadas com sucesso e você receber respostas relevantes, seu servidor MCP do Google Sala de Aula está configurado corretamente.

Ampliar a funcionalidade com outros servidores

Outros serviços do Google Workspace oferecem servidores MCP remotos. Para ampliar os recursos do seu cliente MCP, ative e configure outros servidores MCP remotos.

Para o Google Sala de Aula, em particular, configurar o servidor MCP do Google Drive pode ser especialmente útil para trabalhar com anexos.

Solução de problemas

Use as seções a seguir para resolver problemas comuns de autenticação e conexão com o servidor MCP do Google Sala de Aula.

Verificar eventos de registro do OAuth

Se você tiver problemas para se conectar ao servidor MCP, verifique se há erros nos registros do OAuth. Peça para o administrador do Google Workspace analisar os eventos de registro do OAuth na ferramenta de investigação de segurança.

Solicitações rejeitadas de clientes OAuth delegados pelo usuário

Se as solicitações para o servidor MCP forem rejeitadas, verifique se o ID do cliente OAuth 2.0 delegado pelo usuário para o fluxo OAuth de três etapas tem a opção Usar este cliente para um agente com tecnologia de IA selecionada em Plataforma de autenticação do Google > Clientes:

  • O cliente atual é compatível com a configuração: selecione Usar este cliente para um agente com tecnologia de IA no cliente OAuth atual.
  • Não é possível atualizar o cliente atual: crie um novo cliente OAuth com a opção Usar este cliente para um agente com tecnologia de IA selecionada e atualize seu app para usá-lo.
  • O cliente atual também oferece suporte a recursos que não são de agentes: crie um cliente OAuth separado para o agente de IA e mantenha o cliente atual para os recursos que não são de agentes.

Para instruções, consulte Configurar o cliente MCP e Gerenciar clientes OAuth.

Contas de serviço com delegação em todo o domínio

Se o app usa uma conta de serviço com delegação em todo o domínio para OAuth de duas etapas, não é possível selecionar Usar este cliente para um agente com tecnologia de IA porque as contas de serviço não são gerenciadas em Plataforma de autenticação do Google > Clientes:

  • Controle de acesso: as solicitações ao servidor MCP dessas contas de serviço não são rejeitadas por falta da configuração do agente. Em vez disso, o acesso é regido pelas configurações de delegação em todo o domínio que o administrador do Google Workspace gerencia. Para mais detalhes sobre as configurações de administrador, consulte Controlar o acesso da API com a delegação em todo o domínio.
  • Ações sensíveis: os servidores MCP do Google Workspace ainda retornam comandos de solicitação de formulário para confirmação com human-in-the-loop em chamadas de ferramentas sensíveis feitas por falsificação de identidade do usuário com delegação em todo o domínio.

Solicitações do Apps Script

Se você chamar o servidor MCP pelo Apps Script, não será possível selecionar Usar este cliente para um agente com tecnologia de IA no cliente OAuth padrão que o Apps Script cria e gerencia para seu script. Isso se aplica mesmo que o script use um projeto padrão do Google Cloud.

Para chamar o servidor MCP do Apps Script, faça o seguinte:

  1. No console do Google Cloud, acesse Plataforma do Google Auth > Clientes, crie um cliente OAuth e selecione Usar este cliente para um agente com tecnologia de IA.
  2. No script, use a biblioteca OAuth2 para o Apps Script para autorizar usuários com esse cliente OAuth.
  3. Ao chamar o servidor MCP, envie o token de acesso que a biblioteca retorna em vez do token de ScriptApp.getOAuthToken.

Os projetos do Apps Script que não chamam servidores MCP do Google Workspace não são afetados.

Solicitações de login repetidas a cada hora

Se você precisar fazer login novamente a cada hora, seu cliente MCP não está recebendo um token de atualização. O servidor OAuth 2.0 do Google emite um token de atualização somente quando a solicitação de autorização inclui access_type=offline. Solicitar apenas o escopo offline_access do OpenID Connect (OIDC) não retorna um.

Verifique se o cliente MCP é compatível com parâmetros de autorização personalizados:

  • O cliente aceita parâmetros de autorização personalizados: adicione access_type=offline à solicitação de autorização. Para receber um novo token de atualização para um usuário que já concedeu acesso, adicione também prompt=consent.
  • O cliente não é compatível com parâmetros de autorização personalizados: faça login novamente sempre que o token de acesso expirar.

Para mais detalhes, consulte Atualizar um token de acesso.

Consideração importante sobre segurança: injeção indireta de comando

Quando você expõe um modelo de linguagem a dados não confiáveis, há o risco de um ataque de injeção de comando indireto. Como os hosts MCP, como o Google Antigravity, têm acesso a ferramentas e APIs avançadas pelo servidor MCP do Google Sala de Aula, eles podem ler, modificar e excluir dados na sua Conta do Google.

Para reduzir esses riscos, é preciso analisar os comandos e as respostas em busca de conteúdo malicioso ou ataques de injeção de comandos. É possível usar o Model Armor fornecido pelo Google ou sua própria solução, desde que você a documente para que os usuários aceitem esse risco. Para mais informações, consulte Configurar a segurança dos servidores MCP do Google Workspace.

Siga estas práticas recomendadas:

  • Use apenas ferramentas confiáveis. Nunca conecte o servidor MCP do Google Sala de Aula a aplicativos não confiáveis ou não verificados.
  • Tenha cuidado com entradas não confiáveis. Evite pedir que o cliente MCP processe eventos ou outros recursos de fontes não verificadas. Essas entradas podem conter instruções ocultas que podem sequestrar sua sessão, permitindo que um invasor modifique, roube ou exclua seus dados.
  • Revise todas as ações. Sempre revise com cuidado as ações realizadas pelo cliente de IA em seu nome para garantir que estejam corretas e alinhadas com suas intenções.
  • Usar o Model Armor. Ative o Model Armor para se proteger contra ataques de injeção de comandos.

Feedback

Compartilhe feedback sobre o servidor MCP do Google Sala de Aula no nosso Issue Tracker público.