ButterKit

ButterKit expone un servidor Model Context Protocol (MCP) que permite a los agentes de IA controlar ButterKit programáticamente. Usa lenguaje natural en herramientas como Cursor, Claude Code u OpenAI Codex para:

• Diseñar capturas de pantalla a partir de un prompt. Describe el aspecto que deseas y deja que el agente cree mesas de trabajo, aplique plantillas, configure texto y ajuste dispositivos 3D.
• Localizar en masa. Añade idiomas y traduce todas las capturas de pantalla y metadatos de App Store en un solo comando.
• Automatizar tu pipeline de lanzamiento. Integra ButterKit en tu proceso de CI/compilación para que las capturas de pantalla se actualicen, traduzcan y suban a App Store Connect sin trabajo manual.
• Iterar rápido. Pide ajustes de diseño, cambia textos, previsualiza renders y exporta, todo desde tu editor o terminal.

Video Tutoriales

Integración con Claude AI

Integración con OpenAI Codex AI

Integración con Cursor AI

Configura tu Herramienta de IA

Requisitos Previos

• ButterKit v1.8 o posterior debe estar ejecutándose con al menos un documento abierto.
• MCP debe estar habilitado en ButterKit > Configuración > MCP.
• No se necesita instalación adicional. ButterKit tiene un puente MCP en ButterKit.app/Contents/MacOS/butterkit-mcp. Al configurar tu herramienta de IA, apuntarás a esta ruta para que pueda comunicarse con ButterKit.

Cómo Funciona

Tu herramienta de IA se conecta a ButterKit a través de la utilidad de conector MCP y obtiene acceso a 42 herramientas en 5 espacios de nombres: Documento, Diseño, Exportación, Localización y App Store Connect. Describes lo que quieres en lenguaje natural y el agente de IA llama automáticamente a las herramientas adecuadas.

Referencia

• Referencia de Herramientas (las 40 herramientas)
• Flujos de Trabajo (recetas paso a paso)

Auto-Lanzamiento (Opcional)

Por defecto, el asistente butterkit-mcp sale silenciosamente si ButterKit no está ejecutándose. Esto significa que abrir tu herramienta de IA no lanzará inesperadamente ButterKit en segundo plano.

Si prefieres que ButterKit se inicie automáticamente cuando tu agente lo necesite, añade --auto-launch a tu configuración de MCP:

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

Con esta bandera, el asistente abrirá ButterKit y esperará a que esté disponible antes de conectarse. Sin ella, solo necesitas asegurarte de que ButterKit ya esté ejecutándose antes de usar las herramientas MCP.

Notas

• El servidor MCP renderiza mesas de trabajo usando el motor RealityKit de ButterKit. La ventana de la aplicación no necesita estar enfocada, pero la aplicación debe estar ejecutándose.
• Todos los IDs (documentId, artboardId, templateId, etc.) se obtienen de las herramientas de listado correspondientes.
• Los códigos de idioma siguen ISO 639-1 (por ejemplo, "en", "es", "ja"). Los códigos de localización de App Store Connect siguen el formato de Apple (por ejemplo, "en-US", "fr-FR").

Compilaciones de desarrollo: Si estás ejecutando una compilación de desarrollo desde Xcode, reemplaza /Applications/ButterKit.app con la ruta a tu compilación de DerivedData, por ejemplo, ~/Library/Developer/Xcode/DerivedData/ButterKit-*/Build/Products/Debug/ButterKit.app.