Zielgruppen definieren, analysieren, verstehen.

Zugänge im Vergleich

Beide Zugänge sprechen dieselbe Datenbasis, dasselbe Rechtemodell und dasselbe Guthaben an. Was für Authentifizierung, Beispielprojekte, Credits und Fehlercodes gilt, gilt für beide.

Lizenzen

AIlon ist als Dashboard und als programmatischer Zugang verfügbar — das sind zwei getrennte Lizenzen:

• Die Dashboard-Lizenz gibt Zugriff auf dashboard.ailon.io.
• Die API-/MCP-Lizenz stellt das Credit-Guthaben für programmatische Abfragen bereit. Sie deckt beide Zugänge ab: REST und MCP erfordern keine separaten Lizenzen.

Zugang & Authentifizierung

Der Zugang ist benutzerbezogen: Sichtbar sind ausschließlich Projekte und Zielgruppen, auf die dieser Benutzer im Dashboard Zugriff hat. Das gilt unabhängig davon, ob der Zugriff über die REST-API oder über den MCP-Server erfolgt.

API-Key erhalten

Den Key erzeugen Sie selbst im Dashboard: auf der Startseite von dashboard.ailon.io rechts in der Karte AIlon Integrationen. Ein Kontakt zum Support ist nicht nötig.

REST API · Bearer-Token

Jede Anfrage außer GET /health/ benötigt folgenden Header. Ein ungültiger oder fehlender Key führt zu 401 Unauthorized.

Authorization: Bearer ailpk_….IhrGeheimerTeil

MCP-Server · OAuth

Der MCP-Server nutzt keinen manuell hinterlegten Key, sondern OAuth 2 mit PKCE. Sie tragen im Client lediglich die Server-URL ein; alles Weitere läuft über den Browser:

1. Weiterleitung. Der Client öffnet die AIlon-Anmeldung. Sind Sie noch nicht angemeldet, erscheint zuerst die normale Anmeldemaske.
2. Bestätigung. AIlon zeigt den angemeldeten Benutzer, die Organisation und die angefragte Berechtigung Access AIlon MCP tools.
3. Rücksprung. Nach Authorize springt der Browser zurück in den Client, die Verbindung steht.

Die Freigabe gilt pro Client — ChatGPT und Claude autorisieren Sie also getrennt.

OAuth-Parameter für eigene Clients

authorization_endpoint:  https://mcp.ailon.io/authorize/
scope:                   ailon:mcp
resource:                https://mcp.ailon.io
code_challenge_method:   S256   # PKCE erforderlich

Gängige Clients wie Claude, ChatGPT oder Cursor bringen den Ablauf mit und registrieren sich selbst — dort genügt die Server-URL.

Organisationen & Rechte

Jeder Benutzer kann eine eigene Organisation gründen und darin Organisationsprojekte anlegen. Innerhalb einer bestehenden Organisation vergibt die Administratorin die Rechte individuell — wer also keine Organisationsprojekte anlegen kann, wendet sich an sie. Wer das ist, steht im Dashboard unter Organisation → Übersicht.

Projekte ohne organisation_id sind privat und nur für den anlegenden Benutzer sichtbar — über beide Zugänge gleichermaßen.

Kostenlose Nutzung in Beispielprojekten gilt für beide Zugänge

Projekte mit dem Feld "public": true sind Beispielprojekte (im Dashboard: Demo-Projekte). Über die REST-API finden Sie sie mit GET /projects/?public=true, über MCP mit list_projects.

Für Einstieg und Experimente mit Insights empfiehlt sich daher ein Beispielprojekt mit bereits berechneten Zielgruppen (Feld calculated_audience_ids). In eigenen Projekten (public: false) können credit-pflichtige Abrufe das Guthaben belasten — Details dazu im nächsten Abschnitt.

Credits & Abrechnung gilt für beide Zugänge

Gilt ausschließlich für Zielgruppen in eigenen Projekten — Beispielprojekte sind immer kostenlos. Abgerechnet wird der Datenabruf, nicht der Zugangsweg: Über MCP entstehen keine zusätzlichen Kosten.

