BrandKity MCP

Crea kits de marca completos con un solo prompt.

GitHub
2
Prueba este MCPPatrocinado

Documentación

@brandkity/mcp — BrandKity Servidor MCP

Servidor Model Context Protocol para BrandKity — crea y gestiona brand kits desde cualquier agente de IA (Claude Desktop, Cursor, Windsurf o cualquier cliente compatible con MCP).

Versión actual: 1.4.3 — MCP ahora disponible en los planes Starter, Pro y Agency

Inicio rápido

1. Obtén una clave de API

  1. Inicia sesión en brandkity.com
  2. Ve a Configuración → Claves de API
  3. Haz clic en Generar nueva clave y copia la clave (bk_live_...)

Disponible en los planes Starter, Pro y Agency. Regístrate gratis para explorar y luego actualiza a Starter o superior para ejecutar llamadas de herramientas.

2. Configura tu cliente de IA

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "brandkity": {
      "command": "npx",
      "args": ["-y", "@brandkity/mcp"],
      "env": {
        "BRANDKITY_API_KEY": "bk_live_your_key_here"
      }
    }
  }
}

Cursor

Edita .cursor/mcp.json:

{
  "mcpServers": {
    "brandkity": {
      "command": "npx",
      "args": ["-y", "@brandkity/mcp"],
      "env": {
        "BRANDKITY_API_KEY": "bk_live_your_key_here"
      }
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brandkity": {
      "command": "npx",
      "args": ["-y", "@brandkity/mcp"],
      "env": {
        "BRANDKITY_API_KEY": "bk_live_your_key_here"
      }
    }
  }
}

3. Úsalo

Una vez configurado, pide a tu agente de IA que cree un brand kit:

"Crea un brand kit para Acme Corp con el color de acento #E55B00. Añade un bloque de Colores con la paleta primaria (Orange Flame #E55B00, Midnight #1A1A2E, Canvas #FAF9F7) y un bloque de Tipografía con Inter para los encabezados y DM Sans para el cuerpo. Sube los logotipos desde /Users/me/acme/logos/."

Herramientas disponibles (22)

HerramientaDescripción
Espacio de trabajo
get_workspaceObtén información del espacio de trabajo (plan, número de kits, almacenamiento)
Archivos
upload_fileSube cualquier archivo local al almacenamiento del espacio de trabajo → devuelve una URL pública
list_filesLista los archivos del espacio de trabajo con filtro por tipo y paginación
Kits
list_kitsLista todos los brand kits (filtra por borrador/publicados/todos)
create_kitCrea un nuevo kit → devuelve kit_id
get_kitObtén un kit con todos los bloques y contenido
update_kitActualiza la configuración del kit (nombre, color, plantilla, logo_url, cover_image_url, campos de marca blanca)
publish_kitPublica un kit → devuelve una URL pública
unpublish_kitDespublica un kit (vuelve a borrador)
Bloques
list_blocksLista todos los bloques de un kit con sus IDs y tipos
ensure_blockIdempotente — devuelve el block_id existente o crea un nuevo bloque (preferido sobre add_block)
add_blockAñade un bloque incondicionalmente (usa ensure_block en su lugar para evitar duplicados)
update_blockActualiza el nombre/visibilidad del bloque
delete_blockElimina permanentemente un bloque y todo su contenido
Contenido
add_colorsAñade muestras de color a un bloque de Colores
add_typographyAñade entradas de fuentes a un bloque de Tipografía
set_brand_storyEstablece contenido de texto enriquecido (historia de la marca, tono de voz)
set_block_noteEstablece la nota editorial que se muestra encima de cualquier bloque
Subida
upload_assetSube un archivo local a un bloque (logotipos, imágenes, vídeos, etc.) con reintento automático
upload_assets_batchSube varios archivos locales al mismo bloque; deduplica por ruta de archivo
upload_kit_logoSube y establece el logotipo de cabecera del kit
upload_cover_imageSube y establece la imagen de portada del kit

Marca blanca (función Pro+)

Personaliza tu portal con un favicon personalizado, imagen para compartir en redes sociales y metadatos SEO:

// Upload custom assets
const faviconUrl = await client.uploadFile('favicon.ico', faviconBuffer);
const ogImageUrl = await client.uploadFile('og-image.png', ogImageBuffer);

// Apply white-label branding
await client.updateKit('kit-id', {
  og_title: 'Acme Corp Brand Guidelines',
  og_description: 'Official brand assets and standards',
  custom_favicon_url: faviconUrl,
  og_image_url: ogImageUrl,
});

Campos:

  • og_title (cadena, máx. 100 caracteres) — título SEO para compartir en redes sociales
  • og_description (cadena, máx. 300 caracteres) — descripción SEO
  • custom_favicon_url (cadena) — URL de CDN para el favicon (ICO/PNG/SVG)
  • og_image_url (cadena) — URL de CDN para la imagen de compartir en redes sociales (1200×630 px recomendado)

Requisitos del plan:

  • Gratis: los campos de marca blanca son de solo lectura; las llamadas a herramientas MCP devuelven 403
  • Starter/Pro/Agency: acceso MCP completo; los campos de marca blanca son de lectura-escritura en Pro/Agency

Variables de entorno

VariableObligatoriaPredeterminadoDescripción
BRANDKITY_API_KEYSí—Token de acceso personal (bk_live_...)
BRANDKITY_API_URLNohttps://brandkity.comURL base de la API (para desarrollo local)

Flujo de trabajo típico

1. get_workspace       → verify connection, check plan and storage
2. list_kits           → confirm kit doesn't already exist
3. create_kit          → returns kit_id
4. ensure_block        → idempotent: returns existing block_id or creates a new one (for each block type)
5. add_colors          → populate the Colors block
6. add_typography      → populate the Typography block
7. upload_file         → upload font/logo/cover files to workspace storage
8. upload_asset        → upload logos, images, videos into blocks
9. set_brand_story     → write the brand story in a rich_text block
10. set_block_note     → add usage guidance to any block
11. publish_kit        → make the portal live

Notas de fiabilidad (v1.4.0)

  • Sin bloques duplicados — ensure_block es idempotente. Volver a ejecutar un flujo de trabajo nunca crea bloques duplicados.
  • Reintento automático en subidas — upload_asset y upload_file reintentan hasta 3 veces ante errores de red con retroceso exponencial.
  • Tiempos de espera según el tamaño — El tiempo de espera de subida se escala con el tamaño del archivo (60 s base + 20 s por cada 10 MB, máx. 10 min). Los archivos grandes, como vídeos de 64 MB, se gestionan de forma fiable.
  • Deduplicación por lotes — upload_assets_batch omite silenciosamente las entradas file_path duplicadas para que el mismo archivo nunca se suba dos veces en un mismo lote.
  • Instrucciones para agentes — El servidor ahora proporciona reglas de funcionamiento a los clientes de IA en el momento de la conexión, reduciendo automáticamente las operaciones duplicadas de los agentes de IA.
  • Resolución de URL de marca blanca — Las URL de CDN en los campos de marca blanca se resuelven automáticamente a IDs de recursos en el servidor; los agentes no necesitan gestionar los IDs de recursos directamente.
  • Seguimiento de almacenamiento — Todas las subidas de archivos se registran por espacio de trabajo para un control preciso de la cuota.

Licencia

MIT