Zum Inhalt springen
Wissensdatenbank

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.

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.

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.

  1. Claude ermittelt die OAuth-Endpunkte von Askalot über /.well-known/oauth-authorization-server
  2. Claude registriert sich über POST /register als OAuth-Client (einmalig, automatisch)
  3. Ein Browserfenster öffnet sich, in dem Sie sich unter oidc.platform.askalot.io anmelden
  4. 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.

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).

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

  1. Rufen Sie claude.ai auf und öffnen Sie Settings
  2. Gehen Sie zu Integrations (oder Connectors)
  3. Klicken Sie auf Add Custom MCP Server
  4. Geben Sie ein:
    • Name: Askalot
    • URL: https://portor.<tenant>.askalot.io/mcp
  5. Klicken Sie auf Connect – ein Browserfenster für die OAuth-Anmeldung öffnet sich
  6. Melden Sie sich mit Ihren Askalot-Zugangsdaten an und genehmigen Sie den Zugriff

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.

  1. Öffnen Sie Settings → Connectors (in manchen Versionen unter Customize → Connectors)
  2. Klicken Sie auf Add custom connector
  3. Geben Sie ein:
    • Name: Askalot
    • Remote MCP server URL: https://portor.<tenant>.askalot.io/mcp
  4. Klicken Sie auf Add – ein Browserfenster für die OAuth-Anmeldung öffnet sich
  5. 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.

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 kann sich auf zwei Arten verbinden.

/plugin marketplace add askalot-io/askalot-plugin
/plugin install askalot@askalot

Das 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:

Terminal-Fenster
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.

Wenn Sie nur die Tools möchten (ohne Agenten, Skills und Befehle):

Terminal-Fenster
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcp

Bei der ersten Nutzung öffnet Claude Code einen Browser für die OAuth-Anmeldung. Nach der Authentifizierung wird das Token lokal gespeichert und automatisch erneuert.

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.
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%.
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 because
its precondition requires q_satisfied < 3, but q_satisfied
uses a scale of 1-5 with no path setting it below 3.

Alle Tools tragen MCP-Annotationen für eine sichere Interaktion mit der KI:

  • Lesende Tools (list_*, get_*, search_*): Markiert mit readOnlyHint=true – Claude kann sie frei aufrufen
  • Schreibende Tools (create_*, update_*): Markiert mit destructiveHint=false – sichere Änderungen
  • Löschende Tools (delete_*, remove_*): Markiert mit destructiveHint=true – Claude fragt vor der Ausführung nach
  • Externe Tools (send_*_invitation): Markiert mit openWorldHint=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.

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
}