ButterKit

ButterKit expõe um servidor Model Context Protocol (MCP) que permite que agentes de IA controlem o ButterKit programaticamente. Use linguagem natural em ferramentas como Cursor, Claude Code ou OpenAI Codex para:

• Criar capturas de tela a partir de um prompt. Descreva a aparência desejada e deixe o agente criar pranchetas, aplicar modelos, definir textos e configurar dispositivos 3D.
• Localizar em massa. Adicione idiomas e traduza todas as capturas de tela e metadados da App Store em um único comando.
• Automatizar seu pipeline de lançamento. Integre o ButterKit ao seu processo de CI/build para que as capturas de tela sejam atualizadas, traduzidas e enviadas ao App Store Connect sem trabalho manual.
• Iterar rapidamente. Peça ajustes de design, troque textos, visualize renderizações e exporte, tudo a partir do seu editor ou terminal.

Tutoriais em Vídeo

Integração com Claude AI

Integração com OpenAI Codex AI

Integração com Cursor AI

Configure Sua Ferramenta de IA

Pré-requisitos

• O ButterKit v1.8 ou posterior deve estar em execução com pelo menos um documento aberto.
• O MCP deve estar habilitado em ButterKit > Configurações > MCP.
• Nenhuma instalação adicional é necessária. O ButterKit possui uma ponte MCP em ButterKit.app/Contents/MacOS/butterkit-mcp. Ao configurar sua ferramenta de IA, você a apontará para esse caminho para que ela possa se comunicar com o ButterKit.

Como Funciona

Sua ferramenta de IA se conecta ao ButterKit por meio do utilitário conector MCP e obtém acesso a 42 ferramentas em 5 namespaces: Documento, Design, Exportação, Localização e App Store Connect. Você descreve o que deseja em linguagem natural, e o agente de IA chama as ferramentas corretas automaticamente.

Referência

• Referência de Ferramentas (todas as 40 ferramentas)
• Fluxos de Trabalho (receitas passo a passo)

Inicialização Automática (Opcional)

Por padrão, o auxiliar butterkit-mcp é encerrado silenciosamente se o ButterKit não estiver em execução. Isso significa que abrir sua ferramenta de IA não iniciará o ButterKit inesperadamente em segundo plano.

Se você preferir que o ButterKit inicie automaticamente sempre que seu agente precisar, adicione --auto-launch à sua configuração MCP:

{
  "mcpServers": {
    "butterkit": {
      "command": "/Applications/ButterKit.app/Contents/MacOS/butterkit-mcp",
      "args": ["--auto-launch"]
    }
  }
}

Com essa flag, o auxiliar abrirá o ButterKit e aguardará até que ele esteja disponível antes de conectar. Sem ela, você só precisa garantir que o ButterKit já esteja em execução antes de usar as ferramentas MCP.

Notas

• O servidor MCP renderiza pranchetas usando o mecanismo RealityKit do ButterKit. A janela do aplicativo não precisa estar em foco, mas o aplicativo deve estar em execução.
• Todos os IDs (documentId, artboardId, templateId, etc.) são obtidos das ferramentas de listagem correspondentes.
• Os códigos de idioma seguem a ISO 639-1 (por exemplo, "en", "es", "ja"). Os códigos de localidade do App Store Connect seguem o formato da Apple (por exemplo, "en-US", "fr-FR").

Builds de desenvolvimento: Se você estiver executando um build de desenvolvimento a partir do Xcode, substitua /Applications/ButterKit.app pelo caminho do seu build DerivedData, por exemplo, ~/Library/Developer/Xcode/DerivedData/ButterKit-*/Build/Products/Debug/ButterKit.app.