Zum Hauptinhalt springen

alfima mit Claude Code verbinden (MCP-Server)

So verbindest du deinen alfima-Account per MCP mit Claude Code: API-Key erstellen, Server hinzufügen, Verbindung prüfen — inklusive der Aktionen, die aus Sicherheitsgründen gesperrt sind.

F
Verfasst von Finn Korte

alfima stellt einen MCP-Server bereit (Model Context Protocol). Damit kann eine KI wie Claude direkt in deinem alfima-Konto arbeiten: Produkte anlegen und ändern, Links und Seiten verwalten, Newsletter und Automationen vorbereiten, Verkäufe und Analytics auswerten — im Dialog, ohne dass du selbst durch das Dashboard klickst.

⚠️ Wichtig — Stand 7. August 2026: nur Claude Code

Der alfima-MCP-Server lässt sich ausschließlich mit Claude Code verbinden (dem Terminal-/IDE-Werkzeug von Anthropic).

Mit der normalen Claude-App — also Claude Desktop, claude.ai im Browser oder die Mobile-App — funktioniert die Verbindung aktuell nicht. Dort werden externe Server als „Connectors" eingebunden, und die verlangen eine OAuth-Anmeldung. Unser Server authentifiziert sich über einen API-Key im Anfrage-Header, und genau den kann man in der Claude-App nicht hinterlegen. Versuche es also gar nicht erst über die Connector-Einstellungen von Claude Desktop — das kann derzeit nicht klappen.

Wir arbeiten daran, das später auch für die Claude-App zu ermöglichen. Sobald es so weit ist, aktualisieren wir diesen Artikel.

Voraussetzungen

  • Ein alfima-Account mit aktivem Abo (bzw. laufender Testphase)

  • Ein alfima-API-Key mit Zugriffslevel „Full access" (siehe nächster Abschnitt)

  • Claude Code, installiert und eingeloggt. Die Installation dauert wenige Minuten und ist im Claude-Code-Quickstart beschrieben. Du brauchst dafür ein eigenes Claude-Abo bei Anthropic — das ist unabhängig von deinem alfima-Abo.

Schritt 1: API-Key in alfima erstellen

  1. Logge dich bei alfima ein.

  2. Gehe zu Einstellungen → API-Keys.

  3. Klicke auf API-Key erstellen und vergib einen Namen, z. B. „Claude Code".

  4. Wähle als Zugriffslevel „Full access". Das ist zwingend nötig: Ein Key mit „Read-only" funktioniert für MCP nicht, weil das MCP-Protokoll technisch jede Anfrage als Schreibvorgang sendet — auch reine Abfragen. Ein Read-only-Key wird deshalb komplett abgelehnt.

  5. Optional: ein Ablaufdatum setzen.

  6. Der Key wird nur einmalig angezeigt. Kopiere ihn sofort. Alle Keys beginnen mit alf_.

Schritt 2: alfima in Claude Code hinzufügen

Öffne dein Terminal und führe diesen Befehl aus — ersetze dabei alf_dein_api_key_hier durch deinen Key:

claude mcp add --transport http alfima https://app.alfima.com/mcp --header "Authorization: Bearer alf_dein_api_key_hier"

Standardmäßig gilt die Verbindung nur für den Ordner, in dem du den Befehl ausführst. Wenn du alfima in allen deinen Projekten nutzen möchtest, hänge --scope user an:

claude mcp add --transport http alfima https://app.alfima.com/mcp --header "Authorization: Bearer alf_dein_api_key_hier" --scope user

Die vollständige Referenz zu MCP-Servern in Claude Code findest du in der offiziellen Claude-Code-Dokumentation.

Schritt 3: Verbindung prüfen

Im Terminal zeigt dir dieser Befehl alle Server samt Status:

claude mcp list

Bei alfima sollte „Connected" stehen. Innerhalb einer laufenden Claude-Code-Sitzung kannst du den Status außerdem jederzeit mit dem Befehl /mcp aufrufen.

Danach kannst du einfach loslegen, zum Beispiel:

  • „Zeig mir meine alfima-Produkte."

  • „Leg in alfima ein Download-Produkt für 29 € mit dem Namen … an."

  • „Wie viel Umsatz habe ich in den letzten 30 Tagen gemacht?"

  • „Erstelle einen Newsletter-Entwurf zum Thema …"

Möchtest du die Verbindung wieder entfernen:

