MCP Tools Reference: classroommcp.googleapis.com

Outil : create_topic

Crée un thème dans un cours. Les thèmes servent à organiser les documents de travail. Nécessite un rôle d'enseignant dans le cours.

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

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": "create_topic",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Requête de création d'un thème dans un cours.

CreateTopicRequest

Représentation JSON
{
  "courseId": string,
  "title": string
}
Champs
courseId

string

Obligatoire. Identifiant du cours.

title

string

Obligatoire. Titre du sujet. Le nom ne doit pas dépasser 100 caractères.

Schéma de sortie

Un sujet dans un cours.

Sujet

Représentation JSON
{
  "id": string,
  "title": string
}
Champs
id

string

Uniquement en sortie. Identifiant. ID du sujet.

title

string

Titre du sujet.

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.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/classroom.topics