El servidor MCP

Autenticación

Cada solicitud lleva un token Bearer. Se admiten dos tipos:

• Clave API

  Crea una clave en tu panel y envíala como Authorization: Bearer fb_live_…. Las claves se muestran una sola vez; se guarda únicamente su hash.

• OAuth de Clerk (si está configurado)

  Los clientes compatibles con OAuth descubren el servidor de autorización en /.well-known/oauth-protected-resource y realizan la autenticación interactiva sin introducir una clave manual.

Conectar

claude mcp add --transport http fieldbook https://fieldbook.lizardi.mx/api/mcp --header "Authorization: Bearer <YOUR_KEY>"

{
  "mcpServers": {
    "fieldbook": {
      "url": "https://fieldbook.lizardi.mx/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

npx @modelcontextprotocol/inspector

Herramientas

Las herramientas medidas consumen créditos de tu asignación mensual. El plan del propietario no tiene medición. Las demás consultas son gratuitas y tienen límites por clave.

Elige una ficha. Cada componente tiene un número de ficha de cuatro dígitos. Explora el catálogo y entrega ese número a tu agente. Las herramientas de componentes aceptan plate en lugar de slug, y formatos como 0412, #412 o FB-0412 también funcionan. Cada página permite copiar el identificador y una instrucción lista para pegar.

• search_componentsGratuito

  query?, category?, framework?, maxSlopScore?, limit (max 25)

  Busca en la biblioteca y devuelve resúmenes con frameworks probados, puntuación, ficha, cantidad de controles y comandos de instalación.

• get_component1 crédito

  slug or plate, framework (default react)

  Obtiene el código para un framework. React devuelve el componente y su demo; las demás versiones devuelven un archivo. Incluye controles, dependencias, evaluaciones e instalación.

• list_frameworksGratuito

  slug or plate

  Indica los frameworks disponibles y las versiones pendientes de un componente.

• get_install_commandGratuito

  slug or plate, framework (default react)

  Comando de instalación, URL del registro y fragmento de components.json.

• get_design_guidanceGratuito

  query?, domain?, stack?, productType?, limit?

  Busca en la biblioteca de orientación de diseño.

• generate_design_system2 créditos

  productType, keywords?, stack?, variance?, motion?, density?

  Genera un sistema de diseño con paleta, tipografía, composición, movimiento, reglas de UX y verificaciones.

• get_slop_rulesGratuito

  category?

  Devuelve las reglas versionadas: número, título, severidad, fallo crítico y justificación.

• get_font_guidanceGratuito

  role?, family?, name?

  Explica el aspecto y comportamiento de las tipografías recomendadas, sus combinaciones y criterios.

• suggest_alternativesGratuito

  ruleId

  Alternativas para un patrón y su catálogo de referencias.

• score_pageGratuito

  html? | url?

  Evalúa una página con las reglas; las URLs se consultan con protección SSRF.

Registro

La biblioteca ofrece un registro de componentes: instala uno directamente o configura el registro en components.json e instala con @fieldbook/<name>. Configura FIELDBOOK_TOKEN para las consultas que consumen créditos.

{
  "registries": {
    "@fieldbook": {
      "url": "https://fieldbook.lizardi.mx/r/react/{name}.json",
      "headers": {
        "Authorization": "Bearer ${FIELDBOOK_TOKEN}"
      }
    }
  }
}