Zum Hauptinhalt springen

Claude & Cockpit verbinden (MCP)

Neu im Team?

Nicht der Einstieg für eine neue Website in v0. Zuerst Start hier und optional Claude & MCP — erst später.

Mit dieser Verbindung sprichst du in Claude in normalen Sätzen mit Cockpit: Inhalte lesen, suchen, erstellen, Center anlegen und Entwürfe einreichen oder genehmigen. Das Programm heißt MCP (Model Context Protocol).

Tool-Namen (ab MCP v0.5.0)

Schreib-/Integrations-Tools heißen cockpit_* (z. B. cockpit_content_push, cockpit_list_centers) — nicht mehr cockpit_agencyos_*. Nach MCP-Deploy v0 Custom Instructions und ggf. Claude-Connector neu aktivieren und Tool-Namen anpassen (siehe packages/mcp-cockpit-os/V0_CUSTOM_INSTRUCTIONS.md).

Wichtig, wenn ihr viel mit v0 und Claude arbeitet

Nicht alles läuft über MCP. Social-Entwürfe (Text, Medien, Termin, Freigabe anfordern) können über cockpit_create_social_draft — Kalender, KI-Bild und Community-Antworten bleiben im Dashboard. Die Grenzen stehen in v0, Claude/MCP und Cockpit — wer macht was?.

Kurz wählen:

WegFür wenAufwand
Claude Team verbindenRedaktion mit Claude Team / Enterprise im Browser5 Minuten, kein Token
Cursor (Alternative)Entwicklung in Cursor mit lokalem MCPToken aus dem Cockpit, IT hilft beim Einrichten
Legacy Token-URLNur wenn Connect noch nicht gehtIT liefert URL mit Token

Claude Team / Organisation verbinden​

So verbindest du cockpitOS mit Claude im Browser — ohne Geheimnis kopieren, ohne Installation.

Voraussetzungen​

  • Du hast einen Zugang zum Cockpit (dashboard.cockpit-os.de) — E-Mail und Passwort wie im Alltag.
  • Du arbeitest im Claude-Team-Account deiner Organisation auf claude.ai — nicht im privaten Free-Account.
  • Ein Claude-Team-Admin hat den cockpitOS-Connector in eurer Organisation freigeschaltet (einmalig, vorher).
Noch kein Team-Zugang?

Privater Claude-Account reicht nicht. Bitte IT oder Team-Admin um Einladung in die Organisation — oder nutze vorübergehend Cursor (Weg B).

Schritt 1 — Claude im Browser öffnen​

  1. claude.ai öffnen.
  2. Anmelden — oben sollte eure Organisation / Team sichtbar sein, nicht nur „Persönlich“.

Schritt 2 — Connectors öffnen​

  1. Oben rechts auf dein Profilbild klicken.
  2. Settings (Einstellungen) wählen.
  3. Links Connectors öffnen — manchmal heißt der Menüpunkt Integrations oder MCP.

Schritt 3 — cockpitOS-Connector hinzufügen​

  1. Auf Add connector oder Add custom integration klicken.
  2. Als Server-URL genau dies eintragen (am Ende kein Schrägstrich, kein Zusatz):
https://mallos-mcp-cockpit.onrender.com/mcp
Wichtig

Die URL darf kein ?token=… enthalten. Wenn du eine URL mit Token von der IT bekommen hast, ist das der alte Weg — siehe Legacy Token-URL.

Schritt 4 — Mit Cockpit anmelden​

  1. Auf Connect oder Verbinden klicken.
  2. Claude leitet dich zum cockpitOS-Login weiter.
  3. Mit deinem Cockpit-Konto anmelden (dieselben Zugangsdaten wie im Dashboard).
  4. Auf der Seite „Claude darf auf dein Cockpit-Konto zugreifen“ auf Verbindung erlauben klicken.

Schritt 5 — Zurück in Claude​

Du landest automatisch wieder in Claude. Der Connector sollte als verbunden erscheinen. Fertig — kein Token kopieren, keine zweite URL.


Erfolg prüfen​

Im Claude-Chat (neuer Chat reicht) schreiben:

Bitte ruf das Tool cockpit_whoami auf und sag mir kurz, wer angemeldet ist.

So sieht Erfolg aus:

FeldErwartung
successtrue
actor.nameDein Name aus dem Cockpit
actor.emailDeine Cockpit-E-Mail
AnmeldungsartPersönlicher Login über Connect (nicht ein anonymer Team-Schlüssel)

Wenn Claude deinen Namen und deine E-Mail nennt: Die Verbindung steht. Ab jetzt laufen Schreib-Aktionen im Journal unter deinem Konto.

Zweiter Schnelltest (optional):

Bitte ruf cockpit_public_center_by_slug auf mit dem Slug "DEIN-CENTER-SLUG". Wie heißt das Center?

Antwort mit Centername = Tools sind aktiv.


Probleme?​

