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

Skip to main content

Servidor MCP Muse

13 de outubro de 2026 (14 de outubro de 2026)

Independent third-party service, see Legal

Sumário

  1. Endpoint e autorização
  2. Configuração
  3. Ferramentas
  4. Trabalhos de longa duração
  5. Exemplos de prompts
  6. 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

FerramentaO que fazParâmetros principais
muse_list_accountsLista suas contas Muse com saúde, maxJobs e uso semanal.
muse_get_accountLê uma conta com seu uso semanal ao vivo.email
muse_update_accountDefine maxJobs, os trabalhos de imagem e vídeo que uma conta executa por vez. Não faz login.email, maxJobs
muse_reset_accountRedefine 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_approvalsLista as solicitações de permissão do agente em todas as conversas, pendentes e decididas.email, status, limit
muse_get_permissionsLê se o agente pergunta antes de agir em sites e aplicativos conectados, e as regras permanentes.email
muse_set_permission_defaultsDefine web e connectors como auto_allow ou always_ask.email, web, connectors
muse_set_permission_ruleAltera uma regra para allow, ask ou deny.permissionId, mode
muse_delete_permission_ruleRemove uma regra.permissionId

Imagens e vídeos

FerramentaO que fazParâmetros principais
muse_generate_imageCria uma imagem a partir de um prompt, opcionalmente a partir de até 9 imagens de entrada.prompt, image_1..image_9, email
muse_generate_videoCria 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_jobLê um trabalho e, com wait: true, espera ele terminar.jobid, wait, history
muse_list_jobsLista 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

FerramentaO que fazParâmetros principais
muse_chatEnvia 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_chatLê uma conversa. Com wait: true, acompanha a resposta em andamento e retorna o restante.chatId, wait, after, limit, before
muse_list_chatsLista as conversas da conta, das mais recentes para as mais antigas.email, limit, cursor
muse_delete_chatExclui uma conversa. Os arquivos dela permanecem.chatId
muse_cancel_chatInterrompe a resposta em que o Muse está trabalhando.chatId
muse_list_streamsLista os fluxos de conversa abertos em uma conta contra seu limite.email
muse_answer_approvalResponde 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_widgetResponde 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

FerramentaO que fazParâmetros principais
muse_get_browserLê 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_viewerRetorna 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_viewersEncerra todas as visualizações ao vivo do navegador.chatId, taskId
muse_release_browserDevolve o controle do navegador ao agente.chatId, taskId
muse_stop_browserFecha o navegador.chatId, taskId

Veja o Guia do Navegador ao Vivo.

Biblioteca

FerramentaO que fazParâmetros principais
muse_list_assetsLista 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_assetEnvia um arquivo de imagem, vídeo ou áudio de uma URL https pública, até 50 MB.url, email
muse_get_assetRetorna 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_assetExclui um item da Biblioteca: um arquivo de mídia, um documento, um web app ou um podcast.assetId
muse_share_web_appPublica um web app em um link público. O Muse o revisa primeiro e pode recusar, listando os problemas encontrados.assetId
muse_unshare_web_appPara de compartilhar um web app. O app permanece na Biblioteca.assetId

Arquivos do workspace

FerramentaO que fazParâmetros principais
muse_list_filesLista uma pasta do workspace da conta, ou um arquivo.email, path
muse_search_filesEncontra arquivos por parte do nome e/ou extensão.name, extensions, path, limit, offset
muse_read_fileRetorna 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_fileEscreve um arquivo no workspace, como texto ou base64, para o agente usar em uma conversa.path, content ou contentBase64, contentType
muse_delete_fileExclui 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_video então retorna o jobid, e muse_get_job com wait: true o retoma.
  • Uma resposta de conversa ainda em andamento retorna seu chatId com status: "running" e um lastEventId. muse_get_chat com wait: true e after definidos para esse lastEventId retorna 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 maxJobs para 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-26 ou 2024-11-05.
  • Cada chamada de ferramenta aparece nas suas estatísticas de uso ( bot=muse) como modelo muse-mcp, com o nome da ferramenta como status, ou failed.

Tutoriais para a Muse API v1:

{ "@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" } ] }