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 Media, Content Planner und Dispatch bedient ihr im Cockpit-Dashboard — Claude kann das (Stand heute) nicht ersetzen. 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 (Outstand), Kalender, Freigabe-Boards, Dispatch, Engage, Reporting	Navigation & Module

Faustregel: v0 = Aussehen. MCP = Inhalte & Config in der Datenbank. Dashboard = Social, 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 (nicht Social Outstand-KPIs)
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, …

Nicht über MCP — bitte im Dashboard 🖥️

Diese Bereiche haben keine MCP-Tools. Claude kann sie weder lesen noch steuern — auch wenn der Connector verbunden ist.

Bereich	Pfad im Dashboard	Kurz warum
Social Posts (erstellen, planen, KI-Bild)	Social Cockpit → Post erstellen (/dashboard/social/new)	Outstand, Kanäle, Medien-Editor
Social Freigaben	/dashboard/social/approvals	Eigenes Board — getrennt vom Website-Workflow
Community & Antworten (Engage)	/dashboard/social/engage	Kommentare aus Outstand, Antworten posten
Social Performance (+ PDF-Export)	/dashboard/social/reporting	Outstand-Metriken, Zeitraumfilter
Kanäle verknüpfen	/dashboard/settings/social-accounts	OAuth / IT-Setup
Content Planner (Kalender, „Nur online / aktiv“)	/dashboard/content/planner	Kalender-UI; MCP kann Inhalte anlegen, aber nicht den Planer 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 → Content Planner im Browser öffnen.
3. Facebook-/Instagram-Post → 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 oder Kommentar beantworten?	Dashboard → Social Cockpit
Wann läuft welches Angebot im Kalender?	Dashboard → Content Planner

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

---

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

Wer das nutzen kann

Claude Pro, Team oder Enterprise — also ein bezahltes Claude-Konto auf claude.ai. Claude Free reicht nicht für diesen Weg.

Das läuft einmal ab — die IT richtet den Server ein (steht in IT-Setup unten), danach braucht jede Redakteurin nur noch 2 Klicks + 2 Felder ausfüllen.

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.

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 eine 7-Schritte-Checkliste + Quick-Reference für den Workflow. 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 …).
cockpit_update_center	Center-Metadaten updaten — Logo, Öffnungszeiten, Farben, Hero-Bild, SEO.

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

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 Posts, Freigaben, Engage, Performance	❌ nur Dashboard → Social Cockpit
Content Planner (Kalender, Filter „Nur online“)	❌ nur Dashboard → /dashboard/content/planner
Dispatch (E-Mail-Eingang)	❌ nur Dashboard → Redaktionsfluss
Social-Outstand-Metriken (Reichweite, Follower)	❌ nicht über MCP — Reporting im Dashboard
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)
• cockpitOS Integrations-API-Key (sk_agencyos_… — Cockpit → Einstellungen → Integrationen)
• 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. COCKPIT_AGENCYOS_API_KEY — den cockpitOS Integrations-API-Key eintragen (aus Cockpit → Einstellungen → Integrationen).

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.

---

Integrations-API-Key für MCP: wo bekommt man ihn?

• Geht zu Cockpit Dashboard → Einstellungen → API & Integrationen (Karte AgencyOS – API-Keys — historischer Name; Key gilt für cockpitOS MCP).
• Neuen Key erzeugen — er beginnt immer mit sk_agencyos_. Den vollständigen Key siehst du einmalig im Dialog.
• Sicher im Passwort-Manager ablegen, dann in Render eintragen.
• Nur lesen (ohne Key): Die cockpit_public_*-Tools funktionieren ohne Key — nützlich zum Testen.

---

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