SymptomWas du tun kannst
Connect-Button reagiert nichtPop-up-Blocker im Browser prüfen. Connectors-Seite neu laden. Anderen Browser testen (Chrome/Edge). Wenn es weiter hängt: IT — OAuth ist evtl. noch nicht freigeschaltet.
Kein Cockpit-Login-FensterURL prüfen: exakt https://mallos-mcp-cockpit.onrender.com/mcp — ohne / am Ende, ohne ?token=. Connector löschen und Schritte 3–5 wiederholen.
„401 Unauthorized“ oder „Zugriff verweigert“Im Cockpit ab- und wieder anmelden. Connector trennen und Connect erneut starten. Bei anhaltendem Fehler: IT (Cockpit-Login oder OAuth-Einrichtung).
„503“ oder lange WartezeitDer MCP-Server kann nach Ruhephasen kurz „aufwachen“ — 30 Sekunden warten, dann nochmal testen.
IT hat dir eine URL mit ?token= geschicktDas ist der alte Weg — funktioniert noch, aber Connect (oben) ist der Standard. Siehe Legacy Token-URL.
Keine Cockpit-Tools im ChatIm Team-Account angemeldet? Connector in Settings → Connectors auf „connected“? Seite neu laden, neuen Chat starten.
Du bist unsicher, ob OAuth schon live istErst Connect versuchen. Wenn Login-Schritt fehlt: IT fragen — bis dahin Legacy-URL oder Cursor.

An wen wenden?

  • IT / Betrieb / SMG Coding — Connector in Claude, Cockpit-Login, OAuth-Freischaltung, Server-URL.
  • Claude-Team-Admin — dich in die Organisation einladen, Connector für alle sichtbar machen.
  • Nicht Token oder URLs in Teams-Allgemeinchat posten — nur IT oder Passwort-Manager.

Technische Details für IT: IT-Setup Render · MCP OAuth (Entwickler)


Weg B — Cursor (Alternative)​

Für Cursor (nicht Claude im Browser): persönliches Token + lokaler MCP-Server (stdio). IT richtet das einmal ein; danach nutzt du es wie gewohnt.

1. Token im Cockpit erzeugen​

  1. dashboard.cockpit-os.de öffnen und anmelden.
  2. Mein Konto → MCP verbinden.
  3. Neues Token erzeugen — beginnt mit sk_mcp_…, wird nur einmal angezeigt.
  4. Token sicher speichern (Passwort-Manager). Nicht weiterleiten.

2. MCP in Cursor einrichten (IT oder du mit Anleitung)​

Im Projekt-Root (Monorepo):

pnpm install
pnpm mcp:init

Der Assistent fragt nach Dashboard-URL (Standard lassen) und dem sk_mcp_…-Token. Danach Cursor neu starten.

Manuell: Token als Umgebungsvariable COCKPIT_MCP_USER_TOKEN für den MCP-Server setzen — siehe packages/mcp-cockpit-os/README.md.

3. Prüfen​

In Cursor-Chat:

Bitte cockpit_whoami aufrufen.

Erwartung: actor.name und actor.email = du; Anmeldungsart = persönliches MCP-Token (mcp_user_token).

Hinweis: Claude Desktop (App ohne Team) nutzt denselben Token-Weg — siehe Desktop-App.


Legacy Token-URL (Fallback)​

Übergangslösung

Connect (oben) ist der Standard. Dieser Weg bleibt, wenn OAuth noch nicht aktiv ist oder die IT eine fertige URL schickt.

Die IT schickt eine fertige URL, die das Token enthält — z. B.:

https://mallos-mcp-cockpit.onrender.com/mcp?token=a3f7b9...

Connector eintragen: Settings → Connectors → Add custom integration → Server-URL = vollständige URL von der IT (mit ?token=…). OAuth-Felder leer lassen.

Alternativ: persönliches Token sk_mcp_… aus Mein Konto → MCP verbinden — siehe Cursor (Weg B) oder Desktop-App.

Token und URL geheim halten wie ein Passwort.


v0, Claude/MCP und Cockpit — wer macht was?​

Redaktion arbeitet künftig stark über v0 und Claude — trotzdem gibt es drei getrennte Ebenen. Verwechselt sie nicht, sonst sucht ihr Social-Posts oder den Kalender vergeblich im Chat.

Drei Ebenen auf einen Blick​

EbeneWofürEinstieg
v0Website-Design: Layout, Komponenten, Farben. Inhalte kommen aus der Cockpit-API (Instructions A–J).Center-Website mit v0
Claude + MCPCenter-Daten lesen/schreiben: News, Events, Angebote, Shops, Website-Reiter, Workflow-EntwürfeDiese Seite
Cockpit-DashboardSocial-Editor, Kalender, Dispatch, Community-AntwortenNavigation & Module

Faustregel: v0 = Aussehen. MCP = Inhalte, Config und Social-Freigabe/Lesen. Dashboard = Social-Editor, Planer, E-Mail-Eingang.

