MCP Server

Verbinden Sie ein externes KI-Programmierwerkzeug — Claude Code, Codex oder Antigravity — direkt mit Ihrem AiTalk-Konto. Danach beschreiben Sie in normaler Sprache, was Sie möchten, und die KI baut es: Agenten, Workflows, Wissensdatenbank.

Was es ist

MCP (Model Context Protocol) ist ein Standard, über den ein KI-Werkzeug einen externen Dienst nutzt. AiTalk ist dabei der MCP-Server, Ihr KI-Werkzeug der Client.

Ihr KI-Werkzeug (Claude Code / Codex / Antigravity)
        │
        │  Authorization: Bearer aitk_...
        ▼
AiTalk MCP-Server  ──→  Ihre Agenten, Workflows, Wissensdatenbank, Unterhaltungen

Was die verbundene KI tun kann:

Was nicht möglich ist:

• Workflows oder Agenten löschen — dafür das Dashboard nutzen
• Einen Test ausführen — dafür das Dashboard nutzen
• Abonnement, Abrechnung oder Credits ändern
• Auf Daten anderer Kunden zugreifen. Jede Anfrage ist auf das Konto beschränkt, dem das Token gehört

Warum Sie ein Zugriffstoken brauchen

Mit dem Zugriffstoken weist sich Ihr KI-Werkzeug als Sie aus. Einen anderen Weg gibt es nicht — ohne Token wird jede Anfrage an den MCP-Server abgewiesen. Es kann sich nichts verbinden, bevor Sie das erste Token erstellt haben.

Wichtig zu wissen:

• Das Token wird nur einmal angezeigt, direkt nach dem Erstellen. Kopieren Sie es sofort. Wenn Sie es verlieren, widerrufen Sie es und erstellen ein neues.
• Schreibzugriff ist standardmässig aktiviert, damit die KI erstellen und bearbeiten kann. Deaktivieren Sie ihn für ein Token mit reinem Lesezugriff (nützlich, wenn die KI nur schauen, aber nichts ändern soll).
• Sie können bis zu 5 Token haben. Ein Token pro Gerät oder pro Werkzeug ist eine gute Gewohnheit — so lassen sie sich einzeln widerrufen.
• Behandeln Sie ein Token wie ein Passwort. Wer es besitzt, kann in Ihrem Konto als Sie handeln.

Einrichtung

Schritt 1: Token erstellen

1. Gehen Sie in AiTalk zu Einstellungen → MCP-Server
2. Geben Sie einen Namen ein — das Gerät oder Werkzeug, auf dem Sie es verwenden, z. B. Claude Code - MacBook
3. Lassen Sie Schreib-Tools erlauben aktiviert (abwählen für ein Nur-Lese-Token)
4. Klicken Sie auf Token erstellen
5. Kopieren Sie das Token jetzt — es wird nur einmal angezeigt

Schritt 2: AiTalk in Ihrem KI-Werkzeug hinzufügen

Wählen Sie unter KI-Tool verbinden den Tab Ihres Werkzeugs. Der angezeigte Befehl enthält Ihr neues Token bereits — kopieren Sie ihn und verwenden Sie ihn wie unten beschrieben.

Claude Code — Befehl im Terminal ausführen:

claude mcp add --transport http aitalk https://www.aitalk.ch/api/mcp-server \
  --header "Authorization: Bearer aitk_IHR_TOKEN"

Claude Desktop — Einstellungen → Entwickler → Konfiguration bearbeiten, Ausschnitt einfügen, App neu starten. Node.js (npx) erforderlich. Speicherort der Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Codex — Ausschnitt in ~/.codex/config.toml einfügen. In der Codex-App: New MCP → Type = Streamable HTTP, dann URL und einen Authorization: Bearer-Header eintragen.

Antigravity — Ausschnitt in ~/.gemini/config/mcp_config.json einfügen (Settings → Customizations → Open MCP Config), dann aktualisieren.

Schritt 3: Ihre KI fragen

Sprechen Sie einfach mit ihr. Zum Beispiel:

• „Zeige meine AiTalk-Agenten und Workflows"
• „Erkläre mir, was der Kundendienst-Workflow macht"
• „Erstelle einen Workflow aus der FAQ-Vorlage und setze die Begrüssung auf ..."
• „Füge diesen Text zu meiner Wissensdatenbank hinzu"
• „Schalte den Terminbuchungs-Workflow live"

Die KI liest die eingebauten AiTalk-Anleitungen selbst — Sie müssen ihr nicht erklären, wie Workflows aufgebaut sind.

Zugriffe überwachen

An zwei Stellen sehen Sie, wie Ihre Token verwendet werden:

• Einstellungen → MCP-Server — jedes Token, mit letztem Verwendungszeitpunkt sowie IP-Adresse und Land des Zugriffs
• Dashboard — die Übersicht: wie viele Token Sie haben und wann sowie von wo der letzte Zugriff erfolgte

Wenn Sie einen Zugriff sehen, den Sie nicht zuordnen können, widerrufen Sie dieses Token sofort (Papierkorb-Symbol daneben). Verbundene Werkzeuge verlieren den Zugriff unmittelbar.

Das Land wird aus der IP-Adresse der Verbindung ermittelt. Bei einem VPN oder einem in der Cloud betriebenen KI-Werkzeug erscheint das Land dieses Servers, nicht Ihres.

Schutzmechanismen

Einige Grenzen sorgen dafür, dass ein Versehen — oder eine KI, die eine Anweisung falsch versteht — keinen stillen Schaden anrichtet:

• Veröffentlichen ist sichtbar. Einen Workflow live zu schalten ist eine bewusste Handlung. Wenn Sie vorher prüfen möchten, lassen Sie Ihre KI stattdessen eine Veröffentlichung anfragen: Sie erhalten einen Link, den Sie selbst öffnen und auf dem Sie Deploy klicken.
• Änderungen an einem Live-Workflow erreichen Ihre Kunden sofort. Die KI ist angewiesen, das vorher mit Ihnen abzustimmen.
• Geheimnisse werden nie herausgegeben. API-Schlüssel, Passwörter und Token in Ihren Workflows werden maskiert, bevor etwas den Server verlässt — eine verbundene KI kann sie nicht lesen.
• Ratenbegrenzungen gelten pro Token (Lese- und Schreibzugriffe getrennt).
• Jeder Aufruf wird protokolliert — welches Werkzeug ausgeführt wurde, ob es erfolgreich war und wie lange es dauerte.

Fehlerbehebung

Fragen?

Schreiben Sie uns an support@aitalk.ch.