MCP Tools Reference: classroommcp.googleapis.com

Tool: search_course_standards

Sucht nach akademischen Bildungsstandards in einem Kurs, um sie mit Tags für Kursaufgaben oder Bewertungsschemas zu versehen. Für den Kurs müssen von der Lehrkraft Bildungsstandards konfiguriert worden sein.

  • Spezifische Standards: Suchen Sie mit dem genauen Code (z.B. „HS-LS1-1“) oder mit bestimmten Suchbegriffen (includeGroupingStandards=false).
  • Kategorien: Setzen Sie „includeGroupingStandards=true“ mit einem allgemeinen Themenbegriff, um übergeordnete Kategorien zu finden. Übergeben Sie dann die Kategorie-ID an „learningStandardIds“, um die Ergebnisse einzugrenzen.

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

Eingabeschema

Anfrage zum Suchen in den vorausgewählten Bildungsstandardbäumen auf Kursebene.

SearchCourseStandardsRequest

JSON-Darstellung
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Felder
courseId

string

Erforderlich. ID des Kurses.

learningStandardIds[]

string

Optional. Beschränkt die Suche auf diese Standardsätze oder Kategoriestandards und ihre untergeordneten Elemente. Übergeben Sie entweder eine Standardsatz-ID aus Course.learning_goals (in list_courses) oder Kategorie-IDs aus einem vorherigen Aufruf mit includeGroupingStandards = true (nicht standardCode), aber nicht beides. Wenn dieses Feld leer ist, werden alle Standards im Kurs durchsucht.

query

string

Erforderlich. Suchbegriffe ohne Berücksichtigung der Groß-/Kleinschreibung; die Ergebnisse müssen ALLE durch Leerzeichen getrennten Wörter im Code oder in der Anweisung enthalten. – Wenn includeGroupingStandards = false: Übergib einen genauen Standardcode (z.B. „HS-LS1-1“) oder 2–3 spezifische Suchbegriffe (z.B. „Fläche Dreiecke“). - Wenn includeGroupingStandards = true: Übergeben Sie 1–2 allgemeine Domainwörter (z.B. „Geometrie“), die mit den Kategorietiteln übereinstimmen.

includeGroupingStandards

boolean

Optional. Wenn „true“, werden Kategorieüberschriften (nicht mit Kursaufgaben taggbar) zurückgegeben, deren IDs nachfolgende Suchanfragen einschränken. Wenn „false“ (Standard), werden Standards zurückgegeben, die für Kursaufgaben getaggt werden können.

Ausgabeschema

Antwort mit Bildungsstandards.

SearchCourseStandardsResponse

JSON-Darstellung
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Felder
learningStandards[]

object (LearningGoal)

Die Liste der übereinstimmenden Standards.

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.

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
  • https://www.googleapis.com/auth/classroom.courses.readonly