Über MCP / Claude — das geht ✅​

BereichBeispiel-Prompt / Tool
News, Events, Angebote, Shopscockpit_search_content, cockpit_content_push mit submitToWorkflow: true
Website-Reiter (Hero, Header, Farben, MEC ShopBox …)cockpit_website_config_schema → lesen/schreiben
Center anlegen & Metadatencockpit_create_center, cockpit_update_center
Mediathek, Homepage-Kachelncockpit_upload_media, cockpit_homepage_tiles
Website-Workflow (Freigaben)cockpit_list_drafts, cockpit_update_draft
Website-/Content-Analyticscockpit_analytics_* — Umami vollständig (Traffic, Events, Export, Browser/OS/Länder), Content-Performance, Signage, Reporting, Trending
Social-Entwürfe anlegen (Text, Medien, Termin)cockpit_create_social_draft, cockpit_update_social_draft, cockpit_upload_media, cockpit_social_draft_quality_check
Social-Freigaben & Auswertungcockpit_list_social_drafts, cockpit_social_review, cockpit_social_engage, cockpit_social_analytics, cockpit_social_sync_metrics, cockpit_social_reporting
Outstand-Kanal-Verknüpfungen (welche Center verbunden?)✅ cockpit_list_outstand_centers — Bulk aus center_social_accounts, nicht website-config
Öffentliche Live-Daten prüfencockpit_public_news, cockpit_public_offers, …
Bedien-Doku (Centerplan, Polygon-Editor, Mapping, Social …)cockpit_search_documentation — z. B. query="centerplan zoomen polygon" · technische API-Doku: cockpit_public_integration_docs
Neuerungen / Changelogcockpit_changelog — z. B. „Was gab es zuletzt Neues?“ · optional audience=dashboard

Nicht über MCP — bitte im Dashboard 🖥️​

Diese Bereiche bleiben im Dashboard — Claude kann sie nicht ersetzen.

BereichPfad im DashboardKurz warum
Social KI-Bild (Bild-Assistent im Editor)Social Cockpit → Post erstellenGenerierung nur im Browser
Social OAuth / Kanäle verknüpfen/dashboard/settings/social-accountsMeta-Login
Community OAuth / Kanal-Inbox UI/dashboard/social/engageLesen + Schreiben auch über MCP: cockpit_social_engage + cockpit_social_engage_action
Social-PDF und Kanäle/dashboard/social/reportingPDF-Export und OAuth bleiben im Dashboard; Kurzüberblick: cockpit_social_reporting
Kalender (Termine, „Nur online / aktiv“)/dashboard/content/plannerTerminübersicht; MCP kann Inhalte anlegen, aber nicht den Kalender bedienen
Dispatch (E-Mail-Eingang)Redaktionsfluss → DispatchPosteingang-UI
Emoji-Picker / Bild-LightboxSocial-EditorReine UI im Browser
Typischer Tagesablauf
  1. Angebot oder News → Claude/MCP (Entwurf zur Freigabe) oder manuell im Cockpit.
  2. Termin im Kalender prüfen → Kalender im Browser öffnen.
  3. Facebook-/Instagram-Post → Claude (cockpit_create_social_draft) oder Social Cockpit (Editor → Freigabe → Outstand).
  4. Neues Layout / Hero-Slide → v0 für Code; Reiter-Texte ggf. zusätzlich über MCP (templateContent).

v0 und MCP ergänzen sich​

In v0 laden die Instructions (Teile A–J) News, Events und Shops über die öffentliche API. Claude schreibt dieselben Daten über MCP ins Cockpit. v0 ersetzt MCP nicht — und MCP ersetzt kein v0-Design.

FrageAntwort
Wie sieht die Seite aus?v0 (+ Deploy über GitHub/Vercel)
Was steht in News/Angeboten/Reitern?MCP oder manuell im Dashboard
Social-Post erstellen oder Kommentar beantworten?Dashboard → Social Cockpit (Freigabe/Lesen: MCP)
Wann läuft welches Angebot im Kalender?Dashboard → Kalender

Weiterlesen: Social Media — Einstieg · Social Freigabe (Detail) · Workflow & Planner


Beispiele — was du Claude sagen kannst​

Neues Center-Website-Projekt starten (Pflicht-Einstieg)​

Immer wenn ein neues Website-Projekt für ein Center beginnt, zuerst diesen Schritt:

Ich starte ein neues Center-Website-Projekt für das Center mit dem Slug "DEIN-SLUG".
Bitte ruf cockpit_center_project_init auf (center_slug="DEIN-SLUG", api_base_url="https://dashboard.cockpit-os.de").
Zeig mir die centerId und die Checkliste.

Claude liefert dann:

  • centerId (UUID) für alle weiteren API-Aufrufe
  • Eine Checkliste mit den Pflichtschritten (Website aktivieren, Analytics konfigurieren, Inhalte prüfen, …)
  • Warnungen, falls das Center nicht existiert oder keine Inhalte hat