claude mcp remove alfima

Was Claude über alfima steuern kann

  • Produkte: auflisten, ansehen, anlegen, bearbeiten

  • Kursinhalte: Module und Lektionen anlegen und bearbeiten

  • Links: anlegen, bearbeiten, auflisten

  • Seiten (Page Builder): auflisten, per KI generieren oder HTML importieren, veröffentlichte Seiten zurück auf Entwurf setzen

  • Newsletter & Automationen: Entwürfe erstellen und bearbeiten, Automationen aufbauen (Pro)

  • Rabattcodes, Cross-Sells, Up-Sells, Ratenpläne

  • Instagram-Auto-DMs (Pro, mit verbundenem Instagram-Konto)

  • Verkäufe & Analytics: Transaktionen ansehen, CSV-Exporte anstoßen, Umsatz-, Aufruf- und Conversion-Zahlen abfragen

  • Termin-Verfügbarkeiten, Steuereinstellungen und Rechtstexte lesen

Was bewusst gesperrt ist

Im alfima-Dashboard bestätigst du kritische Aktionen über eine Sicherheitsabfrage. In Claude Code gibt es diese Rückfrage nicht — ein einzelner Befehl würde sonst sofort echte Mails verschicken oder Daten löschen. Deshalb sind folgende Aktionen über MCP komplett deaktiviert:

  • Newsletter versenden oder terminieren (Entwürfe schreiben geht)

  • Alle Löschvorgänge (Produkte, Seiten, Newsletter, Automationen, Rabattcodes …)

  • Abos kündigen, Zugänge entziehen, Ratenpläne deaktivieren, Automationen scharf schalten

Diese Dinge machst du weiterhin selbst im Dashboard. Fragst du Claude trotzdem danach, bekommt es eine Fehlermeldung zurück und verweist dich aufs Dashboard.

Kundendaten bleiben außen vor: Über den MCP-Server werden keine personenbezogenen Kundendaten übertragen — keine Namen, E-Mail-Adressen oder Anschriften. In Verkaufs- und Abo-Daten tauchen Kunden nur als Nummer auf. Kontakte verwaltest du im Dashboard oder über die REST-API.

Sicherheit: Behandle den Key wie ein Passwort

  • Ein „Full access"-Key erlaubt vollen Zugriff auf dein alfima-Konto. Gib ihn nicht weiter und lege ihn nicht in einem Projektordner ab, den du auf GitHub o. Ä. hochlädst.

  • Nutze den Scope-Hinweis aus Schritt 2 bewusst: Mit --scope user liegt der Key in deiner persönlichen Claude-Konfiguration und nicht im Projekt.

  • Ist ein Key abhandengekommen, kannst du ihn in Einstellungen → API-Keys jederzeit widerrufen oder rotieren (rotieren erzeugt einen neuen Key und macht den alten sofort ungültig).

  • Vergib am besten ein Ablaufdatum und einen eigenen Key pro Gerät — so kannst du gezielt einzelne Zugänge abschalten.

Wenn etwas nicht funktioniert

Symptom

Ursache und Lösung

„Needs authentication" oder Fehler 401

Der Key fehlt, ist falsch kopiert oder abgelaufen. Achte darauf, dass im Header wirklich Bearer alf_… steht (mit dem Wort „Bearer" und einem Leerzeichen davor).

Fehler 403 mit „read-only"

Du hast einen Read-only-Key verwendet. Erstelle einen neuen Key mit Full access.

Fehler 403 mit „subscription inactive"

Dein alfima-Abo ist nicht aktiv. Prüfe deine Zahlungsdaten im Dashboard.

Fehler 429

Zu viele Anfragen — pro Key sind bis zu 300 Anfragen pro Minute erlaubt. Kurz warten, dann geht es weiter.

„pro_required"

Die Aktion (z. B. Newsletter oder Automationen ändern) setzt ein Pro-Abo voraus.

Claude behauptet, etwas gesendet oder gelöscht zu haben

Diese Aktionen sind gesperrt (siehe oben) — prüfe im Dashboard nach. Melde uns solche Fälle gern.

Du möchtest stattdessen Zapier, Make oder n8n anbinden? Dann nutze die alfima REST-API.

Bei Fragen oder Problemen: kontaktiere den alfima-Support — wir helfen dir gern bei der Einrichtung.

Verwandte Artikel
Hat dies deine Frage beantwortet?