Claude-Integration
Mit dem MCP-Server von Askalot kann Claude Umfragen, Kampagnen, Befragte und Datenanalysen direkt im Gespräch verwalten. Dieser Leitfaden beschreibt die Einrichtung für alle Claude-Oberflächen.
Überblick
Abschnitt betitelt „Überblick“Die Integration stellt 127 Tools bereit, von denen jedes genau einem von siebzehn Toolsets angehört. Mit genau diesen Namen können Sie eine Verbindung über ?toolsets= eingrenzen – siehe Die Tools einer Verbindung eingrenzen.
| Toolset | Tools | Beispiele |
|---|---|---|
sampling |
23 | Befragte, Pools, Stichprobenstrategien – anlegen, ziehen, aktualisieren, Vorschau |
fielding |
21 | Umfragen, Einladungen, Arbeitslast der Interviewer, der Antwortablauf, synthetische Befüllung |
analysis |
20 | Bundles, die Pipeline Bronze/Silver/Gold, Auswahl für die Codierung, Qualität, Export |
questionnaire |
17 | QML-Dateien anlegen und verwalten, mit Z3 validieren, veröffentlichen, hochladen |
campaign |
8 | Kampagnen anlegen, einen Fragebogen zuordnen, einen Pool zuweisen |
project |
7 | Projekte anlegen, Projektinhaber verwalten |
documents |
4 | Ihre indexierten Forschungsdokumente durchsuchen und lesen |
methodology |
4 | 24 begutachtete Methodenartikel durchsuchen |
audit |
3 | Den Audit-Trail abfragen |
session |
4 | Sehen, in welchen Organisationen die Sitzung arbeiten darf, zwischen ihnen wechseln, Benutzer nachschlagen |
conversation |
4 | Das Gespräch eines Agentenlaufs aufzeichnen und wieder lesen |
docs |
3 | Die Askalot-Dokumentation durchsuchen und lesen |
paper |
3 | Den Forschungsbericht des Projekts lesen und verankert bearbeiten, die Beantwortbarkeitskette nachverfolgen |
composite |
3 | Eine ganze Kette in einem Aufruf ausführen – Feldphase, Simulation oder die Datensatz-Pipeline |
tasks |
1 | get_task_status – einen lang laufenden Job über die zurückgegebene task_id abfragen |
entitlements |
1 | Lesen, was Ihr Abonnement umfasst |
discovery |
1 | list_toolsets – was jedes Toolset enthält und welche Toolsets diese Verbindung angefordert hat |
Die Toolsets der letzten acht Zeilen stehen jeder Verbindung zur Verfügung, ganz gleich, welche sie anfordert; nur die ersten neun lassen sich mit ?toolsets= filtern.
Authentifizierung
Abschnitt betitelt „Authentifizierung“Askalot verwendet OAuth 2.1 mit PKCE und Dynamic Client Registration (RFC 7591). Claude wickelt den gesamten Ablauf automatisch ab – Sie melden sich nur mit Ihren Askalot-Zugangsdaten an, wenn Sie dazu aufgefordert werden.
So funktioniert es
Abschnitt betitelt „So funktioniert es“- Claude ermittelt die OAuth-Endpunkte von Askalot über
/.well-known/oauth-authorization-server - Claude registriert sich über
POST /registerals OAuth-Client (einmalig, automatisch) - Ein Browserfenster öffnet sich, in dem Sie sich unter
oidc.platform.askalot.ioanmelden - Nach der Anmeldung erhält Claude ein Zugriffstoken und verbindet sich mit dem MCP-Server
Es sind keine API-Schlüssel und keine manuelle Tokenverwaltung nötig.
OAuth-Endpunkte
Abschnitt betitelt „OAuth-Endpunkte“| Endpunkt | Zweck |
|---|---|
GET /.well-known/oauth-authorization-server |
Ermittlung der Server-Metadaten |
GET /.well-known/oauth-protected-resource/mcp |
Metadaten der geschützten Ressource |
POST /register |
Dynamic Client Registration |
GET /authorize |
Autorisierung (leitet zur OIDC-Anmeldung weiter) |
POST /token |
Tokenaustausch (authorization_code, refresh_token) |
POST /revoke |
Widerruf von Tokens |
Unterstützte Funktionen: Authorization Code mit PKCE (S256), Refresh-Tokens, Scopes (mcp:read, mcp:write, mcp:admin).
Mandanten-URL
Abschnitt betitelt „Mandanten-URL“Ersetzen Sie in allen folgenden URLs <tenant> durch die Kennung Ihres Mandanten. Gängige Mandanten:
dev– kostenlose Test- und Demo-Umgebung (Organisation ACME Corp)eu1– EU-Produktivumgebung (zahlende Kunden und Universitäten)
MCP-Endpunkt: https://portor.<tenant>.askalot.io/mcp
Claude.ai (Web)
Abschnitt betitelt „Claude.ai (Web)“- Rufen Sie claude.ai auf und öffnen Sie Settings
- Gehen Sie zu Integrations (oder Connectors)
- Klicken Sie auf Add Custom MCP Server
- Geben Sie ein:
- Name:
Askalot - URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Klicken Sie auf Connect – ein Browserfenster für die OAuth-Anmeldung öffnet sich
- Melden Sie sich mit Ihren Askalot-Zugangsdaten an und genehmigen Sie den Zugriff
Claude Desktop
Abschnitt betitelt „Claude Desktop“Claude Desktop verbindet sich mit Askalot als Remote-Custom-Connector – Sie erhalten nur die MCP-Tools bzw. die API (keine Agenten, Skills oder Befehle), und es gibt keine Desktop-Erweiterung (.mcpb) zum Installieren, weil Portor ein Remote-Server ist.
Einen Custom Connector hinzufügen (empfohlen)
Abschnitt betitelt „Einen Custom Connector hinzufügen (empfohlen)“- Öffnen Sie Settings → Connectors (in manchen Versionen unter Customize → Connectors)
- Klicken Sie auf Add custom connector
- Geben Sie ein:
- Name:
Askalot - Remote MCP server URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Klicken Sie auf Add – ein Browserfenster für die OAuth-Anmeldung öffnet sich
- Melden Sie sich mit Ihren Askalot-Zugangsdaten an und genehmigen Sie den Zugriff
Dem OAuth-Zugriff stimmen Sie einmalig und interaktiv zu; Claude Desktop speichert und erneuert das Token für Sie. Nach dem Verbinden erscheinen die Tools für Umfragen, Kampagnen, Datensätze und Analysen in der Tool-Liste des Connectors. Es gibt keinen API-Schlüssel und kein statisches Token zum Einfügen – Askalot verwendet OAuth 2.1.
Alternative über die Konfigurationsdatei
Abschnitt betitelt „Alternative über die Konfigurationsdatei“Wenn Sie die Konfigurationsdatei lieber direkt bearbeiten, fügen Sie den Remote-Server unter mcpServers in der Datei für Ihr System hinzu:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}Starten Sie Claude Desktop nach dem Speichern neu. Bei der ersten Nutzung öffnet sich ein Browserfenster für die OAuth-Anmeldung.
Claude Code (CLI)
Abschnitt betitelt „Claude Code (CLI)“Claude Code kann sich auf zwei Arten verbinden.
Das Askalot-Plugin installieren (voller Umfang)
Abschnitt betitelt „Das Askalot-Plugin installieren (voller Umfang)“/plugin marketplace add askalot-io/askalot-plugin/plugin install askalot@askalotDas Plugin bündelt die Askalot-Agenten, Skills, Slash-Befehle und die MCP-Tools. Seine MCP-Anbindung (.mcp.json) hat den Typ type: http, verweist auf ${ASKALOT_MCP_URL} und nutzt interaktives OAuth – kein statisches Bearer-Token. Setzen Sie ASKALOT_MCP_URL in Ihrer Shell, bevor Sie Claude Code starten:
export ASKALOT_MCP_URL="https://portor.<tenant>.askalot.io/mcp"Ist die Variable nicht gesetzt, verbindet sich das Plugin mit dem kostenlosen Testmandanten. Liegt Ihr Konto bei einem anderen Mandanten, gelingt die Anmeldung zwar, endet dann aber mit user_not_in_tenant. Die Meldung nennt den geprüften Mandanten, den Mandanten, für den Ihre Anmeldung galt, und dessen genaue URL. Setzen Sie die Variable auf diese URL und starten Sie Claude Code erneut.
Nur den MCP-Server hinzufügen
Abschnitt betitelt „Nur den MCP-Server hinzufügen“Wenn Sie nur die Tools möchten (ohne Agenten, Skills und Befehle):
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcpBei der ersten Nutzung öffnet Claude Code einen Browser für die OAuth-Anmeldung. Nach der Authentifizierung wird das Token lokal gespeichert und automatisch erneuert.
Anwendungsbeispiele
Abschnitt betitelt „Anwendungsbeispiele“Eine Umfragekampagne anlegen
Abschnitt betitelt „Eine Umfragekampagne anlegen“You: Create a customer satisfaction campaign with 50 test respondents.
Claude: I'll set up that campaign for you.
→ list_projects() — found "Customer Research" project→ create_campaign("CSAT Q1 2026", project_id, questionnaire_id, admits_volunteers=false, offers_ai_channel=false)→ bulk_create_respondents(50, project_id)→ create_respondent_pool("CSAT Pool", respondent_ids=...)→ assign_pool_to_campaign(campaign_id, pool_id)
Done! Campaign "CSAT Q1 2026" is ready with 50 respondents.Umfrageergebnisse analysieren
Abschnitt betitelt „Umfrageergebnisse analysieren“You: Extract and weight the results from my latest campaign.
Claude: I'll build a Bundle and derive a weighted dataset from your campaign data.
→ list_campaigns(status="completed")→ create_bundle("CSAT Results", project_id, questionnaire_id, campaign_ids=[campaign_id])→ create_bronze_dataset(bundle_id)→ code_open_ends(bundle_id) # codes open-ends, then weights the coded case base→ get_dataset(silver_dataset_id) # poll until "ready" — comparing earlier returns a conflict→ compare_bundle_quality(bundle_id)
The weighted dataset reduced RMSE from 0.08 to 0.02.Gender distribution now matches targets within 1%.Einen Fragebogen validieren
Abschnitt betitelt „Einen Fragebogen validieren“You: Check my new questionnaire for logical errors.
Claude: I'll run Z3 analysis on your QML file.
→ validate_qml_file("satisfaction.qml")
The questionnaire has 12 items across 3 blocks.Found 1 issue: Item 'q_followup' is unreachable becauseits precondition requires q_satisfied < 3, but q_satisfieduses a scale of 1-5 with no path setting it below 3.Tool-Annotationen
Abschnitt betitelt „Tool-Annotationen“Alle Tools tragen MCP-Annotationen für eine sichere Interaktion mit der KI:
- Lesende Tools (
list_*,get_*,search_*): Markiert mitreadOnlyHint=true– Claude kann sie frei aufrufen - Schreibende Tools (
create_*,update_*): Markiert mitdestructiveHint=false– sichere Änderungen - Löschende Tools (
delete_*,remove_*): Markiert mitdestructiveHint=true– Claude fragt vor der Ausführung nach - Externe Tools (
send_*_invitation): Markiert mitopenWorldHint=true– versendet echte E-Mails
Die Annotation für lesende Tools ist nicht nur ein Hinweis an Claude: In einer versiegelten Organisation entscheidet Askalot selbst anhand dieser Annotation, welche Aufrufe abgelehnt werden. Alles, was nicht als lesend markiert ist, gilt dort als Schreibzugriff und wird mit org_sealed beantwortet – ausgenommen die Design-Tools, die nur eine Vorschau starten oder durchlaufen; sie ändern nichts am Forschungsbestand und funktionieren weiter.
Paginierung
Abschnitt betitelt „Paginierung“Listen-Tools unterstützen Paginierung, damit die Antworten kompakt bleiben:
→ list_respondents(name="Smith", limit=10)→ list_campaigns(status="active", limit=5)→ list_surveys(status="completed", limit=20)Alle Listen-Tools verwenden standardmäßig limit=100 und liefern Metadaten zurück:
{ "items": [...], "count": 10, "limit": 100}