Warum dieser Schritt Pflicht ist

Das Tool stellt sicher, dass Claude weiß: cockpitOS ist die einzige Source of Truth.** Shops, News, Events und Texte dürfen nie als Dummy-Daten im Frontend-Code stehen — sie kommen immer aus cockpitOS. Der Init-Schritt lädt diese Regel aktiv in den KI-Kontext.

Überblick über ein Center holen​

Ich arbeite für unser Shopping Center (Slug: "DEIN-SLUG").
1. Hol die centerId über cockpit_public_center_by_slug.
2. Zeige mir einen kompakten Überblick: aktive Shops, laufende Angebote, kommende Events.
Nutze dafür cockpit_content_stats.
Schreibe noch nichts ins Cockpit.

Centerplan laden (inkl. Hybrid-SVG)​

Slug „DEIN-SLUG“. Hol centerId über cockpit_public_center_by_slug und dann cockpit_public_wayfinding_floors.
Liste pro Etage nur kompakt: name, Länge mapSvg-Zeichen, ob mapImage und shopViewBoxes gesetzt, Anzahl mapLocations.

Siehe auch: Public API Vertrag — Hybrid & Wayfinding.

Inhalte suchen, bevor du etwas erstellst​

Gibt es in unserem Cockpit schon Angebote von Deichmann? Bitte in allen Centern suchen.
Nutze cockpit_search_content mit q="Deichmann" und contentType="offer".
Welche Angebote laufen in den nächsten 7 Tagen ab?
Nutze cockpit_search_content mit contentType="offer" und expiresBefore="<Datum in 7 Tagen>".

Angebot für alle Center einer Kette einreichen (Workflow-Modus)​

Beim Workflow-Modus landet alles zuerst unter Workflow & Freigaben im Dashboard — nichts geht live, bevor jemand genehmigt.

Immer erst Vorschau holen (kein Schreiben, nur Daten-Check):

Nutze cockpit_content_push_preview für Center <UUID> mit:
offers: [{ title: "Sommer-Sale: 30 % auf alle Sneaker", description: "...", validFrom: "2026-07-01", validTo: "2026-07-31" }]

Zeig mir was das Cockpit zurückgibt — noch nicht wirklich einreichen.

Wenn die Vorschau stimmt, dann für alle Deichmann-Center einreichen:

Erstelle ein Angebot für alle Deichmann-Center:
- Titel: "Sommer-Sale: 30 % auf alle Sneaker"
- Gültig: 1. Juli bis 31. Juli

Schritt 1: Nutze cockpit_list_centers mit chainSlug="deichmann".
Schritt 2: Für jedes Center: cockpit_content_push mit submitToWorkflow=true und campaignLabel="Sommer-Sale Deichmann Juli".
Zeige mir vorher eine Vorschau je Center.

Was dann passiert: Im Workflow & Freigaben erscheinen alle Entwürfe — nach Kampagne filterbar, mit „Alle genehmigen"-Button.

Wochenprospekt als PDF an Angebot hängen​

Für Angebote mit Prospekt-PDF (z. B. wöchentlich per Mail):

  1. PDF hochladen: cockpit_upload_media (URL oder Base64, Typ brochure / PDF) → Bunny-URL.
  2. Bestehendes Angebot aktualisieren: cockpit_update_offer mit attachmentPdfUrl: "<cdn-url>" oder beim Push im offers[]-Objekt dasselbe Feld setzen.
  3. Entfernen: attachmentPdfUrl: null via cockpit_update_offer.

Im Dashboard (Angebot bearbeiten → Medien): Feld „Prospekt als PDF“. Auf der Center-Website erscheint auf der Angebots-Detailseite der Button „Prospekt herunterladen“ (alle Templates inkl. ILG/MEC).

Neues Center on the fly anlegen​

Du musst kein Center mehr vorher im Dashboard anlegen — Claude kann das direkt:

Leg ein neues Center im Cockpit an:
- Name: Alstertal Einkaufszentrum
- Adresse: Heegbarg 31, 22391 Hamburg
- Logo: https://example.com/logo.png (bitte zu BunnyCDN hochladen)
- Akzentfarbe: #E63946

Danach: zeige mir die centerId und den Slug.

Direkt im Anschluss kannst du es befüllen:

Füge für das gerade angelegte Center (centerId: ...) folgende Shops hinzu:
- H&M (Kategorie: Mode, Etage: EG)
- Starbucks (Kategorie: Gastronomie, Etage: EG)
Nutze cockpit_list_categories um die richtigen Kategorienamen zu holen.

Danach — Shop-Verknüpfung auf dem Plan. Shops in der Liste reichen nicht. Die Karte wird erst klickbar, wenn jede Fläche einem Shop zugeordnet ist (mapLocations). v0 macht das nicht automatisch.

