MCP Tools Reference: classroommcp.googleapis.com

Tool: list_courses

Listet die Kurse des Nutzers mit den entsprechenden Details auf (Abschnitt, Raum, Fach, Kurs-/Klassenstufen, Beschreibung, Lernziele, Status und Rolle des Nutzers). Verwenden Sie dies als primären Einstiegspunkt, um Kurse zu finden und ihre IDs abzurufen. Kurse haben oft denselben Titel. Verwenden Sie daher den Abschnitt, um sie voneinander zu unterscheiden. Gibt nur AKTIVE Kurse zurück, es sei denn, „courseState“ ist festgelegt (z.B. ARCHIVIERT).

Wenn Sie den Nutzer mit einem Kurs in der Classroom-Web-App verknüpfen möchten, verwenden Sie https://classroom.google.com/c/{course_id} (Stream) oder https://classroom.google.com/w/{course_id}/t/all (Seite „Kursaufgaben“). Verwenden Sie IDs genau so, wie sie zurückgegeben werden. Erraten oder ändern Sie sie nicht.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_courses 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": "list_courses",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfrage zum Auflisten von Kursen.

ListCoursesRequest

JSON-Darstellung
{
  "courseState": enum (State),
  "createdDateRange": {
    object (DateRange)
  },
  "timeZone": string,
  "titleContains": string,
  "pageSize": integer,
  "pageToken": string
}
Felder
courseState

enum (State)

Optional. Nach Kursstatus filtern. Die Standardeinstellung ist ACTIVE.

createdDateRange

object (DateRange)

Optional. Nach Erstellungsdatum filtern.

timeZone

string

Erforderlich. Die IANA-Zeitzone des Nutzers (z.B. "America/Los_Angeles"). Datumsangaben in dieser Anfrage werden in dieser Zeitzone interpretiert und Datumsangaben in der Antwort werden in dieser Zeitzone formatiert, entsprechend dem, was der Nutzer in Classroom sieht.

titleContains

string

Optional. Filtert den Titel nach einem Teilstring, wobei die Groß-/Kleinschreibung ignoriert wird.

pageSize

integer

Optional. Steuert die Seitengröße. Der Standardwert ist 10, der Höchstwert 50.

pageToken

string

Optional. Token für die Paginierung.

DateRange

JSON-Darstellung
{
  "startDate": string,
  "endDate": string
}
Felder
startDate

string

Inklusiver Beginn des Bereichs (Format: JJJJ-MM-TT).

endDate

string

Inklusives Ende des Bereichs (Format: JJJJ-MM-TT).

Bundesland

Status eines Kurses.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
ACTIVE Aktiver Status.
ARCHIVED Archivierter Status.
PROVISIONED Bereitgestellter Status.

Ausgabeschema

Antwort auf die Anfrage zum Auflisten von Kursen.

ListCoursesResponse

JSON-Darstellung
{
  "courses": [
    {
      object (Course)
    }
  ],
  "nextPageToken": string
}
Felder
courses[]

object (Course)

Die Liste der Kurse.

nextPageToken

string

Das Token für die nächste Seite.

Kurs

JSON-Darstellung
{
  "id": string,
  "title": string,
  "role": enum (Role),
  "creationDate": string,
  "state": enum (State),
  "section": string,
  "room": string,
  "subject": string,
  "gradeLevels": string,
  "description": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
Felder
id

string

ID. Kennung für diesen Kurs.

title

string

Titel des Kurses.

role

enum (Role)

Rolle des Nutzers in diesem Kurs.

creationDate

string

Erstellungsdatum des Kurses (Format: JJJJ-MM-TT). Leer, wenn das Erstellungsdatum nicht bekannt ist.

state

enum (State)

Nur Ausgabe. Status des Kurses.

section

string

Optional. Abschnitt des Kurses.

room

string

Optional. Raum des Kurses.

subject

string

Optional. Thema des Kurses.

gradeLevels

string

Optional. Klassenstufen des Kurses.

description

string

Optional. Beschreibung des Kurses.

learningGoals[]

object (LearningGoal)

Nur Ausgabe. Lernziele, die mit diesem Kurs verknüpft sind.

LearningGoal

JSON-Darstellung
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Felder
id

string

Nur Ausgabe. ID des Lernziels. Wenn Sie einen Standard anhängen möchten, verwenden Sie eine id aus „search_course_standards“ (nicht standardCode).

type

enum (Type)

Nur Ausgabe. Der Typ des Lernziels.

standardCode

string

Nur Ausgabe. Standardcode (z.B. „NY-2.NBT.4“). Wird nur für Standards ausgefüllt.

title

string

Nur Ausgabe. Beschreibung der Anforderung für Standards oder menschenlesbarer Titel für Fähigkeiten.

documentTitle

string

Nur Ausgabe. Name des Lehrplandokuments. Wird nur für Standards ausgefüllt.

Rolle

Rollen eines Nutzers in einem Kurs.

Enums
ROLE_UNSPECIFIED Nicht angegebene Rolle.
TEACHER Lehrkraft.
COTEACHER Rolle „Zusätzliche Lehrkraft“.
STUDENT Schüler/Student.
INVITED_OR_INACTIVE Eingeladene oder inaktive Rolle.

Bundesland

Status eines Kurses.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
ACTIVE Aktiver Status.
ARCHIVED Archivierter Status.
PROVISIONED Bereitgestellter Status.

Typ

Der Typ des Lernziels.

Enums
TYPE_UNSPECIFIED Nicht angegebener Lernzieltyp.
STANDARD Ein Bildungsstandard aus einem akademischen Lehrplan.
SKILL Eine Fähigkeit, die ein pädagogisches Konzept oder eine Kompetenz darstellt. Nur Lehrkräfte können in Classroom Kompetenzen hinzufügen oder entfernen.

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: ✅ | Hinweis „Lesezugriff“: ✅ | Hinweis „Open World“: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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