Connectez Codex, Claude Code et Cursor à Fieldbook MCP

Authentification

Chaque requête inclut un jeton Bearer. Deux types sont acceptés :

• Clé API (disponible)

  Créez une clé dans votre tableau de bord et envoyez-la sous la forme Authorization: Bearer fb_live_…. Les clés ne sont affichées qu’une fois ; seul un hachage est conservé.

• OAuth Clerk (si configuré)

  Les clients compatibles OAuth découvrent le serveur d’autorisation à partir de /.well-known/oauth-protected-resource et s’authentifient de manière interactive. Aucune clé manuelle n’est nécessaire.

Connecter

Définissez FIELDBOOK_TOKEN dans l’environnement de lancement de l’éditeur ou de l’agent. Les exemples utilisent cette variable ; ne versionnez pas de vraie clé API.

codex mcp add fieldbook --url https://fieldbook.lizardi.mx/api/mcp --bearer-token-env-var FIELDBOOK_TOKEN

{
  "mcpServers": {
    "fieldbook": {
      "type": "http",
      "url": "https://fieldbook.lizardi.mx/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FIELDBOOK_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "fieldbook": {
      "url": "https://fieldbook.lizardi.mx/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FIELDBOOK_TOKEN}"
      }
    }
  }
}

npx @modelcontextprotocol/inspector

Outils

Les outils facturés à l’usage consomment les crédits de votre quota mensuel (le forfait propriétaire est illimité). Le reste est gratuit, avec une limite de fréquence par clé.

Choisissez une fiche. Chaque composant porte un numéro à quatre chiffres, imprimé sur sa fiche et sa page. Parcourez le catalogue, faites votre choix et donnez le numéro à votre agent : tous les outils de composants acceptent plate à la place de slug, et des variantes comme 0412, #412 ou FB-0412 fonctionnent aussi. Chaque page de composant propose un bouton pour copier l’identifiant et une instruction prête à coller.

• search_componentsGratuit

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

  Recherchez des aperçus, niveaux d’accès et frameworks testés dans le catalogue. Les commandes d’installation sont listées pour les composants ouverts et, lorsque votre forfait les inclut, pour les composants membres.

• get_component1 crédit

  slug or plate, framework (default react)

  Récupérez le code et la démonstration d’un composant pour le framework choisi, avec propriétés, dépendances et instructions d’installation. Les composants membres sont inclus dans un abonnement Pro actif ; les autres comptes reçoivent membership_required et ne consomment aucun crédit.

• list_frameworksGratuit

  slug or plate

  Frameworks disponibles pour un composant et versions encore en attente.

• get_install_commandGratuit

  slug or plate, framework (default react)

  Commande d’installation, URL du registre et configuration components.json pour un composant. Les composants membres sont inclus dans un abonnement Pro actif.

• get_design_guidanceGratuit

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

  Rechercher dans le corpus de conseils contre le design générique.

• generate_design_system2 crédits

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

  Générez un système de design personnalisé : palette, typographie, mise en page, mouvement, règles UX et liste de vérification.

• get_slop_rulesGratuit

  category?

  Les règles versionnées : numéro, titre, gravité, échec critique et justification.

• get_font_guidanceGratuit

  role?, family?, name?

  L’apparence et le comportement de chaque police recommandée, avec des associations testées et leurs principes.

• suggest_alternativesGratuit

  ruleId

  Alternatives à un motif générique et catalogue de références associé.

• score_pageGratuit

  html? | url?

  Évalue une page selon les règles (URL récupérée avec une protection SSRF).

Registre

Installez les composants ouverts directement ou avec le registre components.json ci-dessous. Les composants membres sont inclus dans un abonnement Pro actif.

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