Prüfe die Shop-Verknüpfungen auf dem Centerplan (centerId: ...):
1. cockpit_list_wayfinding_floors — gibt es schon eine Etage mit Plan?
2. cockpit_list_map_locations — welche Flächen haben noch keine shopId?
3. Wenn svgId bekannt (z. B. aus Claude Design): cockpit_assign_map_location.
4. Wenn unklar: sag mir, dass Redaktion im Dashboard unter Centerpläne → Mapping Fläche für Fläche klicken muss.
Ohne Plan: zuerst SVG oder Hybrid hochladen, dann zuordnen. Weg-Linie: Routen aus der SVG erzeugen.

Center-Logo oder Öffnungszeiten aktualisieren​

Aktualisiere bei Center X (centerId: ...) folgendes:
- Neues Logo: https://... (bitte zu BunnyCDN hochladen)
- Öffnungszeiten: Mo–Sa 10–21 Uhr, So 12–18 Uhr
Das Deichmann-Logo hat sich geändert. Hier ist das neue Logo: https://...
Bitte das Logo bei allen Centern aktualisieren, die einen Deichmann-Shop haben.

Entwürfe prüfen und genehmigen​

Wie viele Entwürfe warten gerade auf Freigabe?
Nutze cockpit_list_drafts.
Genehmige alle Entwürfe aus der Kampagne "Sommer-Sale Deichmann Juli".
1. Hole zuerst die Entwürfe mit cockpit_list_drafts und campaignLabel="Sommer-Sale Deichmann Juli".
2. Genehmige jeden einzelnen mit cockpit_update_draft.

Abgelaufene Inhalte aufräumen​

Zeige mir alle Angebote die bereits abgelaufen sind (endDate vor heute).
Nutze cockpit_search_content mit contentType="offer" und expiresBefore="<heute>".
Dann: archiviere alle davon mit cockpit_archive_content.

MCP-Tools im Überblick​

Vollständige Tool-Liste

Die autoritative Referenz aller Tools mit Parametern und Beispiel-Prompts: MCP-Tool-Referenz (automatisch aus exports/cockpitos-tools.json). Kuratierte Auswahl unten; Quellcode: packages/mcp-cockpit-os/src/register-cockpit-tools.ts.

Öffentliche Reads (ohne API-Key, Auswahl)​

ToolWas es tut
cockpit_public_center_by_slugSlug → centerId, Name
cockpit_public_news / events / offersListen inkl. contentCategory; Filter contentCategorySlug
cockpit_public_content_categoriesInhaltskategorien (News/Events/Angebote)
cockpit_public_aktuelles_bundleNews+Events+Offers+Jobs in einem Request
cockpit_public_wayfinding_floorsCenterplan mit mapSvg, mapLocations
cockpit_public_shops / services / officesStammdaten
cockpit_public_integration_docsMaschinenlesbare Integrationshinweise für v0

Projekt-Einstieg (neu)​

ToolWas es tut
cockpit_center_project_initPflicht-Einstieg für jedes neue Center-Website-Projekt. Prüft, ob das Center existiert, gibt centerId zurück und liefert die Workflow-Checkliste (inkl. Shop-Verknüpfung auf dem Plan) + Quick-Reference. Verhindert, dass Inhalte nur im Frontend-Code landen.
cockpit_mcp_discover_toolsTool-Finder: Wenn Claude ein MCP-Tool nicht findet (tool_search zeigt nur ~5 von 70+ Tools) — Stichwort eingeben, exakten Tool-Namen erhalten.

Website-Reiter & Konfiguration​

ToolWas es tut
cockpit_get_center_website_configVolle Website-Config lesen (Design, SEO, templateContent, pagesConfig, …).
cockpit_website_config_schemaDashboard-Reiter pro Template: wo welche Felder liegen + welches MCP-Tool.
cockpit_update_center_website_configWebsite-Config schreiben (partial Update).

Lesen & Navigieren​

ToolWas es tut
cockpit_public_center_by_slugCenter per URL-Slug auflösen → liefert centerId, Name. Kein API-Key nötig.
cockpit_public_wayfinding_floorsCenterplan / interaktive Karte: Etagen mit mapSvg und mapLocations (z. B. für SVG-Klick → Shop-Modal). centerId = Center-UUID, nicht floorId aus der Centerplan-URL.
cockpit_list_centersAlle Center auflisten — filterbar nach Kette (chainSlug), Organisation (organizationId), Name.
cockpit_get_centerDetails eines Centers per ID.
cockpit_center_contextKompletter Cockpit-Kontext (Shops, News, Events, Angebote, Services); optional include=content_categories
cockpit_list_organizationsAlle Organisationen mit Center-Anzahl.
cockpit_list_categoriesVerfügbare Shop-Kategorien — vor dem Anlegen von Shops aufrufen.

Suchen​

