Miro

Servidor MCP Miro

Servidor Model Context Protocol (MCP) que se integra à plataforma Miro. Ele permite que assistentes de IA (como o Claude) acessem quadros do Miro e gerenciem seu conteúdo por meio de uma interface padronizada.

---

Requisitos

• Node.js v16 ou superior instalado
• Conta Miro com token de API

Gerar Token de Acesso do Miro

1. Acesse o Portal do Desenvolvedor Miro
2. Crie um novo aplicativo ou use um existente
3. Certifique-se de criar o token com as permissões selecionadas abaixo
4. Gere o token OAuth selecionando Install app and get OAuth token

Permissão	Obrigatória
boards:read	✅
boards:write	✅
identity:read	✅
identity:write	✅
team:read	✅
team:write	✅
microphone:listen	❌
screen:record	❌
webcam:record	❌
auditlogs:read	❌
sessions:delete	❌

Conectando ao Claude Desktop

1. Instale o Claude Desktop

2. Abra ou crie o arquivo de configuração:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Atualize-o para incluir este servidor:

{
   "mcpServers":{
      "miro":{
         "command":"npx",
         "args":[
            "-y",
            "@k-jarzyna/mcp-miro"
         ],
         "env":{
            "MIRO_ACCESS_TOKEN":"your_miro_access_token"
         }
      }
   }
}

4. Reinicie o Claude Desktop

---

Ferramentas e Recursos Disponíveis

Ferramentas

Função do SDK Miro	Ferramenta MCP	Disponível
List boards	list-boards	✅
Create board	create-board	✅
Update board	update-board	✅
Delete board	delete-board	✅
Copy board	copy-board	✅
Get specific board	get-specific-board	✅
Get items on board	get-items-on-board	✅
Get specific item	get-specific-item	✅
Update item position	update-item-position	✅
Delete item	delete-item	✅
Create app card item	create-app-card-item	✅
Get app card item	get-app-card-item	✅
Update app card item	update-app-card-item	✅
Delete app card item	delete-app-card-item	✅
Create card item	create-card-item	✅
Get card item	get-card-item	✅
Update card item	update-card-item	✅
Delete card item	delete-card-item	✅
Create connector	create-connector	✅
Get connectors	get-connectors	✅
Get specific connector	get-specific-connector	✅
Update connector	update-connector	✅
Delete connector	delete-connector	✅
Create sticky note item	create-sticky-note-item	✅
Get sticky note item	get-sticky-note-item	✅
Update sticky note item	update-sticky-note-item	✅
Delete sticky note item	delete-sticky-note-item	✅
Create frame	create-frame	✅
Get frame item	get-frame-item	✅
Update frame item	update-frame-item	✅
Delete frame item	delete-frame-item	✅
Create document item	create-document-item	✅
Get document item	get-document-item	✅
Update document item	update-document-item	✅
Delete document item	delete-document-item	✅
Create text item	create-text-item	✅
Get text item	get-text-item	✅
Update text item	update-text-item	✅
Delete text item	delete-text-item	✅
Create items in bulk	create-items-in-bulk	✅
Create image item using URL	create-image-item-using-url	✅
Create image item using file	create-image-item-using-file	✅
Get image item	get-image-item	✅
Update image item	update-image-item	✅
Update image item using file	update-image-item-using-file	✅
Delete image item	delete-image-item	✅
Create shape item	create-shape-item	✅
Get shape item	get-shape-item	✅
Update shape item	update-shape-item	✅
Delete shape item	delete-shape-item	✅
Create embed item	create-embed-item	✅
Get embed item	get-embed-item	✅
Update embed item	update-embed-item	✅
Delete embed item	delete-embed-item	✅
Create tag	create-tag	✅
Get tag	get-tag	✅
Get all tags	get-all-tags	✅
Update tag	update-tag	✅
Delete tag	delete-tag	✅
Attach tag	attach-tag	✅
Detach tag	detach-tag	✅
Get item tags	get-item-tags	✅
Get all board members	get-all-board-members	✅
Get specific board member	get-specific-board-member	✅
Remove board member	remove-board-member	✅
Share board	share-board	✅
Update board member	update-board-member	✅
Create group	create-group	✅
Get all groups	get-all-groups	✅
Get group	get-group	✅
Get group items	get-group-items	✅
Update group	update-group	✅
Ungroup items	ungroup-items	✅
Delete group	delete-group	✅
Create items in bulk using file	create-items-in-bulk-using-file	✅
Create mindmap node	create-mindmap-node	✅
Get mindmap node	get-mindmap-node	✅
Get mindmap nodes	get-mindmap-nodes	✅
Delete mindmap node	delete-mindmap-node	✅
Add project member	add-project-member	✅
Create board export job	create-board-export-job	✅
Get all cases	get-all-cases	✅
Get all legal holds	get-all-legal-holds	✅
Get audit logs	get-audit-logs	✅
Get board classification	get-board-classification	✅
Get board content logs	get-board-content-logs	✅
Get board export job results	get-board-export-job-results	✅
Get board export job status	get-board-export-job-status	✅
Get case	get-case	✅
Get legal hold	get-legal-hold	✅
Get legal hold content items	get-legal-hold-content-items	✅
Get organization info	get-organization-info	✅
Get organization member	get-organization-member	✅
Get organization members	get-organization-members	✅
Get project member	get-project-member	✅
Remove project member	remove-project-member	✅
Update board classification	update-board-classification	✅

---

Desenvolvimento Local

1. Instale as dependências:

npm install

2. Crie um arquivo .env com base no modelo:

cp .env.template .env

3. Edite o arquivo .env e adicione seu token de acesso do Miro

4. Compile o servidor:

npm run build

Executando o Servidor

Para executar o servidor:

node build/index.js

---

Licença

Apache License 2.0

Este projeto está licenciado sob a Apache License, Versão 2.0. Consulte o arquivo LICENSE para obter detalhes.