Miro MCP Server 개요 – Miro 도움말 센터

누가 할 수 있나요: 모든 Miro 사용자
어떤 플랜: 모든 플랜
어떤 플랫폼: 브라우저, 데스크톱

Miro의 Model Context Protocol(MCP) Server는 AI 도구가 Miro 보드에 연결할 수 있도록 하는 게이트웨이로, 시각적 워크스페이스와 외부 AI 시스템 간의 원활한 상호작용을 가능하게 합니다. 이 강력한 통합을 통해 AI 어시스턴트가 Miro 보드의 내용을 읽고 작성할 수 있어 시각적 협업과 AI 기능을 연결합니다.

Miro MCP Server란?

Miro의 MCP Server는 조직 내 Miro 보드에 AI 도구가 안전하게 접근할 수 있도록 해주는 보안 게이트웨이입니다. 이를 통해 AI 어시스턴트는 다음을 수행할 수 있습니다:

프레임, 문서, 프로토타입, 테이블, 다이어그램을 포함한 Miro 보드의 콘텐츠를 읽고 이해합니다.
보드, 다이어그램, 문서, 테이블, 코드 위젯을 생성하고 업데이트합니다.
코드, 텍스트 설명 또는 풀 리퀘스트를 기반으로 다이어그램을 생성합니다.
시각적 정보를 코드 및 기타 포맷으로 변환합니다.
보드의 댓글 쓰레드를 읽고, 회신하며, 해결 표시합니다.
이미지를 포함해 업로드하고 보드에서 이미지를 가져오는 작업을 수행합니다.

MCP를 서로 다른 AI 시스템이 Miro와 소통할 수 있게 돕는 범용 번역기라고 생각하세요.

MCP Server + Clients

MCP는 기반 인프라를 제공하고, MCP Clients는 특정 AI 도구와의 통합을 의미합니다:

MCP Server: Miro와 외부 AI 도구 간의 통신을 가능하게 하는 보안 게이트웨이입니다.
MCP Clients: Claude, Cursor, VSCode 또는 Lovable과 같은 특정 AI 도구를 Miro에 연결하는 구현체들입니다.
OAuth 2.1 Security: 엔터프라이즈급 인증으로 콘텐츠에 대한 안전한 접근을 보장합니다. Enterprise 플랜에서는 회사 관리자가 enterprise-managed authorization을 활성화해 Claude가 별도의 Miro OAuth 로그인이 아닌 귀사의 ID 공급자를 통해 연결되도록 설정할 수 있습니다.

Enterprise 계정은 사용자가 Miro의 MCP Server를 설치하고 사용하기 전에 관리자의 승인이 필요합니다.

작동 방식

연결:
1. Enterprise 플랜에서는 관리자가 조직에 대해 Miro MCP를 활성화할 수 있으며, 필요에 따라 팀과 사용자 그룹으로 접근을 제한할 수 있습니다.
2. 다른 모든 플랜에서는 MCP 접근이 활성화되어 있지만 MCP Client를 통해 권한 부여가 필요합니다(예: Cursor, Claude Code 등).
권한 부여: 사용자는 선호하는 AI 도구를 OAuth를 통해 Miro에 연결합니다. Enterprise 플랜에서는 관리자가 선택적으로 enterprise-managed authorization을 설정해 Claude 사용자가 ID 공급자를 통해 MCP 접근을 받도록 할 수 있습니다.
상호작용: 그런 다음 AI 도구는 사용자가 지정한 보드에서 읽고 쓸 수 있습니다.
생성: 사용자는 AI 도구에 보드 컨텍스트를 기반으로 다이어그램, 문서, 테이블, 코드 위젯 등을 생성하도록 요청할 수 있습니다.

자세한 기술적 세부사항과 예시는 개발자 문서를 참조하세요.

MCP 도구

Miro의 MCP Server는 AI 에이전트가 호출할 수 있는 도구 집합을 제공하며, 다음과 같은 카테고리로 그룹화됩니다:

보드: 새 보드를 생성하고, 접근 가능한 보드를 검색하며, 페이지네이션과 필터링을 통해 보드의 항목을 읽습니다.
다이어그램: DSL 설명에서 다이어그램을 생성하고 DSL 레이아웃 포맷을 읽습니다.
문서: 보드 위의 구조화된 문서 항목을 생성, 읽기, 업데이트합니다.
테이블: 정의된 열로 테이블(타임라인 및 여정 보기 등 관련 뷰 포함)을 생성하고 행을 추가하거나 업데이트합니다.
코드 위젯: 보드의 코드 위젯을 생성, 읽기, 업데이트 및 삭제합니다.
댓글: 댓글 쓰레드를 읽고 회신하며 해결 표시합니다.
이미지: 이미지를 업로드하고 기존 이미지 항목의 이미지 데이터나 다운로드 URL을 가져옵니다.
레이아웃: DSL 표현식을 사용해 보드 항목을 일괄로 읽고 업데이트하며 레이아웃 포맷 사양을 가져옵니다.
프로토타입: 기존 프로토타입 화면을 읽고 하나 이상의 HTML 화면으로 프로토타입을 생성합니다.

도구와 프롬프트의 전체 최신 목록 및 어떤 도구가 Miro AI 크레딧을 사용하는지 보려면 Miro MCP 도구와 Miro MCP 프롬프트를 확인하세요.

사용량 제한

각 Miro 플랜에는 일일 MCP 도구 호출 할당량이 포함되며, 이는 00:00 UTC에 초기화됩니다:

플랜	일일 MCP 도구 호출 수
Free	100
Starter	500
Business	2,000
Enterprise	10,000

일일 할당량에 도달하면 추가 MCP 도구 호출이 제한되며 AI 도구는 오류 메시지를 받습니다. Enterprise 관리자는 Admin settings > Apps and integrations > MCP에서 더 높은 할당량을 요청할 수 있습니다.

자세한 내용은 Miro MCP 사용량 및 일일 한도 문서를 참조하세요.

Miro MCP 세계 탐색

우리의 MCP 개발자 문서를 확인하세요.
Miro MCP로 할 수 있는 작업을 재미있게 설명한 유튜브 재생목록을 확인하세요.

추가 정보: MCP Clients란 무엇인가, Miro의 MCP Server 활성화 방법(사용자 가이드), 및 Miro MCP용 enterprise-managed authorization 설정을 참조하세요.