MCP Tools Reference: classroommcp.googleapis.com

Tool: create_topic

Erstellt ein neues Thema in einem Kurs. Themen werden verwendet, um Kursaufgaben zu organisieren. Erfordert die Rolle „Lehrkraft“ im Kurs.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool create_topic aufrufen.

Curl-Anfrage
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
}'

Eingabeschema

Anfrage zum Erstellen eines Themas in einem Kurs.

CreateTopicRequest

JSON-Darstellung
{
  "courseId": string,
  "title": string
}
Felder
courseId

string

Erforderlich. ID des Kurses.

title

string

Erforderlich. Titel des Themas. Darf höchstens 100 Zeichen lang sein.

Ausgabeschema

Ein Thema in einem Kurs.

Thema

JSON-Darstellung
{
  "id": string,
  "title": string
}
Felder
id

string

Nur Ausgabe. ID. Themen-ID.

title

string

Titel des Themas.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können jedoch verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise frei verfügbar, ein Tool für gemerkte Informationen jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Lesezugriff-Hinweis: ❌ | Hinweis „Open World“: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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