Miro MCP 서버(관리자 가이드)

실행 가능한 사용자: Enterprise 플랜의 회사 관리자 및 팀 관리자

Enterprise 구독의 회사 관리자는 조직에서 Miro MCP Server 사용 여부를 제어합니다. 이 설정은 팀이 Miro와 연동되는 AI 통합 기능을 사용할 수 있는지를 결정합니다.

Miro MCP (Model Context Protocol)을 사용해 Miro 보드를 MCP 호환 AI 도구에 연결하세요. 활성화되고 권한이 부여되면 AI 에이전트는 특정 보드의 컨텍스트를 읽고(허용된 경우) 선별된 Miro MCP 도구를 통해 콘텐츠 요약이나 다이어그램 생성과 같은 작업을 수행할 수 있습니다. 이 가이드는 사전 요구 사항, 인에이블먼트, 거버넌스 및 문제 해결 방법을 설명합니다.

시작하기 전에

• 조직에서 MCP를 활성화한 다음 액세스 제어에서 누가 사용할 수 있는지 결정하세요.
• 액세스를 모든 사용자에게 허용하거나, 선택한 팀과 필요 시 사용자 그룹으로 제한할 수 있습니다. 보드 수준 권한은 계속 적용됩니다.

MCP 서버 활성화 또는 비활성화

MCP 서버를 활성화하려면:

1. 관리자 설정 > 앱 및 통합 > MCP로 이동하세요.
2. MCP 활성화에서 조직의 사용자가 Miro를 MCP 호환 클라이언트에 연결할 수 있도록 허용합니다 옵션을 켜세요.

변경 사항은 즉시 적용됩니다.

사용을 일시 중지하려면 동일한 토글을 꺼 새 툴 호출을 중단하세요.

MCP는 포맷 생성 또는 콘텐츠 관련 작업에 Miro AI를 사용할 수 있습니다. 해당 작업은 조직의 Miro AI 크레딧을 소모합니다.

MCP 설정이 보이지 않으면 계정 담당자에게 문의하세요.

팀 및 사용자 그룹으로 액세스 제어

Access control > Teams and user groups에서 MCP를 활성화한 후 누가 Miro MCP를 사용할 수 있는지 선택하세요.

특정 팀 및 사용자 그룹에 액세스 제한

1. 관리자 콘솔에서 앱 및 통합 > MCP로 이동합니다.
2. 액세스 제어에서 팀 및 사용자 그룹 드롭다운을 열고 특정 팀 및 사용자 그룹을 선택합니다.
   MCP 액세스 추가 패널이 열립니다.
3. 팀 선택:
   1. 조직의 모든 팀 또는 특정 팀을 선택합니다.
   2. 특정 팀을 선택한 경우 팀 선택기를 열어 팀을 검색해 선택한 다음 팀 추가를 클릭하고 패널로 돌아갑니다.
   3. 다음을 클릭합니다.

팀 및 사용자 그룹 액세스 작동 방식

특정 팀 및 사용자 그룹을 사용하는 경우, 사용자는 설정한 두 가지 조건을 모두 만족해야만 Miro MCP를 승인할 수 있습니다:

1. 사용자는 선택된 팀에 속해 있어야 합니다. 모든 팀을 선택한 경우에는 어느 팀에 속해 있어도 됩니다.
2. 사용자 그룹을 선택한 경우에는 사용자가 해당 그룹 중 적어도 하나에 속해 있어야 합니다.

만약 선택된 팀의 모든 사용자를 선택하면 팀 요건만 적용됩니다.

사용자 그룹 소속만으로는 충분하지 않습니다. 사용자는 또한 선택된 팀에도 속해 있어야 합니다.

여러 사용자 그룹을 선택하면 사용자는 해당 그룹 중 어느 하나에 속하면 됩니다. 모든 그룹에 속할 필요는 없습니다.

예시

• 모든 사용자: 활성화된 팀의 모든 사용자가 MCP를 승인할 수 있습니다.
• 특정 팀(예: 팀 A 및 팀 B), 선택된 팀의 모든 사용자: 팀 A 또는 팀 B에 속한 사용자는 MCP를 승인할 수 있습니다. 팀 C에만 속한 사용자는 승인할 수 없습니다.
• 특정 팀(팀 A) 및 특정 사용자 그룹(사용자 그룹 1): 팀 A 및 사용자 그룹 1에 모두 속한 사용자만 MCP를 승인할 수 있습니다. 예를 들어 팀 A에 100명이 있고 사용자 그룹 1에 그중 20명이 포함되어 있다면, MCP를 사용할 수 있는 사람은 그 20명뿐입니다.
• 모든 팀 및 특정 사용자 그룹: 어떤 팀에 속해 있든 선택된 사용자 그룹에도 속한 사용자는 MCP를 승인할 수 있습니다.
• 다시 모든 사용자로 전환: 패널에서 선택한 팀과 사용자 그룹으로 더 이상 액세스가 제한되지 않습니다.

액세스 및 권한의 작동 방식

MCP를 활성화하면 다음을 허용합니다:

• 사용자가 승인하면 외부 AI 에이전트가 보드 콘텐츠를 읽을 수 있습니다.
• AI 도구가 Miro 보드의 콘텐츠를 생성하거나 수정할 수 있습니다.
• Miro와 타사 애플리케이션 간의 안전한 데이터 교환.

