Enterprise 계정의 경우 MCP를 활성화하려면 관리자의 승인이 필요합니다. Enterprise 팀에 속해 있다면 Miro MCP 관리자 가이드를 참조하세요.
MCP 클라이언트에 연결하려면 팀과 조직에서 Miro MCP가 활성화되어 있고 권한이 부여되어 있어야 합니다.
MCP 서버 활성화
빠르게 시작하려면 플랜 유형에 따라 다음 단계를 따르세요.
Free, Starter, Business 및 Educational 플랜
- MCP는 기본적으로 활성화되어 있어 별도 가입이나 승인이 필요 없습니다.
- MCP 클라이언트를 통해 직접 설치하고 인증하세요.
Enterprise 플랜
- 먼저 조직에 대해 Miro MCP를 활성화하도록 관리자에게 요청하세요.
- 관리자는 MCP 접근을 특정 팀과 사용자 그룹으로 제한할 수 있습니다. 그럴 경우 선택된 팀의 구성원이어야 하며 사용자 그룹이 설정된 경우 허용된 사용자 그룹에도 속해 있어야 합니다.
- 관리자가 활성화하면 MCP 클라이언트를 통해 연결할 수 있습니다.
- 관리자가 Claude에 대해 엔터프라이즈 관리형 권한 부여를 설정한 경우 Claude는 일반적인 Miro OAuth 흐름 대신 회사의 ID 공급자를 통해 연결됩니다. 이 경우에도 관리자에게서 EMA에 대해 선택된 기본 팀의 구성원이어야 합니다.
Enterprise 플랜에서는 관리자가 MCP를 활성화하지 않았거나, 팀 및 사용자 그룹 접근 제어에 사용자를 포함하지 않았거나, 특정 클라이언트를 허용하지 않은 경우 연결이 실패할 수 있습니다. 연결할 수 없는 경우 관리자에게 문의하세요.
Miro의 MCP 서버 권한 부여
대부분의 MCP 클라이언트는 OAuth로 권한을 부여합니다:
- 사용 중인 AI 도구를 엽니다. 예: Lovable에서는 설정 > 통합 > Miro MCP Server > 연결.
- OAuth 인증 흐름을 따르세요.
- 보드가 있는 팀을 선택하세요.
Miro의 MCP 서버는 OAuth 흐름 중 선택한 팀의 보드만 읽을 수 있습니다.
Enterprise 플랜에서는 관리자가 Claude에 대해 엔터프라이즈 관리형 권한 부여를 설정한 경우 Claude 사용자는 이 Miro OAuth 흐름을 완료하지 않습니다. 접근은 ID 공급자와 관리자 콘솔에 구성된 기본 팀에서 처리됩니다. 자세한 내용은 Miro MCP용 엔터프라이즈 관리형 권한 부여 설정을 참조하세요.
Miro의 MCP 서버를 AI 도구에 연결하기
Miro의 MCP 서버가 조직이나 팀에서 활성화되면 선호하는 MCP 클라이언트에서 구성할 수 있습니다.
간편 설치
대부분의 MCP 클라이언트는 간편한 설치 과정을 제공합니다:
- Cursor, VSCode, Lovable 등 AI 도구를 엽니다.
- MCP 또는 통합 설정으로 이동합니다.
- “Miro” 또는 “Add MCP Server”를 찾아 선택합니다.
- 프롬프트가 표시되면
https://mcp.miro.com을 입력합니다. - OAuth 인증 흐름을 완료합니다.
- Miro MCP를 사용하려는 팀을 선택합니다.
보드가 있는 동일한 팀을 선택했는지 확인하세요.
수동 설치
일부 도구는 수동 구성이 필요합니다:
- MCP 클라이언트의 설정 또는 구성 영역을 엽니다.
- MCP 구성 섹션을 찾습니다.
- 다음 JSON 구성을 추가합니다:
{
"mcpServers": {
"miro-mcp": {
"url": "https://mcp.miro.com/",
"disabled": false,
"autoApprove": []
}
}
}
- 변경 사항을 저장하고 OAuth 흐름을 통해 인증합니다.
MCP 활성 여부 확인
MCP를 활성화한 후 다음으로 작동 여부를 확인할 수 있습니다:
- Cursor나 VSCode 같은 MCP 호환 도구로 연결을 시도합니다.
- OAuth 인증 흐름을 따릅니다.
- Miro MCP 기능을 사용하는 간단한 프롬프트를 테스트합니다.
일부 MCP 클라이언트는 해당 서비스에 대한 추가 인증을 요구할 수 있습니다.
도구별 가이드
특정 도구에 대한 자세한 설치 지침은 개발자 문서를 참조하세요: