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