Miro MCP Server (관리자 가이드)

누가 할 수 있나요: Enterprise 플랜의 회사 관리자 및 팀 관리자

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

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

시작하기 전에

• 조직에 대해 MCP를 활성화한 다음 액세스 제어를 사용하여 누가 사용할 수 있을지 결정합니다.
• 액세스를 모든 사용자에게 열어두거나 선택한 팀과 선택적으로 사용자 그룹으로 제한할 수 있습니다. 보드 수준 권한은 계속 적용됩니다.

MCP Server 켜기 또는 끄기

MCP Server를 활성화하려면:

1. 관리자 설정 > 앱 및 통합 > MCP로 이동합니다.
2. MCP 사용에서 조직의 사용자가 Miro를 MCP 호환 클라이언트에 연결하도록 허용을 켭니다.

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

사용을 일시 중지하려면 동일한 토글을 끄면 됩니다(새 도구 호출이 중단됩니다).

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

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

액세스 제어 > 특정 팀 및 사용자 그룹에서 MCP를 활성화한 후 누가 사용할 수 있을지 선택합니다.

설정	MCP를 사용할 수 있는 사람
모두 (기본값)	활성화된 팀의 모든 사용자
특정 팀 및 사용자 그룹	선택한 팀과 사용자 그룹 둘 다에 속한 사용자만

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

1. 관리자 콘솔에서 앱 및 통합 > MCP로 이동합니다.
2. 액세스 제어에서 Teams and user groups 드롭다운을 열고 특정 팀 및 사용자 그룹을 선택합니다.
   MCP 액세스 추가 패널이 열립니다.
3. 팀 선택:
   1. 조직의 모든 팀을 선택하거나 특정 팀을 선택합니다.
   2. 특정 팀을 선택한 경우 팀 선택기를 열고 팀을 검색하여 선택한 다음 팀 추가를 클릭하고 패널로 돌아갑니다.
   3. 다음을 클릭합니다.
4. 사용자 그룹으로 필터링:
   1. 선택한 팀의 모든 사용자를 선택하거나 선택된 사용자 그룹에도 속한 사용자만을 선택합니다.
   2. 특정 사용자 그룹을 선택한 경우 사용자 그룹 선택기를 열어 그룹을 검색하고 선택한 다음 사용자 그룹 추가를 클릭하고 패널로 돌아갑니다.
   3. 다음을 클릭합니다.
5. 요약 및 확인: 요약을 검토합니다(예: 6개 팀에 속하고 1개 사용자 그룹에도 속한 사용자가 Miro MCP에 액세스할 수 있음). 편집을 클릭하여 팀이나 사용자 그룹을 변경할 수 있습니다.
6. 액세스 추가를 클릭합니다.

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

특정 팀 및 사용자 그룹을 선택한 경우, 사용자가 Miro MCP를 승인하려면 구성한 두 조건을 모두 충족해야 합니다:

1. 선택된 팀에 속해야 합니다(또는 모든 팀을 선택한 경우 모든 팀에 대해 적용됨).
2. 사용자 그룹을 선택한 경우, 해당 사용자 그룹 중 적어도 하나에 속해야 합니다.

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

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

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

예시

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

액세스 및 권한 동작 방식

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

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

중요한 보안 고려사항:

• 액세스는 OAuth 2.1을 통해 인증되며, Claude에 대해 활성화한 경우에는 엔터프라이즈 관리형 권한 부여(EMA)를 통해 인증됩니다. 자세한 내용은 Miro MCP용 엔터프라이즈 관리형 권한 부여 설정을 참조하세요.
• 사용자는 자신이 볼 수 있는 권한이 있는 보드에만 액세스 권한을 부여할 수 있습니다.
• 엔터프라이즈 보안 규정 준수가 유지됩니다.
• 모든 작업에 표준 API 속도 제한이 적용됩니다.
• 조직의 사용자는 외부 또는 서드파티 AI 에이전트가 사용자를 대신해 보드의 콘텐츠를 읽고 생성할 수 있도록 MCP Server에 인증할 수 있습니다.
• MCP를 팀 및 사용자 그룹으로 제한하면 해당 선택 범위 밖에 있는 사용자는 OAuth를 통해 MCP를 승인할 수 없습니다. EMA는 구성한 기본 팀과 신뢰할 수 있는 발행자를 대신 사용합니다.

조직에서 MCP 관리하기

관리자는 다음을 고려해야 합니다:

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

