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

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

대상

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

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

MCP를 사용하기 위해 코드를 작성할 필요는 없습니다. API 사용 방법은 이미 Public API를 사용하는 고급 사용자를 위한 선택 사항입니다.

이미 제공되는 기능

설정의 조직 분석 페이지에서는 현재 결제 기간에 대한 엄선된 탭을 확인할 수 있습니다. 학교와 강의실에는 개요, 사용량, 영향, 안전, 상위 사용자, 전체 사용자 탭이 제공됩니다. 팀에는 일반, Padlet, 사용자 탭이 제공됩니다. 단, 팀에 새로운 분석 페이지(베타)가 제공되는 경우에는 개요, 사용량, 영향, 상위 사용자, 전체 사용자 탭이 표시됩니다.

• 학교 계정 분석 (Padlet for Schools 및 Classroom)
• 팀 계정 분석

빠르게 시각적 현황을 확인하려면 대시보드를 사용하세요. 탭만으로는 쉽게 답을 찾을 수 없는 맞춤형 세분화가 필요하다면 MCP 또는 API를 사용하세요.

MCP / API로 추가되는 기능

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

• AI 클라이언트에서 일반적인 표현으로 질문하기 ("지난 결제 기간에 활동이 없었던 교사는 누구야?")
• 참여도, 멤버십, 콘텐츠 안전 측정 항목을 원하는 대로 조합하기
• 날짜 범위에 걸친 월별 데이터 보기
• 역할별로 세분화하기 (교사와 학생, 제작자와 기여자)
• 요청한 기준에 따라 순위를 매긴 상위 padlet, 상위 사용자, 상위 미디어 확인하기
• 분기별 비즈니스 리뷰(QBR) 또는 갱신 제안서에 붙여 넣을 수 있는 답변 받기

Padlet MCP 빠른 시작

1. AI 클라이언트에서 Padlet MCP를 연결합니다. 서버 URL은 https://mcp.padlet.com입니다. 전체 설정 방법은 Padlet MCP 서버를 참조하세요.
2. 분석을 조회할 조직의 관리자로 로그인하고 권한을 승인합니다. 강의실에서는 교사도 분석을 조회할 수 있습니다.
3. 일반적인 표현으로 질문합니다. 내부 도구의 이름을 언급할 필요가 없습니다. 학교, 강의실 또는 팀에 대해 알고 싶은 내용을 AI 어시스턴트에게 말하면 어시스턴트가 대신 Padlet MCP를 사용합니다.

예를 들면 다음과 같습니다.

선택 사항: 조직 분석 API

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

1. 설정의 Developer 페이지에서 API 키를 만들거나 복사합니다. 자세한 내용은 Public 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이 아니라 응답에서 누락됩니다. 대기 중인 값을 0으로 처리하지 마세요.

파일럿 액세스

프롬프트 예시

다음은 MCP 클라이언트에 복사해 사용할 수 있는 시작 문구입니다. 학교, 강의실 또는 팀에 맞게 표현을 조정하세요. 고객에게 보여 줄 자료를 준비할 때는 분석 페이지의 수치와 대조해 확인하세요.

• "이번 결제 기간에 우리 학교에서 활동 중인 교사와 라이선스 수는 각각 몇 개고, 어느 달에 감소했어?"
• "조직 내에서 조회수가 가장 높은 padlet은 뭐야? 상위 3개 보드/샌드박스를 알려줘."
• "교사 역할을 가진 구성원 중 지난 12개월 동안 Padlet을 사용하지 않은 사람은 누구야?"
• "이메일 도메인이 <ouremaildomain.edu>가 아닌 구성원은 몇 명이야?"

대시보드가 여전히 더 나은 점

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

• 시각적 개요 배너, 주요 기회 알림, 한 번의 클릭으로 보내는 PD 요청
• 검색, 역할 필터, 한 번의 클릭으로 다운로드할 수 있는 CSV가 포함된 전체 사용자 / 사용자 테이블
• 선택한 기간의 활동 및 비활동 교사 목록 다운로드 (학교 및 강의실)
• 파일럿 등록이 필요 없는 보기 — 설정 페이지는 API 사용 동의 없이도 적격 역할의 사용자에게 제공됩니다.

엄선된 탭만으로는 데모나 갱신 관련 논의에 필요한 질문에 정확히 답할 수 없을 때 MCP와 API가 유용합니다.

제한 사항:

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

자주 묻는 질문

관련 문서

• Padlet MCP 서버
• 학교 계정 분석
• 팀 계정 분석
• Public API
• 조직 분석 읽기 (개발자 문서)