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 |
Claude über MCP
Abschnitt betitelt „Claude über MCP“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
REST-API
Abschnitt betitelt „REST-API“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:
- Melden Sie sich bei
https://roundtable.<tenant>.askalot.ioan und öffnen Sie Profileinstellungen → API-Tokens - Erzeugen Sie ein Token (die Gültigkeitsdauer wählen Sie selbst; das Token wird nur einmal angezeigt)
- 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.
Survey Presentation Format
Abschnitt betitelt „Survey Presentation Format“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.
Diese Dokumentation als Markdown
Abschnitt betitelt „Diese Dokumentation als Markdown“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.