ToolWas es tut
cockpit_search_contentVolltextsuche über News, Angebote, Events, Shops, Services, Jobs, Offices — mit Keyword-, Status- und Datumsfilter. Liefert u. a. createdAt, updatedAt, source (wo vorhanden).
cockpit_content_statsKompakter Überblick: aktive Shops, Angebote, Events, offene Entwürfe, was bald abläuft.
cockpit_audit_logsProvenance: Wer hat welchen Inhalt wann geändert — pro Center oder pro Eintrag. Mit summary: true → Rangliste nach Nutzer.
cockpit_center_teamTeam: Wer ist dem Center zugewiesen (Rollen, Berechtigungen) — Antwort auf „wie viele arbeiten damit?“.

Center verwalten​

ToolWas es tut
cockpit_create_centerNeues Center anlegen (Name, Adresse, Logo, Farben …). Danach Shops und Plan-Verknüpfung.
cockpit_update_centerCenter-Metadaten updaten — Logo, Öffnungszeiten, Farben, Hero-Bild, SEO.
cockpit_list_map_locationsShop ↔ Fläche auf dem Plan prüfen.
cockpit_assign_map_locationBekannte svgId einem Shop zuordnen. Unklare Flächen: Dashboard-Mapping.

Inhalte schreiben​

ToolWas es tut
cockpit_content_push_previewVorschau / Dry-Run — zeigt was beim Push passieren würde, schreibt nichts. Immer zuerst aufrufen.
cockpit_content_pushSchreibt ins Cockpit — direkt oder mit submitToWorkflow: true zur Freigabe.
cockpit_chain_bulkGleichen Inhalt für alle Center einer Kette erstellen (z. B. alle Deichmann-Center).
cockpit_org_bulkGleichen Inhalt für alle Center einer Organisation erstellen.
cockpit_archive_contentInhalt archivieren (Shops, Events, News, Angebote, Services).
cockpit_upload_mediaExterne Bild- oder PDF-URL zu BunnyCDN hochladen → CDN-URL zurück (Prospekte: dann attachmentPdfUrl am Angebot).
cockpit_list_mediaMediathek eines Centers listen (bestehende Bunny-URLs wiederverwenden).
cockpit_homepage_tilesHomepage-Kacheln lesen/anlegen/ändern/löschen.
cockpit_page_contentSeiten-Inhalte (Hero, SEO, customContent) pro pageType lesen/schreiben.
cockpit_revalidate_websiteWebsite-Cache manuell invalidieren (nach Push meist automatisch).

Entwürfe & Freigaben​

ToolWas es tut
cockpit_list_draftsOffene Entwürfe — optional includeData: true für Payload wie im Cockpit (customerCommunication, dispatchItemId, …). Enthält createdByName.
cockpit_get_draftEin Entwurf nach ID — optional includeData: true.
cockpit_update_draftEntwurf genehmigen oder ablehnen.
cockpit_draft_customer_touchpointKI-Vorschlag für Kundenkommunikation (Szenario wie im Workflow: approve / reject / pending).

Social Cockpit​

ToolWas es tut
cockpit_create_social_draftSocial-Entwurf anlegen (Caption, mediaUrls/containers, Termin, Freigabe).
cockpit_update_social_draftEntwurf bearbeiten, Medien nachziehen, cancel_schedule.
cockpit_social_draft_quality_checkPre-Flight vor Freigabe/Planung.
cockpit_list_social_draftsSocial-Entwürfe listen (Status, Freigeber, Dashboard-Links).
cockpit_get_social_draftEinen Social-Entwurf lesen.
cockpit_social_reviewFreigeben oder ablehnen (approverEmail = aktiver Cockpit-Nutzer).
cockpit_social_engageCommunity lesen (Posts, optional Metriken/Kommentare).
cockpit_social_engage_actionAntworten, Liken, Verbergen, Löschen, Repost — IDs aus cockpit_social_engage.
cockpit_social_reportingKPI-Überblick (Follower, Reach, Plattform-KPIs).
cockpit_social_analyticsVollständige Auswertung — Plattformvergleich, Posts mit Metriken, Trends.
cockpit_social_sync_metricsLive-Sync Metriken (Outstand → DB) — vor leeren Analytics aufrufen.
cockpit_list_outstand_centersWelche Center welche Kanäle verbunden haben.
cockpit_social_review_digestOffene Freigaben gruppiert nach Freigeber-E-Mail.

Fanpage-Karma → Cockpit (Screenshot-Workflow)​

Wenn Karma am 25.9. ausläuft, kann die Redaktion Screenshots aus Karma (Kalender/Entwurf) an Claude schicken:

  1. cockpit_list_centers — Center-Name aus dem Screenshot → centerId
  2. Text, Termin, Format aus dem Screenshot ablesen
  3. Originalbild (Datei oder URL) — nicht nur Karma-Vorschau — per cockpit_upload_media hochladen
  4. cockpit_create_social_draft mit caption, scheduledAt, postType, mediaUrls, source: "karma-migration" — ohne action (Entwurf)
  5. cockpit_social_draft_quality_check — dann cockpit_update_social_draft mit action: submit_review

