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