실행 가능한 사용자: Enterprise 플랜의 회사 관리자 및 팀 관리자
Enterprise 구독의 회사 관리자는 조직에서 Miro MCP Server 사용 가능 여부를 제어합니다. 이 설정은 팀이 Miro에 연결된 AI 통합을 사용할 수 있는지 여부를 결정합니다.
Miro MCP (Model Context Protocol)를 사용해 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 서버에 인증할 수 있어 외부 또는 타사 AI 에이전트가 사용자를 대신해 보드의 콘텐츠를 읽고 생성할 수 있습니다.
조직에서 MCP 관리
관리자는 다음 사항을 고려하세요:
- 커뮤니케이션: 팀에 Miro MCP 사용 가능성과 사용 사례를 알려주세요.
- 교육: 다양한 AI 도구와 함께 MCP를 효과적으로 사용하는 방법을 안내하세요.
- 거버넌스: AI 생성 콘텐츠의 적절한 사용에 관한 지침을 수립하세요.
- 모니터링: 정기적으로 MCP 사용 현황을 검토하고 필요에 따라 설정을 조정하세요.
Miro 환경에서 앱 관리에 대한 자세한 내용은 앱 관리 문서를 참조하세요.
도입 안내
- 작게 시작하세요. 예: 엔지니어링팀과 제품팀 등 파일럿 팀 한두 곳에 먼저 활성화해 가치와 통제를 검증하세요.
- 프롬프트 위생을 강화하세요. 모든 MCP 프롬프트에 사용자가 전체 보드 URL을 포함하도록 요구하세요.
Miro에 연결할 수 있는 MCP 클라이언트 관리
회사 관리자는 조직에서 모든 클라이언트가 Miro에 접근하도록 허용하거나, 사용자 지정 MCP 클라이언트를 포함한 클라이언트의 허용 목록을 관리할 수 있습니다.
다음 단계를 따르세요:
- 관리자 콘솔에서 앱 및 통합 > MCP. 아직 MCP를 활성화하지 않았다면 MCP 활성화를 참조하세요.
-
액세스 제어에서는 모든 클라이언트가 기본 설정입니다. 변경하려면 모든 클라이언트, 를 클릭한 다음 특정 클라이언트를 클릭하세요.
특정 MCP 클라이언트 패널이 열립니다. - 허용할 클라이언트를 토글로 켜세요. 사용자 지정 MCP 클라이언트를 허용하려면 검색창 상단에 클라이언트 이름을 입력한 다음 추가를 클릭하세요. 자세한 내용은 Miro MCP 개발자 문서를 참조하세요.
-
저장을 클릭하세요.
패널이 닫히고 지정한 클라이언트가 액세스 제어 아래에 한 줄로 표시됩니다.
팁: 특정 클라이언트를 허용하지 않으려면 앱 및 통합 > MCP > 모든 클라이언트(액세스 제어 아래)로 돌아가 해당 클라이언트를 끄세요.
참고: 사용자 지정 MCP 클라이언트를 추가한 후 해당 클라이언트를 허용하지 않도록 설정하면 목록에서 삭제됩니다. 다시 허용하려면 클라이언트를 다시 추가해야 합니다. 자세한 내용은 Miro에 연결할 수 있는 MCP 클라이언트 제어의 3단계를 참조하세요.
문제 해결
- “내 클라이언트에서 Miro MCP 도구가 보이지 않습니다”
- MCP가 조직 또는 해당 팀에 대해 활성화되어 있는지, 그리고 사용자가 그 팀에 속해 있는지 확인하세요.
- OAuth 흐름을 다시 실행하고 MCP가 활성화된 팀을 선택하세요.
- 클라이언트가 MCP를 지원하는지 및 당사가 대상으로 하거나 문서화한 클라이언트 목록에 포함되는지 확인하세요.
- “프롬프트 실행 시 액세스가 거부됨”
- 프롬프트에 전체 보드 URL이 포함되어 있는지 확인하세요. 에이전트는 보드를 자동으로 찾아내지 못합니다.
- 사용자가 Miro에서 해당 보드에 이미 접근 권한이 있는지 확인하세요.
- “지금 사용을 일시 중단해야 합니다”
- 관리자 설정 > 앱 및 통합 > Miro MCP에서 MCP를 끄세요.
- “사용자의 클라이언트가 차단되었거나 액세스 오류가 발생합니다”
- 해당 클라이언트가 액세스 제어에서 켜져 있는지 확인하거나, 사용자 지정 클라이언트로 추가하세요.