Geplante Posts bis 25.9. in Karma lassen (kein Doppelpost). Ab 26.9. nur noch Cockpit.

Claude findet ein MCP-Tool nicht?​

Claude.ai nutzt intern tool_search — bei 70+ Tools werden oft nur ~5 semantische Treffer geladen. Spezifische Tools wie cockpit_audit_logs oder cockpit_center_team erscheinen dann nicht, obwohl sie auf dem Server registriert sind.

Lösung: cockpit_mcp_discover_tools mit Stichwort (audit, team, website, wer hat, …) — liefert den exakten Tool-Namen. Danach das Ziel-Tool direkt aufrufen. Alternativ in v0-Instructions die Tool-Namen explizit nennen.

Nach Deploy auf Render: Remote-MCP neu verbinden, damit die neue Tool-Liste aktiv ist.


Regel: Immer _preview vor _push. Claude macht das automatisch, wenn du im Prompt „zeig mir erst eine Vorschau" sagst.

WasGeht?
Cockpit lesen (Shops, News, Events, Angebote)✅ immer
Center neu anlegen✅ immer
Center-Metadaten updaten✅ immer
Entwürfe zur Freigabe einreichen (submitToWorkflow)✅ immer
Entwürfe aus Claude heraus genehmigen✅ immer
Entwurf inkl. data / Kundenkontakt aus Claude lesen✅ cockpit_list_drafts / get_draft mit includeData
Kundenkontakt-Vorschlag wie im Dashboard✅ cockpit_draft_customer_touchpoint
Audit: Wer hat was wann geändert?✅ cockpit_audit_logs (Center oder einzelner Eintrag; summary für Top-Autoren)
Team: Wer hat Zugriff auf ein Center?✅ cockpit_center_team
Direkt ins Cockpit schreiben (live, ohne Freigabe)⚠️ nur wenn IT COCKPIT_ALLOW_CONTENT_PUSH aktiviert hat
Website-Code-Dateien bearbeiten❌ nicht über MCP — dafür: v0 oder Website mit Claude bauen
Social-Entwurf anlegen (Text, Medien, Termin, Freigabe anfordern)✅ cockpit_create_social_draft, cockpit_upload_media, cockpit_update_social_draft
Social KI-Bild❌ Dashboard → Social-Editor
Community antworten✅ cockpit_social_engage_action (oder Dashboard)
Kalender (Termine, Filter „Nur online“)❌ nur Dashboard → /dashboard/content/planner
Dispatch (E-Mail-Eingang)❌ nur Dashboard → Redaktionsfluss
Social-Freigaben listen/entscheiden✅ cockpit_list_social_drafts, cockpit_social_review
Community lesen / Social-Auswertung✅ cockpit_social_engage, cockpit_social_analytics, cockpit_social_sync_metrics, cockpit_social_reporting
Outstand-Verknüpfungen (welche Center/Kanäle verbunden?)✅ cockpit_list_outstand_centers — ein Bulk-Call statt N× Website-Config

Weg C — Desktop-App (Fallback · braucht Node.js)​

Wann Weg C sinnvoll ist
  • Ihr habt kein Claude Pro/Team — nur die kostenlose Desktop-App
  • Ihr wollt offline arbeiten können
  • IT-Person richtet es einmal ein, Redakteurin nutzt es danach

Einmalig einrichten (IT, einmal pro Mac)​

Im Repo-Hauptordner:

pnpm install
pnpm mcp:init

