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를 Miro와 다양한 AI 시스템이 소통하도록 돕는 범용 번역기로 생각하세요.

MCP 서버 + 클라이언트

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

• MCP Server: Miro와 외부 AI 도구 간의 통신을 가능하게 하는 보안 게이트웨이.
• MCP Clients: Claude, Cursor, VSCode 또는 Lovable 같은 특정 AI 도구를 Miro에 연결하는 개별 구현체.
• OAuth 2.1 Security: Enterprise급 인증으로 콘텐츠에 대한 안전한 접근을 보장합니다.

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

작동 방식

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 레이아웃 형식을 읽을 수 있습니다.
• 문서: 보드의 구조화된 문서 항목을 생성하고 읽고 업데이트할 수 있습니다.
• 테이블: 정의된 열을 가진 테이블을 생성하고 행을 추가하거나 업데이트할 수 있습니다.
• 코드 위젯: 보드에서 코드 위젯을 생성, 읽기, 업데이트 및 삭제할 수 있습니다.
• 댓글: 댓글 스레드를 읽고 답글을 달거나 해결로 표시할 수 있습니다.
• 이미지: 이미지를 업로드하고, 기존 이미지 항목의 이미지 데이터나 다운로드 URL을 가져올 수 있습니다.
• Layout: DSL 표현으로 보드 항목을 일괄 읽고 업데이트하고 레이아웃 형식 사양을 확인합니다.
• Prototypes: 기존 프로토타입 화면을 읽고 하나 이상의 HTML 화면으로부터 프로토타입을 생성합니다.

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

사용 한도

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

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

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

Miro MCP 둘러보기

• 다음 MCP 개발자 문서를 확인하세요.
• Miro MCP로 할 수 있는 작업을 재미있는 튜토리얼로 소개하는 YouTube 재생목록을 확인해보세요.

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