• Credits kosten der Abruf von Insight-Daten (GET /insights/{id}/data/ bzw. get_insight_data) sowie die KI-generierte Zielgruppen-Zusammenfassung (.../summary/, ein Credit). Projekte anlegen, Zielgruppen erzeugen, Merkmale suchen und alle Listenabrufe sind kostenfrei.
• Abgebucht wird ausschließlich bei erfolgreicher Antwort (status: SUCCESS) — Zwischenstände (CALCULATING) sind kostenlos.
• Berechnet wird je Zielgruppe und je Aufruf. Ein Vergleich von vier Zielgruppen über dieselbe Feature-Kategorie kostet das Vierfache.
• Das Guthaben gehört dem zugreifenden Benutzer und ist über beide Zugänge dasselbe. Standardmäßig darf es nicht unter null fallen.
• Ein von AIlon festgelegtes Überziehungslimit (min_balance) ist über GET /usage/credit-limit/ einsehbar. Reicht das Guthaben nicht aus, antwortet die API mit 402 Payment Required.

Preisstufen

Die rund 5.100 Merkmale sind in 17 Feature-Kategorien gebündelt, die sich in drei Preisstufen aufteilen. Die Stufe ist am Präfix des Namens erkennbar.

Die tatsächliche Abbuchung steht nach dem Aufruf in der Antwort: bei MCP im Feld billing mit credits_charged, balance_before und balance_after. Vorab prüfen lässt sich der Preis über GET /insights/{id}/credit-cost/ bzw. über den credit_cost aus list_feature_categories.

curl -s -H "Authorization: Bearer IHR_API_KEY" \
  https://dashboard.ailon.io/public-api/v1/usage/

Datenschutz & Betrieb

Was beim MCP-Zugriff wohin geht

Beim Zugriff über einen KI-Client verarbeitet dessen Anbieter zwangsläufig die Konversation: Ihre Fragen, die Antworten des Modells sowie die Daten, die der MCP-Server zurückliefert und die das Modell für seine Antwort benötigt. Welche Aufrufe der Agent auslöst, ist im Client sichtbar. Für welche Zwecke der Anbieter diese Inhalte verwendet und wie lange er sie speichert, richtet sich nach dessen Bedingungen und Ihren dortigen Einstellungen — darauf hat AIlon keinen Einfluss.

Die REST-API kennt diesen Weg nicht: Dort fließen Daten ausschließlich zwischen Ihrem System und AIlon.

Auftragsverarbeitung

Vertragliche Regelungen zur Datenverarbeitung stimmen wir individuell ab. Anfragen richten Sie an kontakt@erason.de.

Referenz für KI-Agenten

Kompakte, maschinenlesbare Orientierung für LLM-gestützte Tools. Eine reine Textversion dieser Seite steht zusätzlich unter /llms.txt bereit.

server_url:  https://mcp.ailon.io
transport:   Remote MCP über HTTPS
auth:        OAuth 2 mit PKCE · scope ailon:mcp · Freigabe je Client
tools:       whoami · list_projects · list_audiences · create_project · generate_audience
             list_feature_categories · list_features_of_category · search_features
             get_insight_data · get_playbook
free_tier:   Projekte mit "public": true → Abrufe kostenlos, kein Anlegen möglich
credits:     nur get_insight_data; je Zielgruppe und je Aufruf; Verbrauch steht
             in der Antwort unter billing

# Empfohlener Ablauf für Agenten:
get_playbook          # passenden Arbeitsablauf laden
list_projects         # Kontext ermitteln
search_features       # reale Merkmale statt geratener Namen verwenden
generate_audience     # Zielgruppe anlegen und berechnen lassen
get_insight_data      # Kennwerte für bis zu 20 Zielgruppen vergleichen

base_url:      https://dashboard.ailon.io/public-api/v1/
auth:          Header Authorization: Bearer <ailpk_...>  # bei allen Endpunkten außer /health/
format:        application/json
no_auth_endpoint: GET /health/
free_tier:      Zielgruppen in Projekten mit "public": true → alle Insight-/Summary-Anfragen kostenlos
pagination:     Query-Parameter limit + offset; Antwort enthält items, count, limit, offset
errors:         401 ungültiger Key · 402 zu wenig Credits · 403 kein Zugriff/Beispielprojekt read-only
              404 nicht gefunden · 503 Zielgruppe wird noch berechnet

# Empfohlener Ablauf:
GET  /health/                                        # Erreichbarkeit prüfen, kein Auth nötig
GET  /whoami/                                         # Key validieren
GET  /projects/?public=true                           # kostenloses Beispielprojekt finden
GET  /projects/{project_id}/audiences/                # berechnete audience_id ermitteln
GET  /insights/                                        # insight_id + credit_cost ermitteln
GET  /insights/{insight_id}/data/?audience_id=...     # Analyse-Daten abrufen; ggf. bei status=CALCULATING erneut abfragen