Der Assistent fragt nach:

  • Dashboard-URL (Vorgabe https://dashboard.cockpit-os.de — so lassen)
  • Persönliches Token sk_mcp_… (empfohlen: Mein Konto → MCP verbinden) oder AgencyOS-Key sk_agencyos_… (Automationen, unverändert)
  • Live-Push erlauben? (für Anfang: nein empfohlen)

Danach Claude Desktop vollständig beenden und neu starten. Fertig.

Falls der Assistent abbricht (Eintrag schon vorhanden): COCKPIT_MCP_INIT_FORCE=1 pnpm mcp:init

Manuell: pnpm --filter @mall-os/mcp-cockpit-os run build → claude_desktop_config.json anpassen (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).


IT-Setup: Remote-Server auf Render einrichten​

Der Remote-MCP-Service ist bereits in render.yaml eingetragen (mallos-mcp-cockpit). Nach einem Blueprint-Sync auf Render läuft er automatisch.

Einmalig nach dem ersten Deploy in Render manuell setzen:

Dashboard (mallos-dashboard)​

VariableZweck
MCP_OAUTH_ENABLED1 — OAuth Authorization Server aktiv
MCP_OAUTH_ISSUERhttps://dashboard.cockpit-os.de
MCP_OAUTH_REDIRECT_URISu. a. https://claude.ai/api/mcp/auth_callback
MCP_OAUTH_INTROSPECT_SECRETGeheimnis für Remote-Introspection (gleicher Wert wie auf MCP-Remote)

Metadaten prüfen: GET https://dashboard.cockpit-os.de/.well-known/oauth-authorization-server

Details: MCP OAuth (Entwickler)

Remote-MCP (mallos-mcp-cockpit)​

  1. Render Dashboard → Service mallos-mcp-cockpit → Environment

  2. MCP_OAUTH_RESOURCE_URL — https://mallos-mcp-cockpit.onrender.com/mcp

  3. MCP_OAUTH_INTROSPECTION_URL — https://dashboard.cockpit-os.de/oauth/introspect

  4. MCP_OAUTH_INTROSPECT_SECRET — gleiches Geheimnis wie auf dem Dashboard

  5. MCP_OAUTH_LEGACY_BEARER_FALLBACK — 1 während Rollout (Legacy ?token= bleibt möglich)

  6. COCKPIT_MCP_HTTP_BEARER — ein langes Zufallsgeheimnis (Legacy + Introspection-Fallback):

    openssl rand -hex 32

    Diesen Wert in Render eintragen. Dann die fertige Connector-URL für die Redakteurinnen zusammenstellen:

    https://mallos-mcp-cockpit.onrender.com/mcp?token=<WERT-AUS-RENDER>

    Diese URL sicher übermitteln (Passwort-Manager, nie im offenen Chat oder per E-Mail).

  7. Schreiben: entweder COCKPIT_MCP_USER_TOKEN (persönlich, Mein Konto → MCP verbinden) oder COCKPIT_AGENCYOS_API_KEY (geteilter Integrations-Key, unverändert). Persönliches Token hat Vorrang. Der gemeinsame Render-Key bleibt fürs Team — dann steht im Journal weiter der Key, nicht die einzelne Person.

  8. COCKPIT_ALLOW_CONTENT_PUSH — leer lassen für sicheren Start (nur Workflow-Modus). Auf 1 oder true setzen, wenn direktes Schreiben erlaubt sein soll. In render.yaml ist diese Variable mit sync: false — der Wert aus dem Render-Dashboard wird beim Blueprint-Deploy nicht zurückgesetzt (früher wurde er durch ein leeres Blueprint-Feld überschrieben).

  9. Service neu deployen.

Health-Check: https://mallos-mcp-cockpit.onrender.com/health — wenn "ok": true erscheint, läuft alles.

OAuth PRM: GET https://mallos-mcp-cockpit.onrender.com/.well-known/oauth-protected-resource/mcp

Sicherheitshinweise
  • COCKPIT_MCP_HTTP_BEARER ist das einzige Geheimnis zwischen Claude und dem MCP-Server. Wer es hat, kann alle MCP-Tools aufrufen. Bei Verdacht auf Weitergabe: sofort in Render durch ein neues ersetzen und alle Redakteurinnen informieren.
  • Das Secret gehört in keinen Chat, keine E-Mail, kein öffentliches Dokument.
  • Wenn direktes Schreiben nötig ist: separate Render-Instanz mit eigenem Bearer für diese Nutzergruppe empfohlen.

Token für MCP: wo bekommt man ihn?​

Persönlich (empfohlen, wenn du selbst im Chat sitzt):

  • Mein Konto → MCP verbinden (/dashboard/account/mcp)
  • Token erzeugen (sk_mcp_…, einmal sichtbar) → lokal als COCKPIT_MCP_USER_TOKEN
  • Journal und Verlauf zeigen dich. Mit cockpit_whoami prüfen.

AgencyOS-Key (unverändert, für Automationen und den gemeinsamen Remote-MCP):

  • Einstellungen → API & Integrationen (Karte AgencyOS)
  • Key beginnt mit sk_agencyos_, einmal sichtbar
  • Im Journal steht der Key bzw. wer ihn angelegt hat — nicht wer gerade tippt

Nur lesen (ohne Key): Die cockpit_public_*-Tools funktionieren ohne Token.


Weitere Probleme (IT / Desktop)​

SymptomWas tun
Claude Team: Connect, Login, 401Siehe Probleme? (Claude Team)
Connector erscheint nicht / keine ToolsURL korrekt? Kein / am Ende? Claude-Seite neu laden. Settings → Connectors prüfen.
„503" oder TimeoutMCP-Server kann nach Ruhe kurz aufwachen — 30 Sek. warten, erneut testen.
„Push verweigert"Direktes Live-Schreiben ist absichtlich eingeschränkt. Entwürfe zur Freigabe (submitToWorkflow: true) funktionieren immer.
Desktop-MCP / Cursor: keine ToolsMCP-Konfiguration gespeichert? Cursor/Claude vollständig neu gestartet (nicht nur Fenster schließen)? Token aus Mein Konto → MCP verbinden gesetzt?

Zurück zur Übersicht: Content-Creator-Handbuch → Einführung

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /dashboard/claude-mcp-redaktion-anleitung