Zum Inhalt springen
Wissensdatenbank

Integrationsmöglichkeiten

Askalot bietet drei sich ergänzende Integrationswege. Sie nutzen dieselben Plattformfunktionen und dasselbe Berechtigungsmodell – wählen Sie den, der zu der Art passt, wie Ihr System mit Askalot kommuniziert.

Integration Geeignet für Authentifizierung
Claude (MCP + Plugin) KI-Agenten, die den Forschungslebenszyklus im Gespräch steuern OAuth-2.1-Anmeldung im Browser
REST-API Server-zu-Server-Automatisierung, CI, eigene Anwendungen Persönliches API-Token (Header X-Api-Token)
Survey Presentation Format Darstellung laufender Umfragen in der Oberfläche Ihrer eigenen Anwendung Dieselben REST-Zugangsdaten

Mit dem MCP-Server von Askalot kann Claude (Claude.ai, Claude Desktop, Claude Code) Projekte, Fragebögen, Kampagnen und Datenanalysen direkt im Gespräch verwalten. Benutzer von Claude Code können zusätzlich das Askalot-Plugin installieren – Skills, Slash-Befehle und die MCP-Tools in einem Paket. Die Authentifizierung läuft über einen interaktiven OAuth-2.1-Ablauf; API-Schlüssel müssen Sie nicht verwalten.

→ Leitfaden zur Claude-Integration

Jede Plattformentität – Projekte, Fragebögen, Kampagnen, Befragte, Umfragen, Bundles, Pools, Strategien – ist unter https://portor.<tenant>.askalot.io/api/v1 verfügbar, mit einer OpenAPI-3.0-Spezifikation und interaktiver Swagger-Oberfläche unter /api/v1/docs.

Die Authentifizierung erfolgt mit einem persönlichen API-Token:

  1. Melden Sie sich bei https://roundtable.<tenant>.askalot.io an und öffnen Sie Profileinstellungen → API-Tokens
  2. Erzeugen Sie ein Token (die Gültigkeitsdauer wählen Sie selbst; das Token wird nur einmal angezeigt)
  3. Senden Sie es bei jeder Anfrage im Header X-Api-Token

Das Token übernimmt die Rollen und Berechtigungen Ihres Kontos und kann jederzeit widerrufen werden – der Widerruf wirkt sofort. Der Header Authorization: Bearer ist in der REST-API für OAuth-Zugriffstokens reserviert (die Zugangsdaten, die der MCP-Transport verwendet); API-Tokens werden immer in X-Api-Token übertragen.

→ Referenz der REST-API

Statt eine im Askalot-Stil gestaltete Umfrageseite einzubetten, kann Ihre Anwendung eine Umfragesitzung Item für Item steuern und jede Frage mit ihren eigenen UI-Komponenten darstellen. Jeder Schritt kommt als in sich geschlossenes JSON-Dokument an – Fragentitel, Spezifikation des Steuerelements und gültige Optionen –, während die Engine von Askalot Ablauflogik, Verzweigungen und Validierung auf dem Server behält.

→ Survey Presentation Format

KI-Agenten und Werkzeuge können diese Dokumentation statt als HTML als reines Markdown lesen:

Was Sie brauchen Wo Sie es bekommen
Ein Verzeichnis aller Seiten mit je einer einzeiligen Zusammenfassung https://docs.askalot.io/llms.txt
Die gesamte Dokumentation in einer Datei https://docs.askalot.io/llms-full.txt
Eine einzelne Seite Hängen Sie index.md an die Seitenadresse an, zum Beispiel https://docs.askalot.io/integrations/claude/index.md
Eine einzelne Seite, ohne ihre Adresse zu ändern Rufen Sie die Seite mit dem Header Accept: text/markdown ab

Das Markdown enthält denselben Inhalt, den Sie auf der Seite sehen, und die Links darin sind absolut, sodass ein Agent ihnen von jedem Ausgangspunkt aus folgen kann. Ein über MCP verbundener Claude kann die Dokumentation außerdem mit den Dokumentations-Tools durchsuchen und lesen.