Schnellstart REST API

Sechs Aufrufe genügen, um vom leeren Terminal zu echten Insight-Daten zu kommen. Alle Beispiele nutzen ein Beispielprojekt (public: true) — dort sind Insight-Anfragen unabhängig vom angezeigten credit_cost immer kostenlos.

1. API erreichbar? GET /health/ beantwortet ohne Authentifizierung, ob die API läuft und welche Version aktiv ist.
2. API-Key gültig? GET /whoami/ bestätigt, welchem Benutzer und welcher Organisation der Key gehört.
3. Beispielprojekt wählen. GET /projects/?public=true liefert Projekte, an denen Sie kostenlos experimentieren können. Merken Sie sich eine id sowie eine ID aus calculated_audience_ids.
4. Zielgruppe prüfen. GET /projects/{project_id}/audiences/ zeigt die berechneten Zielgruppen des Projekts inklusive Segmenten.
5. Feature-Kategorie auswählen. GET /insights/ listet alle verfügbaren Kategorien mit id, display_name und credit_cost.
6. Daten abrufen. GET /insights/{insight_id}/data/?audience_id={audience_id} liefert die eigentlichen Analyse-Daten.

Anfragemuster (gilt für alle Endpunkte)

Jeder Endpunkt außer /health/ erwartet denselben Authorization-Header. Ersetzen Sie für andere Endpunkte lediglich Methode, Pfad und ggf. den JSON-Body.

# cURL
curl -s -H "Authorization: Bearer IHR_API_KEY" \
  https://dashboard.ailon.io/public-api/v1/whoami/

# Python (requests)
import requests

