Padlet MCP에 관리자 분석을 요청하려면 어떻게 해야 하나요?

Carla Sese’in profil fotoğrafıCarla Sese tarafından 4일 전 güncellendi

학교 또는 팀 관리자 대시보드에서 원하는 방식으로 수치를 확인할 수 없나요? Padlet MCP를 AI 어시스턴트에 연결해 자연어로 학교, 강의실 또는 팀 분석을 요청하거나, 조직 분석 API를 직접 호출해 보세요.

전체 REST 레퍼런스(지표 카탈로그, 요청 형식, 오류 코드)는 docs.padlet.dev의 조직 분석 읽기를 참조하세요.

대상

이 문서는 다음 사용자를 위한 것입니다.

  • Padlet for Schools 또는 팀 계정의 소유자 및 관리자
  • 강의실 계정의 소유자 및 교사

MCP 경로를 사용하는 데 코드를 작성할 필요는 없습니다. API 경로는 이미 공개 API를 사용하는 고급 사용자를 위한 선택 사항입니다.

이미 제공되는 기능

설정의 조직 분석 페이지에는 현재 결제 기간에 맞춘 탭이 표시됩니다. 학교와 강의실에는 개요, 사용량, 영향, 안전, 상위 사용자, 전체 사용자 탭이 제공됩니다. 팀에는 일반, Padlet, 사용자 탭이 제공되며, 팀에 새로운 분석 페이지(베타)가 적용된 경우 개요, 사용량, 영향, 상위 사용자, 전체 사용자 탭이 제공됩니다.

빠르게 시각적으로 현황을 확인하려면 대시보드를 사용하세요. 탭에서 원하는 방식으로 답변을 얻기 어려운 경우, MCP 또는 API를 사용해 원하는 항목을 직접 지정하세요.

MCP/API로 추가되는 기능

대시보드에는 정해진 탭이 제공됩니다. MCP와 API를 사용하면 필요한 항목을 정확히 요청할 수 있습니다.

  • AI 클라이언트에서 자연어로 질문하기 ("지난 결제 기간에 활동이 없었던 교사는 누구인가요?")
  • 참여도, 멤버십, 콘텐츠 안전 지표를 원하는 대로 조합하기
  • 날짜 범위별 월간 데이터 보기
  • 역할별로 분류하기 (교사와 학생, 게시자와 기여자)
  • 요청한 기준에 따라 상위 padlet, 상위 사용자, 상위 미디어 순위 확인하기
  • QBR 또는 갱신 프레젠테이션에 붙여 넣을 수 있는 답변 얻기
콘텐츠 안전 지표 (검사한 항목, 신고된 항목, 적발률)는 학교와 강의실에서만 이용할 수 있습니다. 팀 조직에서 해당 지표를 요청하면 0이 아니라 오류가 반환됩니다.

Padlet MCP 빠른 시작

  1. AI 클라이언트에 Padlet MCP를 연결하세요. 서버 URL은 https://mcp.padlet.com입니다. 전체 설정 단계는 Padlet MCP 서버에서 확인할 수 있습니다.
  2. 로그인한 다음 조회하려는 조직의 관리자로 인증하세요. 강의실에서는 교사도 분석 데이터를 가져올 수 있습니다.
  3. 자연어로 질문하세요. 내부 도구의 이름을 지정할 필요는 없습니다. 학교, 강의실 또는 팀에 대해 알고 싶은 내용을 AI 어시스턴트에게 말하면 어시스턴트가 대신 Padlet MCP를 사용합니다.

예시는 다음과 같습니다.

사용 중인 MCP 클라이언트에 분석 답변이 아직 표시되지 않는다면, 다른 MCP 호환 클라이언트를 사용하거나 조직 분석 API를 이용해 보세요. 클라이언트 지원은 서버보다 늦게 적용될 수 있습니다.
어시스턴트는 사용자를 대신해 작동합니다. 로그인한 계정에서 볼 수 있도록 허용된 분석 데이터만 가져올 수 있습니다.

선택 사항: 조직 분석 API

직접 스크립트를 작성하고 싶으신가요? 관리자 API 키 (또는 강의실의 교사 키)로 공개 API를 사용하세요.

  1. 설정의 개발자 페이지에서 API 키를 만들거나 복사하세요. 자세한 내용은 공개 API 문서를 참조하세요.
  2. GET /me?include=organizations를 사용해 조직 ID를 찾으세요. wksp_ ID가 필요합니다. padlet.org의 org_ 조직은 아직 이 엔드포인트에서 지원되지 않습니다.
  3. 원하는 지표를 포함해 /organizations/{org_id}/analytics로 POST 요청을 보내세요.
  4. 응답이 202이거나 meta.pending에 항목이 있으면 Retry-After만큼 기다린 후 동일한 요청을 다시 보내세요. 분석은 백그라운드에서 계산되므로 처리 중인 지표는 응답에 포함되지 않습니다. 이를 0으로 간주하지 마세요.
