Meta Muse MCP Server by useapi.net
Agente de chat do Meta Muse (muse.ai) com navegador ao vivo, imagens, vídeos com som e sua Biblioteca. De terceiros, pago (US$ 15/mês), funciona na sua própria conta Muse.
Servidor MCP hospedado
npx add-mcp 'https://api.useapi.net/v1/muse/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP Muse
13 de outubro de 2026 (14 de outubro de 2026)
Sumário
- Endpoint e autorização
- Configuração
- Ferramentas
- Trabalhos de longa duração
- Exemplos de prompts
- Limites e observações
O servidor MCP Muse da useapi.net permite que um assistente de IA como Claude Code, Cursor ou VS Code Copilot use o Muse, o agente de IA da Meta, na sua própria conta Muse. É um servidor Model Context Protocol hospedado com 37 ferramentas: gerar imagens e vídeos, conversar com o agente Muse, responder às suas solicitações de permissão, abrir uma visualização ao vivo do navegador dele, gerenciar a Biblioteca e os arquivos da conta e redefinir a conta. Cada ferramenta chama a API Muse, então as mesmas regras, limites e cota se aplicam. Nada precisa ser instalado ou hospedado.
Existe um servidor MCP Muse? Sim. A useapi.net, um serviço de terceiros não afiliado à Meta, hospeda um em https://api.useapi.net/v1/muse/mcp com 37 ferramentas para imagens, vídeos, conversas, navegador do agente e Biblioteca do Muse, na sua própria conta Muse, sem necessidade de instalação.
Prefere REST? Tutorial: Como gerar vídeos e imagens de IA com a API Meta Muse · Código: github.com/useapi/muse-api
Veja todos os servidores MCP da useapi.net em Model Matrix & MCP.
Endpoint e autorização
https://api.useapi.net/v1/muse/mcp
- Transporte: HTTP Streamable.
- Listado no Registro MCP oficial como
net.useapi/muse, então clientes e diretórios MCP que leem o registro podem encontrá-lo por esse nome. - Autorização: seu token de API da useapi.net no cabeçalho
Authorization: Bearer …, veja Configurar useapi.net. - Você precisa de pelo menos uma conta Muse adicionada com Configurar Muse. Adicionar e remover contas não está disponível via MCP: use POST /accounts ou a página Configurar Muse.
Configuração
Substitua YOUR_API_TOKEN pelo seu token de API da useapi.net.
Claude Code
claude mcp add --transport http useapi-muse https://api.useapi.net/v1/muse/mcp --header "Authorization: Bearer YOUR_API_TOKEN"
Cursor
Em ~/.cursor/mcp.json:
{
"mcpServers": {
"useapi-muse": {
"url": "https://api.useapi.net/v1/muse/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
VS Code
Em .vscode/mcp.json:
{
"servers": {
"useapi-muse": {
"type": "http",
"url": "https://api.useapi.net/v1/muse/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Windsurf e outros clientes
Qualquer cliente que suporte servidores MCP remotos via HTTP com cabeçalhos personalizados funciona. A estrutura JSON usual:
{
"mcpServers": {
"useapi-muse": {
"serverUrl": "https://api.useapi.net/v1/muse/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Alguns clientes nomeiam o campo de endereço como url em vez de serverUrl.
Teste com curl
curl -s https://api.useapi.net/v1/muse/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
curl -s https://api.useapi.net/v1/muse/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
A primeira chamada responde com o nome do servidor useapi-muse e suas instruções para o assistente, a segunda com as 37 ferramentas.
Ferramentas
A maioria das ferramentas aceita um email opcional, a conta Muse a ser usada. Pode ser omitido quando o token de API tem uma única conta Muse.
Contas e permissões
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_list_accounts | Lista suas contas Muse com saúde, maxJobs e uso semanal. | |
muse_get_account | Lê uma conta com seu uso semanal ao vivo. | email |
muse_update_account | Define maxJobs, os trabalhos de imagem e vídeo que uma conta executa por vez. Não faz login. | email, maxJobs |
muse_reset_account | Redefine a conta para um computador de agente novo, excluindo tudo nele. Em duas etapas: sem confirm retorna apenas o aviso para você ver, e redefine somente quando chamada novamente com confirm definido como o e-mail da conta que você digitou. | email, confirm |
muse_list_approvals | Lista as solicitações de permissão do agente em todas as conversas, pendentes e decididas. | email, status, limit |
muse_get_permissions | Lê se o agente pergunta antes de agir em sites e aplicativos conectados, e as regras permanentes. | email |
muse_set_permission_defaults | Define web e connectors como auto_allow ou always_ask. | email, web, connectors |
muse_set_permission_rule | Altera uma regra para allow, ask ou deny. | permissionId, mode |
muse_delete_permission_rule | Remove uma regra. | permissionId |
Imagens e vídeos
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_generate_image | Cria uma imagem a partir de um prompt, opcionalmente a partir de até 9 imagens de entrada. | prompt, image_1..image_9, email |
muse_generate_video | Cria um vídeo de cerca de 10 segundos com som, a partir de um prompt e imagens, vídeos e áudio de entrada opcionais. | prompt, image_1..image_9, video_1..video_3, audio_1..audio_3 |
muse_get_job | Lê um trabalho e, com wait: true, espera ele terminar. | jobid, wait, history |
muse_list_jobs | Lista os trabalhos em execução agora. |
As ferramentas de trabalho também aceitam replyRef, sua própria referência ecoada no registro do trabalho.
Conversa
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_chat | Envia uma mensagem ao agente Muse e retorna a resposta: texto, arquivos, widgets e solicitações de permissão. Sem chatId, inicia uma nova conversa. | message, chatId, files, email |
muse_get_chat | Lê uma conversa. Com wait: true, acompanha a resposta em andamento e retorna o restante. | chatId, wait, after, limit, before |
muse_list_chats | Lista as conversas da conta, das mais recentes para as mais antigas. | email, limit, cursor |
muse_delete_chat | Exclui uma conversa. Os arquivos dela permanecem. | chatId |
muse_cancel_chat | Interrompe a resposta em que o Muse está trabalhando. | chatId |
muse_list_streams | Lista os fluxos de conversa abertos em uma conta contra seu limite. | email |
muse_answer_approval | Responde a uma solicitação de permissão com allow_once, allow_always ou deny, depois acompanha a conversa e retorna a resposta junto com a continuação do agente. | chatId, approvalId, decision, wait |
muse_answer_widget | Responde a um widget de resposta rápida com um índice de opção ou seu próprio texto, depois acompanha a resposta. | chatId, widgetId, option ou text, wait |
Navegador do agente
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_get_browser | Lê um navegador que o agente abriu em uma conversa: status, página, quem tem controle e se pode ser assistido. | chatId, taskId |
muse_open_browser_viewer | Retorna um link de uso único para uma visualização ao vivo do navegador, para assistir ou assumir o controle. | chatId, taskId, mode, ttl, quality, compression |
muse_revoke_browser_viewers | Encerra todas as visualizações ao vivo do navegador. | chatId, taskId |
muse_release_browser | Devolve o controle do navegador ao agente. | chatId, taskId |
muse_stop_browser | Fecha o navegador. | chatId, taskId |
Veja o Guia do Navegador ao Vivo.
Biblioteca
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_list_assets | Lista toda a Biblioteca da conta, das mais recentes para as mais antigas: imagens e vídeos e áudio, documentos, web apps (com shareUrl quando publicados) e podcasts. Informa quando a lista pode estar incompleta. | email, type, origin, limit, cursor |
muse_upload_asset | Envia um arquivo de imagem, vídeo ou áudio de uma URL https pública, até 50 MB. | url, email |
muse_get_asset | Retorna uma imagem de até cerca de 1 MB como imagem, um documento de texto ou web app de até 256 KB como texto, ou então o tipo, tamanho e URL de download do arquivo. part=cover dá a capa de um podcast, format=pdf um documento como PDF. | assetId, part, format |
muse_delete_asset | Exclui um item da Biblioteca: um arquivo de mídia, um documento, um web app ou um podcast. | assetId |
muse_share_web_app | Publica um web app em um link público. O Muse o revisa primeiro e pode recusar, listando os problemas encontrados. | assetId |
muse_unshare_web_app | Para de compartilhar um web app. O app permanece na Biblioteca. | assetId |
Arquivos do workspace
| Ferramenta | O que faz | Parâmetros principais |
|---|---|---|
muse_list_files | Lista uma pasta do workspace da conta, ou um arquivo. | email, path |
muse_search_files | Encontra arquivos por parte do nome e/ou extensão. | name, extensions, path, limit, offset |
muse_read_file | Retorna um arquivo de texto de até cerca de 200 KB como texto, ou uma imagem de até cerca de 1 MB como imagem. | path |
muse_write_file | Escreve um arquivo no workspace, como texto ou base64, para o agente usar em uma conversa. | path, content ou contentBase64, contentType |
muse_delete_file | Exclui um arquivo. | path |
O esquema completo de entrada de cada ferramenta vem de tools/list.
Trabalhos de longa duração
Clientes MCP geralmente desistem de uma chamada de ferramenta após cerca de um minuto, então uma ferramenta espera até cerca de 50 segundos:
- Uma imagem ou uma resposta curta geralmente termina nesse tempo, e a ferramenta retorna o resultado.
- Um vídeo geralmente leva mais tempo.
muse_generate_videoentão retorna ojobid, emuse_get_jobcomwait: trueo retoma. - Uma resposta de conversa ainda em andamento retorna seu
chatIdcomstatus: "running"e umlastEventId.muse_get_chatcomwait: trueeafterdefinidos para esselastEventIdretorna o restante.
Clientes que pedem notificações de progresso recebem uma a cada cerca de 10 segundos enquanto uma ferramenta espera. Os resultados mostram até duas pequenas imagens como prévias, e cada arquivo vem com seu assetId e URL de download.
Quando uma resposta de conversa retorna status: "waiting_for_approval", o agente espera sua permissão: o assistente deve perguntar a você, depois responder com muse_answer_approval.
muse_reset_account nunca redefine na primeira chamada. Retorna um aviso para o assistente mostrar a você, e redefine somente quando você digita o e-mail da conta e o assistente chama novamente com esse e-mail como confirm. Se a chamada de redefinição der erro ou expirar, ela pode ter sido executada: verifique a conta antes de chamar novamente.
Exemplos de prompts
- "Crie um vídeo de 10 segundos de um corgi surfando ao pôr do sol, exatamente na proporção 9:16."
- "Crie uma imagem de uma motocicleta vintage em paralelepípedos molhados à noite e depois anime-a em um vídeo."
- "Peça ao Muse para pesquisar os 5 melhores carros elétricos de 2026, escrever uma tabela comparativa como CSV e me dar os arquivos."
- "Envie esta foto da URL dela e restaure e colorize."
- "Liste minhas conversas do Muse e continue a mais recente: peça uma versão mais curta."
- "Peça ao Muse para abrir example.com no navegador dele e depois me dê um link de visualização ao vivo para eu assumir o controle."
- "Liste os web apps na minha Biblioteca do Muse e publique o mais recente."
Limites e observações
- As ferramentas usam sua conta Muse, sua cota semanal do Muse e as mesmas regras da API REST, como
maxJobspara trabalhos. - Antes de algumas ações, como acessar um site ou agir em um aplicativo conectado, o agente pede permissão. Veja GET /accounts/
email/permissions para alterar quando ele pergunta. - Conectores personalizados no claude.ai exigem login OAuth, que este servidor ainda não suporta. Use o Claude Code ou outro cliente que possa enviar um cabeçalho
Authorization. - Um cliente pode enviar até 20 solicitações JSON-RPC em um único lote.
- Se o cliente enviar um cabeçalho
MCP-Protocol-Version, ele deve ser uma das versões suportadas:2025-06-18,2025-03-26ou2024-11-05. - Cada chamada de ferramenta aparece nas suas estatísticas de uso (
bot=muse) como modelomuse-mcp, com o nome da ferramenta como status, oufailed.
Tutoriais para a Muse API v1:
- Existe uma API de Vídeo Meta Muse? API oficial, ferramentas gratuitas e uma API hospedada, comparadas
- Como Gerar Vídeos e Imagens com IA usando a API Meta Muse
- Tutorial em chinês (中文教程): imagens e vídeos com IA com diálogo
{ "@context": "https://schema.org", "@type": "APIReference", "name": "Muse MCP Server: Meta Muse Video, Images and Chat, Hosted", "url": "https://useapi.net/docs/api-muse-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net Muse MCP server: 37 tools for Muse images, videos, chat, the agent's browser and the Library.", "about": "Muse API v1", "isPartOf": { "@type": "APIReference", "name": "Muse API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "Muse API v1", "item": "https://useapi.net/docs/api-muse-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-muse-v1/mcp" } ] }