response = requests.get(
    "https://dashboard.ailon.io/public-api/v1/whoami/",
    headers={"Authorization": "Bearer IHR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

// JavaScript (fetch)
const response = await fetch("https://dashboard.ailon.io/public-api/v1/whoami/", {
  headers: { Authorization: "Bearer IHR_API_KEY" },
});
console.log(await response.json());

Endpunkt-Übersicht REST API

Pagination REST API

Listen-Endpunkte (/projects/, /projects/{id}/audiences/, /usage/requests/, /usage/ledger/) akzeptieren limit und offset und antworten in diesem Format:

{
  "items": [ … ],
  "count": 250,
  "limit": 100,
  "offset": 0
}

Weitere Seiten laden: offset so lange erhöhen, bis offset + len(items) >= count.

Erste Schritte

{ "status": "ok", "api_version": "v1" }

{
  "user_id": 42,
  "username": "max.mustermann",
  "organisation_id": 7,
  "organisation_name": "Beispiel GmbH",
  "api_key_name": "Produktion",
  "api_key_prefix": "ailpk_abc123"
}

Projekte & Zielgruppen

Projekte enthalten Zielgruppen (Audiences) und deren Segmente. Norm-Zielgruppen werden in den Listen nicht mitgeliefert.

curl -s -H "Authorization: Bearer IHR_API_KEY" \
  "https://dashboard.ailon.io/public-api/v1/projects/?public=true&limit=10"

curl -s -X POST -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sommerkampagne 2026", "description": "Neuprodukt-Launch"}' \
  https://dashboard.ailon.io/public-api/v1/projects/

curl -s -X POST -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Tech-affine Millennials", "prompt": "25-40 Jahre, hohe Online-Affinität"}' \
  https://dashboard.ailon.io/public-api/v1/projects/PROJECT_ID/generate_audience/

{ "potential_relative": 0.184, "potential_absolute": 1284000 }

[
  { "type": "paragraph", "data": "Diese Zielgruppe zeichnet sich durch …" }
]

Insights = Feature-Kategorien

Insights sind thematische Bündel von Merkmalen (z. B. Soziodemografie, Kaufverhalten, Marken), die auf eine berechnete Zielgruppe angewendet werden. Über MCP heißen sie Feature-Kategorien; die IDs sind dieselben.

[
  { "id": 4093, "display_name": "Basic | Soziodemografie",
    "description": "Geschlecht, Bildung, Anzahl Kinder, Bundesländer, Haushaltsnetto, …",
    "credit_cost": "1.00" },
  { "id": 4258, "display_name": "Extended | Kaufverhalten, Konsumpräferenzen und Einkaufsorte",
    "description": "Online-Shopping, Preisbewusstsein: Lebensmittel, Kaufabsicht: Smartphone, …",
    "credit_cost": "3.00" },
  { "id": 4193, "display_name": "Plus | Marken",
    "description": "Volkswagen, Apple, Kneipp, JYSK, Fritz-Cola, Miele, New Balance, …",
    "credit_cost": "10.00" }
]

curl -s -H "Authorization: Bearer IHR_API_KEY" \
  "https://dashboard.ailon.io/public-api/v1/insights/INSIGHT_ID/data/?audience_id=AUDIENCE_ID"

{
  "insight_id": 4093, "audience_id": 55, "status": "SUCCESS", "error": null, "error_code": null,
  "data": [
    {
      "feature": { "id": 3, "display_name": "Alter" },
      "options": [
        { "option": { "id": 31, "display_name": "25-34" },
          "index_value": 142.0, "mean_pop": 0.18, "mean_audience": 0.26, "abs_audience": 331000 }
      ]
    }
  ]
}

Nutzung & Abrechnung

MCP-Server

Der AIlon MCP-Server macht dieselben Daten in KI-Clients nutzbar — in Claude, ChatGPT, Cursor, VS Code oder in einem eigenen Agent. Sie verbinden den Server einmal, danach kann der Agent Zielgruppen finden, neue Zielgruppen anlegen und berechnen lassen, Merkmale durchsuchen und Kennwerte für bis zu 20 Zielgruppen vergleichen.

Einrichtung MCP-Server

1. Server verbinden. Fügen Sie in Ihrem Client einen eigenen MCP-Server bzw. Connector hinzu und tragen Sie als URL https://mcp.ailon.io ein. Als Namen empfehlen wir AIlon, damit der Agent den Zusammenhang zu Ihren Fragen herstellt. Wo genau dieser Menüpunkt liegt, unterscheidet sich je Client — die Bezeichnung lautet meist „Connector“, „MCP Server“ oder mcp.json.
2. Autorisieren. Der Client öffnet die AIlon-Anmeldung im Browser. Bestätigen Sie die Berechtigung Access AIlon MCP tools und klicken Sie auf Authorize. Ein Key muss nirgends eingetragen werden.
3. Verbindung prüfen. Fragen Sie Ihren Agent nach Benutzer und Guthaben. Er ruft whoami auf und antwortet mit Benutzer, Organisation und Credit-Stand. Kommt eine Antwort, steht die Verbindung.
4. Erster kostenfreier Test. Beispielprojekte kosten keine Credits und eignen sich für den ersten Durchlauf.

Clients verbinden Stand: August 2026

Server-URL und Anmeldung sind überall identisch — es unterscheidet sich nur, wo der Menüpunkt liegt. Da sich die Oberflächen der Clients derzeit häufig ändern, verlinken wir zu jedem Abschnitt die Herstellerdokumentation.

Claude

Verfügbar in Claude im Browser, in Claude Desktop und in Cowork. Ein einmal eingerichteter Connector steht in allen Claude-Produkten desselben Kontos zur Verfügung.

1. Einstellungen öffnen. Im Browser über das Profilsymbol, in Claude Desktop über Strg+, bzw. ⌘+,. Dann links Connectors wählen.
2. Connector anlegen. Auf das + neben „Connectors“ klicken und Add custom connector wählen. Als Name AIlon eintragen, als URL https://mcp.ailon.io. Die Felder unter „Advanced settings“ für OAuth Client ID und Secret bleiben leer — der AIlon-Server registriert den Client selbst.
3. Verbinden. Nach Add erscheint der Connector mit der Kennzeichnung Custom in der Liste. Über Connect starten Sie die Anmeldung bei AIlon.
4. Im Chat aktivieren. Ein hinzugefügter Connector ist nicht automatisch in jedem Chat aktiv — im Werkzeugmenü des Chats prüfen.

Herstellerdokumentation

Get started with custom connectors using remote MCP

ChatGPT

Eigene MCP-Connectoren sind in ChatGPT nur im Developer Mode verfügbar. Ohne diesen Schalter erscheint die Schaltfläche zum Anlegen gar nicht erst — das ist die mit Abstand häufigste Fehlerquelle.

1. Developer Mode aktivieren. Unter Settings → Apps & Connectors → Advanced settings. In Business-, Enterprise- und Edu-Workspaces muss ein Admin ihn zuvor freischalten, unter Workspace Settings → Permissions & Roles → Connected Data.
2. Connector anlegen. Zurück unter Settings → Apps & Connectors einen eigenen Connector erstellen: Name AIlon, MCP-Server-URL https://mcp.ailon.io, als Authentifizierung OAuth.
3. Autorisieren. ChatGPT leitet zur AIlon-Anmeldung weiter. Nach Authorize springt der Browser zurück.
4. Im Chat aktivieren. Ein gespeicherter Connector ist noch nicht aktiv. Er muss im Chat ausgewählt werden — andernfalls ruft ChatGPT die Tools nicht auf.

Herstellerdokumentation

Developer mode and MCP apps in ChatGPT

GitHub Copilot

Copilot spricht MCP im Agent-Modus. Die Konfiguration liegt in einer JSON-Datei — entweder arbeitsbereichsweit in .vscode/mcp.json, damit das Team sie mit einchecken kann, oder in der persönlichen Konfiguration über die Befehlspalette (MCP: Open User Configuration). Für Remote-Server mit OAuth wird VS Code 1.101 oder neuer benötigt.

// .vscode/mcp.json
{
  "servers": {
    "ailon": {
      "type": "http",
      "url": "https://mcp.ailon.io"
    }
  }
}

1. Konfiguration speichern. Über dem Servereintrag erscheint eine Start-Schaltfläche. Ein Klick startet den Server und löst die Anmeldung bei AIlon im Browser aus.
2. Agent-Modus wählen. Im Copilot-Chat oben von Ask auf Agent umschalten. Ohne diesen Schritt bleiben die Tools ungenutzt.
3. Tools prüfen. Über das Werkzeugsymbol im Chatfenster erscheint die Liste der verbundenen Server. Dort sollten die zehn AIlon-Tools auftauchen.
4. Aufrufe bestätigen. Copilot fragt vor jedem Tool-Aufruf nach — bei den ersten Durchläufen also mit Rückfragen rechnen.

Herstellerdokumentation

Add and manage MCP servers in VS Code · Enhancing GitHub Copilot agent mode with MCP

Weitere Clients

Grundsätzlich funktioniert jeder Client, der Remote-MCP-Server über HTTPS unterstützt — darunter Cursor, n8n und eigene Agents auf Basis der MCP-SDKs. Benötigt wird immer nur die Server-URL https://mcp.ailon.io; die Anmeldung läuft über OAuth, siehe Authentifizierung.

Tool-Referenz MCP-Server

Alle Tools stehen nach dem Verbinden automatisch zur Verfügung. Der Agent wählt sie selbst aus — Sie müssen sie nicht kennen, um zu arbeiten. Die Übersicht hilft, wenn Sie den MCP-Server in ein eigenes Produkt einbauen.

Von allen Tools kostet einzig get_insight_data Credits. Zielgruppen anlegen und berechnen zu lassen ist kostenfrei — bezahlt wird erst die Auswertung.

Gut zu wissen

Playbooks MCP-Server

Damit ein Agent Zielgruppen methodisch sauber modelliert statt zu raten, liefert der Server hinterlegte Arbeitsabläufe mit. get_playbook ohne Argument gibt die aktuelle Liste zurück.

Troubleshooting MCP-Server

Tool ↔ Endpunkt

Wer prototypisch im Chat startet und später produktiv auf REST wechselt, findet hier den passenden Endpunkt — und umgekehrt.

Status- & Fehlercodes gilt für beide Zugänge

Zielgruppen-Status (Dashboard → API)

HTTP-Fehlercodes

Häufige Insight-error_codes

Fehlercodes aller Anfragen lassen sich zusätzlich über GET /usage/requests/ nachvollziehen. Über MCP gelten dieselben Ursachen; wie ein Fehler im Chat erscheint, entscheidet der jeweilige Client.

Datenmodelle gilt für beide Zugänge

Feldreferenz der wichtigsten Antwort- und Body-Schemas. Klappen Sie ein Modell auf, um alle Felder mit Typ und Beschreibung zu sehen.

Fehlende Merkmale & eigene Daten

Findet sich für ein gewünschtes Merkmal keine Entsprechung in AIlon, lässt es sich zur Aufnahme vorschlagen. Über dasselbe Formular läuft auch der Wunsch, eigene Daten aus CRM, POS, Kampagnen oder Marktforschung einzubringen und mit den rund 5.100 AIlon-Merkmalen anzureichern — das geschieht über AIlon SYNQ in einem eigenen Onboarding und nicht über API oder MCP.

Zum Formular für Merkmalswünsche und Datenintegration

Hintergrund zur Datengrundlage: Die Datenquellen von AIlon im Detail.