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

필수 항목입니다. 수업의 식별자입니다.

title

string

필수 항목입니다. 주제 제목입니다. 100자(영문 기준) 이하여야 합니다.

출력 스키마

과정의 주제입니다.

주제

JSON 표현
{
  "id": string,
  "title": string
}
필드
id

string

출력 전용입니다. 식별자. 주제 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