Miro MCP 서버 개요

실행 가능한 사용자: 모든 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 서버 + 클라이언트

MCP는 기반 인프라를 제공하고, MCP 클라이언트는 특정 AI 도구와 연결되는 통합입니다:

• MCP 서버: Miro와 외부 AI 도구 간의 통신을 가능하게 하는 보안 게이트웨이입니다.
• MCP 클라이언트: 특정 AI 도구(예: Claude, Cursor, VSCode 또는 Lovable)를 Miro에 연결하는 구현입니다.
• OAuth 2.1 보안: Enterprise급 인증으로 콘텐츠에 대한 안전한 접근을 보장합니다.

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

작동 방식

1. 연결:
   1. Enterprise 플랜에서는 관리자가 조직 또는 팀에 대해 Miro MCP를 활성화합니다.
   2. 다른 모든 플랜에서는 MCP 액세스가 활성화되어 있지만 MCP 클라이언트를 통해 승인해야 합니다(예: Cursor, Claude Code 등).
2. 권한 부여: 사용자는 선호하는 AI 도구를 OAuth를 통해 Miro에 연결합니다.
3. 상호작용: AI 도구는 사용자가 지정한 보드의 내용을 읽고 쓸 수 있습니다.
4. 생성: 사용자는 보드 컨텍스트를 기반으로 다이어그램, 문서, 테이블, 코드 위젯 등 다양한 항목을 생성하도록 AI 도구에 요청할 수 있습니다.

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

MCP 도구

Miro MCP Server는 AI 에이전트가 호출할 수 있는 도구들을 몇 가지 범주로 묶어 제공합니다:

• 보드: 새 보드를 생성하고 접근 가능한 보드를 검색하며, 페이지네이션과 필터로 보드 항목을 읽을 수 있습니다.
• 다이어그램: DSL 설명으로부터 다이어그램을 생성하고 DSL 레이아웃 형식을 읽을 수 있습니다.
• 문서: 보드의 구조화된 문서 항목을 생성하고 읽고 업데이트할 수 있습니다.
• Tables: 정의된 열로 테이블을 생성하고 행을 추가하거나 업데이트합니다.
• Code widgets: 보드에서 코드 위젯을 생성, 조회, 수정 및 삭제합니다.
• Comments: 댓글 스레드를 읽고 답글을 달거나 해결로 표시합니다.
• Images: 이미지를 업로드하고 기존 이미지 항목의 이미지 데이터 또는 다운로드 URL을 가져옵니다.
• Layout: DSL 표현을 사용해 보드 항목을 일괄로 읽고 업데이트하며 레이아웃 형식 사양을 가져옵니다.
• Prototypes: 기존 프로토타입 화면을 읽고 하나 이상의 HTML 화면에서 프로토타입을 생성합니다.

참고: Miro AI 크레딧을 사용하는 항목을 포함한 최신 도구 및 프롬프트 전체 목록은 Miro MCP 도구와 Miro MCP 프롬프트를 확인하세요.

사용 한도

각 Miro 플랜에는 MCP 도구 호출의 일일 할당량이 포함되어 있으며, 이 할당량은 UTC 기준 00:00에 재설정됩니다:

일일 할당량에 도달하면 한도가 초기화될 때까지 추가 MCP 툴 호출이 차단되며 AI 툴은 오류 메시지를 받습니다. Enterprise 관리자는 관리자 설정 > 앱 및 통합 > MCP에서 더 높은 할당량을 요청할 수 있습니다.

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

Miro MCP 둘러보기

• 다음 MCP 개발자 문서를 확인하세요.
• Miro MCP로 할 수 있는 작업을 재미있게 설명하는 YouTube 재생목록을 확인하세요.

추가 정보: 다음 문서를 참조하세요: MCP 클라이언트란 무엇인가 및 Miro MCP Server 활성화 방법(사용자 가이드).