해당 대상: Enterprise 플랜의 회사 및 팀 관리자
Enterprise 구독의 회사 관리자로서, 조직 내에서 Miro MCP Server의 사용 여부를 결정합니다. 이 설정은 팀이 Miro와 연결된 AI 통합을 사용할 수 있는지를 결정합니다.
Miro MCP(Model Context Protocol)를 사용하여 Miro 보드를 MCP 호환 AI 도구와 연결합니다. 활성화되고 권한이 부여되면, AI 에이전트가 특정 보드의 컨텍스트를 읽고(허용되는 경우) Miro MCP 도구 셋을 통해 콘텐츠 요약이나 다이어그램 작성과 같은 작업을 수행할 수 있습니다. 이 가이드는 Public Beta의 사전 요구 사항, 인에이블먼트, 거버넌스 및 문제 해결을 설명합니다.
시작하기 전에
- 베타 약관을 검토하고 승인하세요. 베타 중에는 표준 SLA, 보안 의무, 지원 의무, 그리고 귀하의 MCA(또는 다른 계약) 하의 면책이 적용되지 않을 수 있습니다.
- 범위를 결정하세요: 조직 전체에 대해 활성화하거나 선택된 팀만을 대상으로 활성화합니다 (보드 수준 권한은 여전히 적용됨).
MCP 서버 활성화 또는 비활성화
MCP 서버를 활성화하려면:
- 관리자 설정 → 앱 & 통합 → MCP (베타)로 이동합니다.
- 제품 내 베타 공지와 링크된 문서를 검토하고, 베타 약관을 확인합니다.
- 범위를 선택합니다.
- 조직: 조직 내 모든 사용자가 이미 접근할 수 있는 보드를 위해 MCP를 승인할 수 있습니다.
- 선택된 팀: 해당 팀의 사용자만 MCP를 승인할 수 있으며, 보드 수준의 권한은 여전히 적용됩니다.
- 토글(켜짐). 변경 사항은 즉시 적용됩니다.
사용을 일시 중지하려면 동일한 위치에서 Miro MCP를 토글(꺼짐)하십시오 (새로운 툴 호출이 중단됩니다).
액세스 및 권한 작동 방식
MCP를 활성화하면 다음과 같은 작업이 가능합니다:
- 사용자가 권한을 부여하면 외부 AI 에이전트가 보드 콘텐츠를 읽을 수 있습니다
- AI 도구가 Miro 보드의 콘텐츠를 생성하거나 수정할 수 있습니다
- Miro와 제3자 애플리케이션 간의 안전한 데이터 교환이 가능합니다
중요한 보안 고려 사항:
- 모든 액세스는 OAuth 2.1을 통해 인증됩니다.
- 사용자는 보기 권한이 있는 보드에만 액세스를 허용할 수 있습니다.
- Enterprise 보안 규정 준수를 유지합니다.
- 모든 작업에 표준 API 속도 제한이 적용됩니다.
- 조직 내 사용자는 MCP 서버에 인증하여 외부/3자 AI 에이전트가 그들을 대신해 보드의 콘텐츠를 읽고 작성할 수 있게 됩니다.
조직에서 MCP 관리하기
관리자로서 다음을 고려해야 합니다:
- 커뮤니케이션: Miro MCP의 사용 가능성과 도입 사례를 팀에게 알립니다
- 교육: 다양한 AI 도구와 함께 MCP를 효과적으로 사용하는 방법을 안내합니다
- 거버넌스: AI 생성 콘텐츠의 적절한 사용에 대한 지침을 수립합니다
- 모니터링: MCP 사용을 주기적으로 검토하고 필요에 따라 설정을 조정합니다
귀하의 Miro 환경에서 앱 관리에 대한 자세한 내용은 앱 관리 문서를 참조하세요.
배포 가이드
- 작게 시작: 파일럿 팀 하나 또는 두 개(예: 엔지니어링, 제품)에 대해 활성화하고 가치를 검증/통제합니다.
- 프롬프트의 위생 강화를 위해 모든 MCP 프롬프트에 전체 보드 URL을 요구합니다.
문제 해결
- “내 클라이언트에서 Miro MCP 도구를 볼 수 없습니다”
- 조직 또는 해당 팀에 MCP가 활성화되어 있으며 사용자가 그 팀에 속해 있는지 확인합니다.
- OAuth 흐름을 다시 실행하고 MCP가 활성화된 팀을 선택합니다.
- 클라이언트가 MCP를 지원하며 현재 우리가 목표로 하고 있는 클라이언트인지 확인합니다.
- “프롬프트 시 접근이 거부되었습니다”
- 프롬프트에 전체 보드 URL이 포함되어 있는지 확인하세요. 에이전트는 보드를 자동으로 발견하지 않습니다.
- 사용자가 이미 Miro에서 해당 보드에 접근할 수 있는지 확인하세요.
- “지금 사용을 일시 중단해야 합니다”
- 관리자 설정 > 앱 & 통합 > Miro MCP (베타)에서 MCP를 끄세요.