Codex, Claude Code und Cursor mit Fieldbook MCP verbinden

Authentifizierung

Jede Anfrage enthält ein Bearer-Token. Zwei Arten werden unterstützt:

• API-Schlüssel

  Erstelle einen Schlüssel in deiner Übersicht und sende ihn als Authorization: Bearer fb_live_…. Schlüssel werden nur einmal angezeigt; gespeichert wird ausschließlich ihr Hash.

• Clerk OAuth (falls konfiguriert)

  OAuth-fähige Clients ermitteln den Autorisierungsserver über /.well-known/oauth-protected-resource und authentifizieren sich interaktiv ohne manuell eingegebenen Schlüssel.

Verbinden

Setze FIELDBOOK_TOKEN in der Umgebung, aus der du Editor oder Agent startest. Die Beispiele verweisen darauf; speichere keinen echten API-Schlüssel im Repository.

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}"
      }
    }
  }
}

[mcp_servers.fieldbook]
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

Werkzeuge

Die v2-Regeln enthalten level, scopes, clusters, fineWhen und observes. suggest_alternatives löst ausgemusterte Regel-IDs zu vorhandenen Nachfolgern auf. score_page akzeptiert scope page oder section und intent mit ruleId und reason. Der cluster-v2-Bericht enthält flags mit status und points, reviews, hardFails, clusters, declared und changes. Katalogbewertungen behalten ihre eigene rulesetVersion. Anfrageinhalte sind auf 256 KiB begrenzt; verwende url für größere Seiten. Zu große Anfragen erhalten HTTP 413 mit einem JSON-RPC-Fehler.

Gemessene Werkzeuge verbrauchen Guthaben aus deinem monatlichen Kontingent. Der Eigentümertarif ist ungemessen. Andere Abfragen sind kostenlos und pro Konto begrenzt.

Wähle eine Komponente. Jede Komponente hat eine vierstellige Nummer auf ihrer Karte und Seite. Wähle im Katalog und gib deinem Agenten diese Nummer. Die Komponentenwerkzeuge akzeptieren plate anstelle von slug, und Schreibweisen wie 0412, #412 oder FB-0412 funktionieren ebenfalls. Auf jeder Komponentenseite lassen sich der Bezeichner und eine fertige Anweisung kopieren.

• search_componentsKostenlos

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

  Durchsuche den Katalog nach Vorschauen, Zugangsstufen und getesteten Frameworks. Installationsbefehle werden für offene Komponenten angezeigt und, wenn dein Plan sie enthält, für Mitgliederkomponenten.

• get_component1 Guthabenpunkt

  slug or plate, framework (default react)

  Rufe Quellcode und Demo einer Komponente für das gewählte Framework ab, mit Props, Abhängigkeiten und Installationshinweisen. Mitgliederkomponenten sind in einem aktiven Pro-Plan enthalten; andere Konten erhalten membership_required und verbrauchen keine Credits.

• list_frameworksKostenlos

  slug or plate

  Zeigt verfügbare Frameworks und ausstehende Versionen einer Komponente.

• get_install_commandKostenlos

  slug or plate, framework (default react)

  Installationsbefehl, Registry-URL und components.json-Konfiguration für eine Komponente. Mitgliederkomponenten sind in einem aktiven Pro-Plan enthalten.

• get_design_guidanceKostenlos

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

  Durchsucht die Sammlung von Gestaltungshinweisen.

• generate_design_system2 Guthabenpunkte

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

  Erstellt ein Designsystem mit Palette, Typografie, Layout, Bewegung, UX-Regeln und Prüfungen.

• get_slop_rulesKostenlos

  category?, level?, scope?

  Fieldbooks Gestaltungsrichtlinien für Coding-Agenten abrufen.

• get_font_guidanceKostenlos

  role?, family?, name?

  Erklärt Erscheinung und Verhalten empfohlener Schriften, ihre Kombinationen und Auswahlkriterien.

• suggest_alternativesKostenlos

  ruleId

  Alternativen zu einem Gestaltungsbefund abrufen.

• score_pageKostenlos

  html? | url?, scope? (page | section), intent? [{ ruleId, reason }]

  Bewertet eine Seite anhand der Regeln; URL-Abrufe verwenden einen SSRF-Schutz.

Registry

Installiere offene Komponenten direkt oder über die folgende components.json-Registry. Mitgliederkomponenten sind in einem aktiven Pro-Plan enthalten.

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