중요 보안 고려사항:

• 모든 액세스는 OAuth 2.1을 통해 인증됩니다.
• 사용자는 보기 권한이 있는 보드에만 접근 권한을 부여할 수 있습니다.
• Enterprise 보안 규정 준수가 유지됩니다.
• 모든 작업에 표준 API 요청 한도가 적용됩니다.
• 조직의 사용자는 MCP Server에 인증하면 외부 또는 타사 AI 에이전트를 대신해 보드의 콘텐츠를 읽고 생성할 수 있습니다.
• 팀과 사용자 그룹으로 MCP를 제한하면 선택 대상 외의 사용자는 MCP를 승인할 수 없습니다.

조직에서 MCP 관리

관리자로서 고려해야 할 사항:

1. 커뮤니케이션: 팀에 Miro MCP의 사용 가능 여부와 도입 사례를 알리세요.
2. 교육: 다양한 AI 도구와 함께 MCP를 효과적으로 사용하는 방법을 안내하세요.
3. 거버넌스: AI 생성 콘텐츠의 적절한 사용을 위한 지침을 마련하세요.
4. 모니터링: 정기적으로 MCP 사용 현황을 검토하고 필요에 따라 설정을 조정하세요.

Miro 환경에서 앱 관리에 대한 자세한 내용은 앱 관리 문서를 참조하세요.

도입 가이드

• 작게 시작하세요: 액세스 제어에서 특정 팀 및 사용자 그룹을 선택하고 파일럿 팀 한두 개를 선택한 다음 사용자 그룹은 선택한 팀의 모든 사용자로 둡니다.
• 더 제한된 파일럿을 원하면 특정 사용자 그룹에도 속한 사용자만을 선택해 그 그룹만 MCP를 승인할 수 있게 합니다.
• 프롬프트 사용 수칙을 강화하세요: 모든 MCP 프롬프트에 전체 보드 URL을 포함하도록 요구합니다.

Miro에 연결할 수 있는 MCP 클라이언트 제어

회사 관리자는 조직에서 Miro에 접속할 수 있는 모든 클라이언트를 허용하거나, 자체 사용자 지정 MCP 클라이언트를 포함한 허용 목록을 관리할 수 있습니다.

다음 단계를 따르세요:

1. 관리자 콘솔에서 앱 및 통합 > MCP로 이동하세요. 아직 MCP를 사용 설정하지 않았다면 MCP Server 켜기 또는 끄기를 참조하세요.
2. 액세스 제어에서 모든 클라이언트가 기본 설정입니다. 변경하려면 모든 클라이언트를 클릭한 다음 특정 클라이언트를 클릭하세요.
   특정 MCP 클라이언트 패널이 열립니다.
3. 허용할 클라이언트를 토글로 켜세요. 사용자 지정 MCP 클라이언트를 허용하려면 상단의 검색창에 클라이언트 이름을 입력한 다음 추가를 클릭하세요. 자세한 내용은 Miro MCP 개발자 문서를 참조하세요.
4. 저장을 클릭하세요.
   패널이 닫히고 지정한 클라이언트가 액세스 제어 아래에 한 줄로 표시됩니다.

클라이언트 허용을 취소하려면 앱 및 통합 > MCP > 모든 클라이언트 (액세스 제어 아래)로 돌아가 해당 클라이언트의 토글을 끄세요.

사용자 지정 MCP 클라이언트를 추가한 후 나중에 허용을 취소하면 해당 클라이언트가 목록에서 제거됩니다. 다시 허용하려면 클라이언트를 다시 추가해야 합니다. Miro에 연결할 수 있는 MCP 클라이언트를 제어의 3단계를 참조하세요.

문제 해결

• “Miro MCP 도구를 클라이언트에서 볼 수 없습니다”
  • 조직에 대해 MCP가 활성화되어 있는지 확인하세요.
  • 액세스 제어 > 팀 및 사용자 그룹에서 사용자가 포함되어 있는지 확인하세요(선택한 팀에 속해 있고, 사용자 그룹을 구성한 경우 선택한 사용자 그룹에도 속해 있는지).
  • OAuth 플로우를 다시 실행하고 MCP 접근 권한이 있는 팀을 선택하세요.
  • 클라이언트가 MCP를 지원하며 Miro가 대상으로 삼거나 문서화한 클라이언트인지 확인하세요.
• “프롬프트 시 액세스 거부”
  • 프롬프트에 전체 보드 URL이 포함되어 있는지 확인하세요. 에이전트는 보드를 자동으로 검색하지 않습니다.
  • 사용자가 이미 Miro에서 해당 보드에 접근 권한이 있는지 확인하세요.
  • 사용자가 이전에 접근 권한이 있었으나 작동이 중단된 경우, 팀 및 사용자 그룹 액세스 제어가 변경되었는지 또는 사용자가 선택된 팀이나 사용자 그룹에서 제거되었는지 확인하세요.
• “지금 사용을 일시 중단해야 합니다”
  • 다음 경로에서 MCP를 끄세요: 관리자 설정 > 앱 및 통합 > MCP.
• “사용자의 클라이언트가 차단되었거나 액세스 오류가 발생함”
  • 해당 클라이언트가 액세스 제어에서 활성화되어 있는지 확인하거나, 사용자 지정 클라이언트로 추가하세요.