MCP Tools Reference: classroommcp.googleapis.com

도구: search_course_standards

학습 과제 또는 기준표에 태그를 지정하기 위해 과정의 학술 학습 표준을 검색합니다. 교사가 학습 표준을 구성한 수업이 필요합니다.

  • 특정 표준: 정확한 코드(예: 'HS-LS1-1') 또는 특정 키워드(includeGroupingStandards=false)로 검색합니다.
  • 카테고리: 광범위한 주제 단어와 함께 includeGroupingStandards=true를 설정하여 상위 카테고리를 찾은 다음 카테고리 ID를 learningStandardIds에 전달하여 결과를 좁힙니다.

다음 코드 샘플은 curl를 사용하여 search_course_standards 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": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

사전 선택된 강의 수준 학습 표준 트리에서 검색을 요청합니다.

SearchCourseStandardsRequest

JSON 표현
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
필드
courseId

string

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

learningStandardIds[]

string

선택사항입니다. 검색을 이러한 표준 모음 또는 카테고리 표준 및 하위 요소로 제한합니다. Course.learning_goals(list_courses)의 표준 모음 ID 또는 includeGroupingStandards = 참(standardCode 아님)인 이전 호출의 카테고리 ID 중 하나를 전달합니다. 둘 다 전달하지는 않습니다. 비어 있으면 과정의 모든 기준을 검색합니다.

query

string

필수 항목입니다. 대소문자를 구분하지 않는 검색어입니다. 결과에는 코드 또는 문에 공백으로 구분된 모든 단어가 포함되어야 합니다. - includeGroupingStandards = false인 경우: 정확한 표준 코드(예: 'HS-LS1-1') 또는 2~3개의 구체적인 키워드(예: '삼각형 넓이')를 전달합니다. - includeGroupingStandards = true인 경우: 카테고리 제목과 일치하는 1~2개의 광범위한 도메인 단어(예: '기하학')를 전달합니다.

includeGroupingStandards

boolean

선택사항입니다. true인 경우 ID가 후속 검색 범위를 좁히는 카테고리 헤더(학습 과제에 태그할 수 없음)를 반환합니다. false(기본값)인 경우 학습 과제에 태그할 수 있는 표준을 반환합니다.

출력 스키마

학습 표준이 포함된 응답입니다.

SearchCourseStandardsResponse

JSON 표현
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
필드
learningStandards[]

object (LearningGoal)

일치하는 표준 목록입니다.

LearningGoal

JSON 표현
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
필드
id

string

출력 전용입니다. 학습 목표의 ID입니다. 표준을 연결하려면 search_course_standards의 id를 사용하세요(standardCode 아님).

type

enum (Type)

출력 전용입니다. 학습 목표의 유형입니다.

standardCode

string

출력 전용입니다. 표준 코드(예: 'NY-2.NBT.4')입니다. 표준에만 채워집니다.

title

string

출력 전용입니다. 표준에 대한 설명 또는 기술에 대한 인간이 읽을 수 있는 제목입니다.

documentTitle

string

출력 전용입니다. 교육과정 문서 이름입니다. 표준에만 채워집니다.

유형

학습 목표의 유형입니다.

열거형
TYPE_UNSPECIFIED 지정되지 않은 학습 목표 유형입니다.
STANDARD 학술 교육과정의 학습 표준입니다.
SKILL 교육 개념 또는 역량을 나타내는 스킬입니다. 클래스룸에서 교사만 기술을 추가하거나 삭제할 수 있습니다.

도구 주석

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