전체 요청 형식, 지표 카탈로그, 작성 예시는 조직 분석 읽기에서 확인할 수 있습니다.

사용 자격

Padlet MCP 및 API를 통한 조직 분석은 Padlet for Schools 및 팀 계정의 소유자와 관리자, 그리고 강의실 계정의 소유자와 교사가 이용할 수 있습니다. Padlet에 별도로 활성화를 요청할 필요는 없습니다.

현재는 wksp_ 조직만 지원됩니다.

프롬프트 예시

아래 예시를 MCP 클라이언트에 붙여 넣어 사용할 수 있습니다. 학교, 강의실 또는 팀에 맞게 표현을 조정하고, 고객에게 보여 줄 프레젠테이션을 준비할 때는 분석 페이지의 수치와 대조해 확인하세요.

  • "이번 결제 기간에 우리 학교에서 활동 중인 교사와 라이선스는 각각 몇 명이고, 어느 달에 수치가 낮아졌나요?"
  • "조직의 padlet 중 조회수가 가장 높은 것은 무엇인가요? 상위 3개 보드/샌드박스를 알려 주세요."
  • "교사 역할을 가진 구성원 중 지난 12개월 동안 Padlet을 사용하지 않은 사람은 누구인가요?"
  • "이메일 도메인이 <ouremaildomain.edu>가 아닌 구성원은 몇 명인가요?"
필요한 항목을 요청하세요. 월별 데이터, 역할 필터, 게시물 또는 방문자 수 기준 상위 padlet, 학교나 강의실의 콘텐츠 안전 합계 등을 요청할 수 있습니다. 어시스턴트가 질문을 사용 가능한 지표에 맞춰 처리합니다.

대시보드가 더 유용한 경우

다음 기능을 이용하려면 설정의 분석 페이지를 사용하세요.

  • 시각적인 개요 배너, 주요 기회 안내, 원클릭 전문성 개발 요청
  • 검색 및 역할 필터가 제공되고 원클릭 CSV 다운로드가 가능한 전체 사용자/사용자 표
  • 개요 탭에서 선택한 기간의 활동 중인 교사와 비활동 교사 목록 다운로드 (학교 및 강의실)

시연이나 갱신 관련 논의에서 필요한 구체적인 질문에 정해진 탭으로 답하기 어려울 때 MCP와 API가 특히 유용합니다.

제한 사항:

  • 요청 제한: API 키와 조직별 시간당 60회 요청. 202 응답 후 재조회하는 요청도 포함됩니다.
  • 날짜 범위: 요청 한 건당 최대 24개월
  • 콘텐츠 안전: 학교 및 강의실만 지원됩니다. 팀에서 해당 지표를 요청하면 400 오류가 반환됩니다.
  • 멤버십 수: 과거 특정 시점의 구성원 현황이 아니라 현재 명단을 반영합니다.
  • 처리 중 ≠ 0: 계산 중인 지표는 응답에 포함되지 않습니다. 이를 0으로 간주하지 마세요.
  • 조직 유형: 현재는 wksp_만 지원됩니다.

자주 묻는 질문

분석을 요청하면 왜 404 오류가 표시되나요?

모든 거부 사유는 동일하게 표시됩니다. 조직을 찾을 수 없거나 액세스 권한이 없는 경우 모두 404가 반환됩니다. 해당 조직의 관리자 (또는 강의실의 교사)로 로그인했는지, 그리고 조직 ID가 wksp_로 시작하는지 확인하세요. 그래도 문제가 해결되지 않으면 지원팀에 문의하세요.

코드를 작성해야 하나요?

아니요. Padlet MCP를 연결하고 관리자로 로그인한 다음 자연어로 질문하세요. API 경로는 이미 공개 API를 사용하는 개발자와 고급 사용자를 위한 선택 사항입니다.

공개 API와 같은 기능인가요?

관련은 있지만, 동일한 제품 인터페이스는 아닙니다. 공개 API는 API 키를 사용하는 개발자를 위한 것입니다. Padlet MCP는 로그인하여 권한을 부여하는 AI 어시스턴트를 위한 것입니다. 두 가지 모두 조직 분석에 액세스할 수 있으므로 어느 한쪽 또는 둘 다 사용할 수 있습니다.

학생이나 관리자가 아닌 사용자도 이 방법으로 조직 분석을 볼 수 있나요?

아니요. 분석을 이용하려면 조직의 관리자이거나 강의실의 교사여야 합니다. 어시스턴트의 액세스 권한은 로그인한 계정과 정확히 동일하며, 그 이상은 허용되지 않습니다.

MCP 클라이언트가 분석을 인식하지 못하는 것 같습니다. 어떻게 해야 하나요?

일부 클라이언트는 도구 목록을 업데이트하는 데 시간이 걸립니다. Padlet MCP를 다시 연결하거나 다른 MCP 호환 클라이언트로 전환하거나, 조직 분석 API를 직접 사용해 보세요. 그래도 해결되지 않으면 문의해 주세요.

관련 문서

Bu makale faydalı oldu mu?

İlgili makaleler