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?.

Es gibt zwei Wege. Nimm Weg A, wenn ihr Claude Pro/Team/Enterprise habt — er braucht null Installation auf eurem Mac.

---

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

Ebene	Wofür	Einstieg
v0	Website-Design: Layout, Komponenten, Farben. Inhalte kommen aus der Cockpit-API (Instructions A–J).	Center-Website mit v0
Claude + MCP	Center-Daten lesen/schreiben: News, Events, Angebote, Shops, Website-Reiter, Workflow-Entwürfe	Diese Seite
Cockpit-Dashboard	Social-Editor, Kalender, Dispatch, Community-Antworten	Navigation & Module

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

Über MCP / Claude — das geht ✅

Bereich	Beispiel-Prompt / Tool
News, Events, Angebote, Shops	cockpit_search_content, cockpit_content_push mit submitToWorkflow: true
Website-Reiter (Hero, Header, Farben, MEC ShopBox …)	cockpit_website_config_schema → lesen/schreiben
Center anlegen & Metadaten	cockpit_create_center, cockpit_update_center
Mediathek, Homepage-Kacheln	cockpit_upload_media, cockpit_homepage_tiles
Website-Workflow (Freigaben)	cockpit_list_drafts, cockpit_update_draft
Website-/Content-Analytics	cockpit_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 & Auswertung	cockpit_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üfen	cockpit_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 / Changelog	cockpit_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.

Bereich	Pfad im Dashboard	Kurz warum
Social KI-Bild (Bild-Assistent im Editor)	Social Cockpit → Post erstellen	Generierung nur im Browser
Social OAuth / Kanäle verknüpfen	/dashboard/settings/social-accounts	Meta-Login
Community OAuth / Kanal-Inbox UI	/dashboard/social/engage	Lesen + Schreiben auch über MCP: cockpit_social_engage + cockpit_social_engage_action
Social-PDF und Kanäle	/dashboard/social/reporting	PDF-Export und OAuth bleiben im Dashboard; Kurzüberblick: cockpit_social_reporting
Kalender (Termine, „Nur online / aktiv“)	/dashboard/content/planner	Terminübersicht; MCP kann Inhalte anlegen, aber nicht den Kalender bedienen
Dispatch (E-Mail-Eingang)	Redaktionsfluss → Dispatch	Posteingang-UI
Emoji-Picker / Bild-Lightbox	Social-Editor	Reine 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.

Frage	Antwort
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

---

Weg A — Remote-URL (empfohlen · keine Installation)

Unsere Organisation

Wir haben einen Claude-Team-Account. cockpitOS-MCP ist für alle in dieser Organisation aktiv. Im Team anmelden auf claude.ai — dann sind die Cockpit-Tools da. Nicht den privaten Claude-Account nutzen. Claude Free reicht nicht.

Neu im Team und die Tools fehlen? Unten den Connector nachtragen (IT gibt die URL). Schon im Team und MCP sichtbar? Nichts weiter einrichten — direkt den Prüfsatz in Schritt 3 schicken.

Einmalig für die IT: Server einrichten steht in IT-Setup unten. Für die Organisation reicht das in der Regel einmal.

Für die Redakteurin: 3 Schritte

Das brauchst du von der IT — eine einzige URL

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

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

Du brauchst dir das Token nicht separat zu merken. Die URL ist dein Zugang — halte sie geheim wie ein Passwort.

Schritt 1 — Claude öffnen
claude.ai im Browser öffnen und anmelden.

Schritt 2 — Connector eintragen
Oben rechts auf dein Profilbild klicken → Settings → links Connectors (oder „Integrations" / „MCP" — der Name kann je nach Claude-Version leicht abweichen).

→ Add custom integration (oder „Add MCP server") → folgende Felder ausfüllen:

Feld	Was du einträgst
Name	cockpitOS (oder beliebig)
Server URL	die vollständige URL von der IT (mit ?token=… am Ende)
Erweiterte Einstellungen (OAuth-Felder)	leer lassen — wird nicht benötigt

→ Speichern / Save klicken.

Schritt 3 — Prüfen

Im Claude-Chat tippen:

Bitte ruf das Tool cockpit_public_center_by_slug auf mit dem Slug "dein-center-slug". Wie heißt das Center und was ist die centerId?

Wenn Claude eine Antwort mit Name und ID liefert: alles funktioniert. 🎉

---

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)

Tool	Was es tut
cockpit_public_center_by_slug	Slug → centerId, Name
cockpit_public_news / events / offers	Listen inkl. contentCategory; Filter contentCategorySlug
cockpit_public_content_categories	Inhaltskategorien (News/Events/Angebote)
cockpit_public_aktuelles_bundle	News+Events+Offers+Jobs in einem Request
cockpit_public_wayfinding_floors	Centerplan mit mapSvg, mapLocations
cockpit_public_shops / services / offices	Stammdaten
cockpit_public_integration_docs	Maschinenlesbare Integrationshinweise für v0

Projekt-Einstieg (neu)

Tool	Was es tut
cockpit_center_project_init	Pflicht-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_tools	Tool-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

Tool	Was es tut
cockpit_get_center_website_config	Volle Website-Config lesen (Design, SEO, templateContent, pagesConfig, …).
cockpit_website_config_schema	Dashboard-Reiter pro Template: wo welche Felder liegen + welches MCP-Tool.
cockpit_update_center_website_config	Website-Config schreiben (partial Update).

Lesen & Navigieren

