MCP Tools Reference: classroommcp.googleapis.com

工具:create_topic

在課程中建立新主題。主題可用來整理課程作業。必須具備課程中的老師角色。

以下程式碼範例說明如何使用 curl 呼叫 create_topic MCP 工具。

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

輸入內容的結構定義

要求在課程中建立主題。

CreateTopicRequest

JSON 表示法
{
  "courseId": string,
  "title": string
}
欄位
courseId

string

必填。課程 ID。

title

string

必填。主題名稱。不得超過 100 個半形字元。

輸出內容的結構定義

課程中的主題。

主題

JSON 表示法
{
  "id": string,
  "title": string
}
欄位
id

string

僅供輸出。ID。主題 ID。

title

string

主題名稱。

工具註解

工具註解會傳送至 MCP 用戶端,說明特定工具的基本風險。大多數用戶端會將這些提示視為不受信任,但可用於決定何時向使用者傳送確認提示。

除了標題字串外,下列布林值提示的定義如下:

  • readOnlyHint:如果為 true,工具不會修改環境。預設值:false。
  • destructiveHint:如果為 true,工具可以執行破壞性動作。如果為 false,則工具只能執行附加動作。預設值:true。
  • idempotentHint:如果設為 true,則使用相同引數重複呼叫工具,不會對環境造成額外影響。預設值:false。
  • openWorldHint:如果設為 true,工具就能與外部實體的「開放世界」互動。如果設為 false,工具只能與內部實體互動。舉例來說,網頁搜尋工具屬於開放世界,而記憶工具則不屬於開放世界。

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

授權範圍

需要下列其中一種 OAuth 範圍:

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