MCP Tools Reference: classroommcp.googleapis.com

Narzędzie: create_topic

Tworzy nowy temat na zajęciach. Tematy służą do porządkowania materiałów dydaktycznych. Wymaga roli nauczyciela na zajęciach.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP create_topic.

Żądanie 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
}'

Schemat wejściowy

Prośba o utworzenie tematu na zajęciach.

CreateTopicRequest

Zapis JSON
{
  "courseId": string,
  "title": string
}
Pola
courseId

string

Wymagane. Identyfikator kursu.

title

string

Wymagane. Tytuł tematu. Możesz użyć maksymalnie 100 znaków.

Schemat wyjściowy

Temat w kursie.

Temat

Zapis JSON
{
  "id": string,
  "title": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator. Identyfikator tematu.

title

string

Tytuł tematu.

Adnotacje dotyczące narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość „true”, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.
  • destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.
  • idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z elementami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.

Wskazówka dotycząca niszczenia: ❌ | Wskazówka dotycząca idempotencji: ❌ | Wskazówka dotycząca tylko do odczytu: ❌ | Wskazówka dotycząca otwartego świata: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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