Tool	Was es tut
cockpit_public_center_by_slug	Center per URL-Slug auflösen → liefert centerId, Name. Kein API-Key nötig.
cockpit_public_wayfinding_floors	Centerplan / 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_centers	Alle Center auflisten — filterbar nach Kette (chainSlug), Organisation (organizationId), Name.
cockpit_get_center	Details eines Centers per ID.
cockpit_center_context	Kompletter Cockpit-Kontext (Shops, News, Events, Angebote, Services); optional include=content_categories
cockpit_list_organizations	Alle Organisationen mit Center-Anzahl.
cockpit_list_categories	Verfügbare Shop-Kategorien — vor dem Anlegen von Shops aufrufen.

Suchen

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

Center verwalten

Tool	Was es tut
cockpit_create_center	Neues Center anlegen (Name, Adresse, Logo, Farben …). Danach Shops und Plan-Verknüpfung.
cockpit_update_center	Center-Metadaten updaten — Logo, Öffnungszeiten, Farben, Hero-Bild, SEO.
cockpit_list_map_locations	Shop ↔ Fläche auf dem Plan prüfen.
cockpit_assign_map_location	Bekannte svgId einem Shop zuordnen. Unklare Flächen: Dashboard-Mapping.

Inhalte schreiben

Tool	Was es tut
cockpit_content_push_preview	Vorschau / Dry-Run — zeigt was beim Push passieren würde, schreibt nichts. Immer zuerst aufrufen.
cockpit_content_push	Schreibt ins Cockpit — direkt oder mit submitToWorkflow: true zur Freigabe.
cockpit_chain_bulk	Gleichen Inhalt für alle Center einer Kette erstellen (z. B. alle Deichmann-Center).
cockpit_org_bulk	Gleichen Inhalt für alle Center einer Organisation erstellen.
cockpit_archive_content	Inhalt archivieren (Shops, Events, News, Angebote, Services).
cockpit_upload_media	Externe Bild- oder PDF-URL zu BunnyCDN hochladen → CDN-URL zurück (Prospekte: dann attachmentPdfUrl am Angebot).
cockpit_list_media	Mediathek eines Centers listen (bestehende Bunny-URLs wiederverwenden).
cockpit_homepage_tiles	Homepage-Kacheln lesen/anlegen/ändern/löschen.
cockpit_page_content	Seiten-Inhalte (Hero, SEO, customContent) pro pageType lesen/schreiben.
cockpit_revalidate_website	Website-Cache manuell invalidieren (nach Push meist automatisch).

Entwürfe & Freigaben

Tool	Was es tut
cockpit_list_drafts	Offene Entwürfe — optional includeData: true für Payload wie im Cockpit (customerCommunication, dispatchItemId, …). Enthält createdByName.
cockpit_get_draft	Ein Entwurf nach ID — optional includeData: true.
cockpit_update_draft	Entwurf genehmigen oder ablehnen.
cockpit_draft_customer_touchpoint	KI-Vorschlag für Kundenkommunikation (Szenario wie im Workflow: approve / reject / pending).

Social Cockpit

Tool	Was es tut
cockpit_create_social_draft	Social-Entwurf anlegen (Caption, mediaUrls/containers, Termin, Freigabe).
cockpit_update_social_draft	Entwurf bearbeiten, Medien nachziehen, cancel_schedule.
cockpit_social_draft_quality_check	Pre-Flight vor Freigabe/Planung.
cockpit_list_social_drafts	Social-Entwürfe listen (Status, Freigeber, Dashboard-Links).
cockpit_get_social_draft	Einen Social-Entwurf lesen.
cockpit_social_review	Freigeben oder ablehnen (approverEmail = aktiver Cockpit-Nutzer).
cockpit_social_engage	Community lesen (Posts, optional Metriken/Kommentare).
cockpit_social_engage_action	Antworten, Liken, Verbergen, Löschen, Repost — IDs aus cockpit_social_engage.
cockpit_social_reporting	KPI-Überblick (Follower, Reach, Plattform-KPIs).
cockpit_social_analytics	Vollständige Auswertung — Plattformvergleich, Posts mit Metriken, Trends.
cockpit_social_sync_metrics	Live-Sync Metriken (Outstand → DB) — vor leeren Analytics aufrufen.
cockpit_list_outstand_centers	Welche Center welche Kanäle verbunden haben.
cockpit_social_review_digest	Offene 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.

Was	Geht?
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 B — Desktop-App (Fallback · braucht Node.js)

Wann Weg B 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:

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

2. COCKPIT_MCP_HTTP_BEARER — ein langes Zufallsgeheimnis generieren:

   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).

3. 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.

4. 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).

5. Service neu deployen.

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

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.

---

Probleme?

Symptom	Was tun
Connector erscheint nicht / keine Tools in Claude	URL korrekt? Kein / am Ende? Claude-Seite neu laden. In Claude Pro: Settings → Connectors prüfen.
„401 Unauthorized"	Secret falsch eingetippt? Leerzeichen vorne/hinten? Render-Variable gesetzt und Service neu deployed?
„503" oder Timeout	Render Free-Tier schläft nach Inaktivität ein — erste Anfrage kann 30 Sek. dauern. Einfach nochmal versuchen. Auf Starter-Plan upgraden für immer-aktiv.
„Push verweigert"	COCKPIT_ALLOW_CONTENT_PUSH nicht gesetzt — das ist Absicht. Workflow-Modus (submitToWorkflow: true) funktioniert immer.
Desktop-MCP: keine Tools sichtbar	claude_desktop_config.json gespeichert? Pfad zu index.js korrekt? Claude vollständig neu gestartet (nicht nur Fenster schließen)?

---

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