조직의 Miro 환경에서 앱을 관리하는 방법에 대한 자세한 내용은 앱 관리 문서를 참조하세요.

롤아웃 가이드

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

Claude용 엔터프라이즈 관리형 권한 부여(EMA) 설정

엔터프라이즈 관리형 권한 부여(EMA)를 사용하면 ID 공급자가 Claude용 Miro MCP 액세스를 부여하므로 사용자가 별도의 Miro OAuth 로그인을 완료하지 않아도 됩니다. 다른 MCP 클라이언트는 계속 OAuth를 사용합니다.

MCP 페이지의 Enterprise-Managed Authorization에서 기본 팀을 선택하고 ID 공급자(첫 릴리스에서는 Okta)의 신뢰할 수 있는 발행자를 추가한 다음 Anthropic 관리자 콘솔에서 설정을 완료합니다.

자세한 정보: Miro MCP용 엔터프라이즈 관리형 권한 부여 설정을 참조하세요.

어떤 MCP 클라이언트가 Miro에 연결할지 제어

회사 관리자라면 조직에서 모든 클라이언트가 Miro에 액세스하도록 허용하거나, 자체 맞춤형 MCP 클라이언트를 포함한 클라이언트 허용 목록을 관리할 수 있습니다.

다음 단계를 따르세요:

1. 관리자 콘솔에서 앱 및 통합 > MCP로 이동합니다. 아직 MCP를 활성화하지 않았다면 MCP Server 켜기 또는 끄기를 참조하세요.
2. 액세스 제어에서 기본 설정은 모든 클라이언트입니다. 수정하려면 모든 클라이언트를 클릭한 다음 특정 클라이언트를 클릭합니다.
   특정 MCP 클라이언트 패널이 열립니다.
3. 허용하려는 클라이언트를 켭니다. 맞춤형 MCP 클라이언트를 허용하려면 검색창(상단)에 클라이언트 이름을 입력한 후 추가를 클릭합니다. 자세한 내용은 Miro MCP 개발자 문서를 참조하세요.
4. 저장을 클릭합니다.
   패널이 닫히며 지정한 클라이언트들이 액세스 제어 아래 행에 표시됩니다.

어떤 클라이언트를 허용하지 않으려면 앱 및 통합 > MCP > 모든 클라이언트(액세스 제어 아래)로 돌아가 해당 클라이언트의 토글을 끕니다.

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

문제 해결

• “클라이언트에서 Miro MCP 도구가 보이지 않아요”
  • 조직에 대해 MCP가 활성화되어 있는지 확인하세요.
  • 액세스 제어 > 팀 및 사용자 그룹에서 사용자가 포함되어 있는지 확인하세요(선택된 팀에 속해 있고 사용자 그룹을 구성한 경우 해당 그룹에도 속해 있어야 함).
  • OAuth 흐름을 다시 실행하고 MCP 액세스가 있는 팀을 선택하세요.
  • Claude의 엔터프라이즈 관리형 권한 부여의 경우 EMA가 활성화되어 있는지, 사용자가 EMA 기본 팀에 속해 있는지, 신뢰할 수 있는 발행자에 대해 Discovery resolved 및 Keys reachable가 표시되는지, Anthropic 관리자 콘솔에서 Miro 커넥터에 대해 EMA가 켜져 있는지 확인하세요.
  • 클라이언트가 MCP를 지원하며 문서화된 대상 클라이언트 목록에 포함되어 있는지 확인하세요.
• “프롬프트 시 액세스 거부됨”
  • 프롬프트에 전체 보드 URL이 포함되어 있는지 확인하세요. 에이전트는 보드를 자동으로 검색하지 않습니다.
  • 사용자가 해당 보드에 대해 이미 Miro에서 액세스 권한을 가지고 있는지 확인하세요.
  • 이전에 사용 권한이 있었는데 작동이 중지된 경우, 팀 및 사용자 그룹 액세스 제어가 변경되었는지 또는 해당 사용자가 선택된 팀이나 사용자 그룹에서 제거되었는지 확인하세요.
• “지금 사용을 일시 중지해야 합니다”
  • 관리자 설정 > 앱 및 통합 > MCP에서 MCP를 끕니다.
• “사용자의 클라이언트가 차단되었거나 액세스 오류를 반환함”
  • 액세스 제어에서 해당 클라이언트가 켜져 있는지 확인하거나 맞춤형 클라이언트로 추가하세요.