MCP Tools Reference: classroommcp.googleapis.com

Strumento: create_topic

Crea un nuovo argomento in un corso. Gli argomenti vengono utilizzati per organizzare le attività del corso. Richiede un ruolo di insegnante nel corso.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP create_topic.

Richiesta 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
}'

Schema di input

Richiesta di creazione di un argomento in un corso.

CreateTopicRequest

Rappresentazione JSON
{
  "courseId": string,
  "title": string
}
Campi
courseId

string

Obbligatorio. Identificatore del corso.

title

string

Obbligatorio. Titolo dell'argomento. Deve contenere massimo 100 caratteri.

Schema di output

Un argomento di un corso.

Argomento

Rappresentazione JSON
{
  "id": string,
  "title": string
}
Campi
id

string

Solo output. Identificatore. ID argomento.

title

string

Titolo dell'argomento.

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se è impostato su false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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