MCP Tools Reference: classroommcp.googleapis.com

Outil : search_course_standards

Recherche des normes d'apprentissage académiques dans un cours pour les ajouter à des documents de travail ou à des grilles d'évaluation. Le cours doit avoir des normes d'apprentissage configurées par l'enseignant.

  • Normes spécifiques : recherchez un code exact (par exemple, "HS-LS1-1") ou des mots clés spécifiques (includeGroupingStandards=false).
  • Catégories : définissez includeGroupingStandards=true avec un mot-clé général pour trouver les catégories parentes, puis transmettez l'ID de catégorie dans learningStandardIds pour affiner les résultats.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP search_course_standards.

Requête curl
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Demande de recherche dans les arbres de normes d'apprentissage présélectionnés au niveau du cours.

SearchCourseStandardsRequest

Représentation JSON
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Champs
courseId

string

Obligatoire. Identifiant du cours.

learningStandardIds[]

string

Facultatif. Limite la recherche à ces référentiels ou normes de catégorie et à leurs descendants. Transmettez un ID de référentiel de Course.learning_goals (dans list_courses) ou des ID de catégorie d'un appel précédent avec includeGroupingStandards = true (et non standardCode), mais pas les deux. Si ce champ est vide, la recherche porte sur toutes les normes du cours.

query

string

Obligatoire. Termes de recherche non sensibles à la casse. Les résultats doivent contenir TOUS les mots séparés par des espaces dans leur code ou leur instruction. - Lorsque includeGroupingStandards = false : transmettez un code standard exact (par exemple, "HS-LS1-1") ou deux à trois mots clés spécifiques (par exemple, "aire triangles"). - Lorsque includeGroupingStandards = true : transmettez un ou deux mots de domaine larges (par exemple, "géométrie") correspondant aux titres des catégories.

includeGroupingStandards

boolean

Facultatif. Si la valeur est "true", renvoie les en-têtes de catégorie (qui ne peuvent pas être tagués dans les documents de travail) dont les ID affinent les recherches ultérieures. Si la valeur est "false" (par défaut), renvoie les normes pouvant être taguées sur les documents de travail.

Schéma de sortie

Réponse contenant des normes d'apprentissage.

SearchCourseStandardsResponse

Représentation JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Champs
learningStandards[]

object (LearningGoal)

Liste des normes correspondantes.

LearningGoal

Représentation JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Champs
id

string

Uniquement en sortie. ID de l'objectif d'apprentissage. Pour associer un standard, utilisez un id de search_course_standards (et non standardCode).

type

enum (Type)

Uniquement en sortie. Type d'objectif d'apprentissage.

standardCode

string

Uniquement en sortie. Code standard (par exemple, "NY-2.NBT.4"). Renseigné uniquement pour les normes.

title

string

Uniquement en sortie. Description de l'instruction pour les normes ou titre lisible par l'humain pour les compétences.

documentTitle

string

Uniquement en sortie. Nom du document du programme. Renseigné uniquement pour les normes.

Type

Type d'objectif d'apprentissage.

Enums
TYPE_UNSPECIFIED Type d'objectif d'apprentissage non spécifié.
STANDARD Norme d'apprentissage d'un programme scolaire.
SKILL Compétence représentant un concept ou une compétence pédagogique. Seul un enseignant peut ajouter ou supprimer des compétences dans Classroom.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication de destruction : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication en monde ouvert : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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