Intégration de Claude
Le serveur MCP d’Askalot permet à Claude de gérer directement par la conversation les enquêtes, les campagnes, les répondants et l’analyse des données. Ce guide couvre la configuration de toutes les interfaces de Claude.
Vue d’ensemble
Section intitulée « Vue d’ensemble »L’intégration expose 127 outils, chacun appartenant à un seul des dix-sept ensembles d’outils. Ce sont les mêmes noms que ceux auxquels vous pouvez restreindre une connexion avec ?toolsets= — consultez Restreindre les outils visibles par une connexion.
| Ensemble d’outils | Outils | Exemples |
|---|---|---|
sampling |
23 | Répondants, viviers, stratégies d’échantillonnage — créer, tirer, actualiser, prévisualiser |
fielding |
21 | Enquêtes, invitations, charge de travail des enquêteurs, parcours de réponse, remplissages synthétiques |
analysis |
20 | Lots, pipeline Bronze/Silver/Gold, sélection du codage, qualité, export |
questionnaire |
17 | Créer et gérer des fichiers QML, valider avec Z3, publier, téléverser |
campaign |
8 | Créer des campagnes, associer un questionnaire, affecter un vivier |
project |
7 | Créer des projets, gérer la propriété |
documents |
4 | Rechercher et lire vos documents de recherche indexés |
methodology |
4 | Rechercher parmi 24 articles méthodologiques évalués par les pairs |
audit |
3 | Interroger le journal d’audit |
session |
4 | Voir dans quelles organisations la session peut agir, la déplacer de l’une à l’autre, rechercher des utilisateurs |
conversation |
4 | Enregistrer et relire la conversation d’une exécution d’agent |
docs |
3 | Rechercher et lire la documentation d’Askalot |
paper |
3 | Lire l’article de recherche du projet et le modifier par ancrage, retracer la chaîne de réponse aux objectifs |
composite |
3 | Exécuter toute une chaîne en un seul appel — terrain, simulation ou pipeline des jeux de données |
tasks |
1 | get_task_status — interroger une tâche de longue durée grâce au task_id qu’elle a renvoyé |
entitlements |
1 | Consulter ce que couvre votre abonnement |
discovery |
1 | list_toolsets — ce que contient chaque ensemble d’outils et ce que cette connexion a demandé |
Les ensembles des huit dernières lignes sont disponibles sur toute connexion, quels que soient ceux qu’elle demande ; ceux des neuf premières sont ceux que filtre ?toolsets=.
Authentification
Section intitulée « Authentification »Askalot utilise OAuth 2.1 avec PKCE et l’enregistrement dynamique de clients (RFC 7591). Claude gère l’ensemble du flux automatiquement : il vous suffit de vous connecter avec vos identifiants Askalot lorsque vous y êtes invité.
Fonctionnement
Section intitulée « Fonctionnement »- Claude découvre les points de terminaison OAuth d’Askalot via
/.well-known/oauth-authorization-server - Claude s’enregistre comme client OAuth via
POST /register(une seule fois, automatiquement) - Une fenêtre de navigateur s’ouvre pour que vous vous connectiez sur
oidc.platform.askalot.io - Après la connexion, Claude reçoit un jeton d’accès et se connecte au serveur MCP
Aucune clé API ni gestion manuelle de jetons n’est nécessaire.
Points de terminaison OAuth
Section intitulée « Points de terminaison OAuth »| Point de terminaison | Rôle |
|---|---|
GET /.well-known/oauth-authorization-server |
Découverte des métadonnées du serveur |
GET /.well-known/oauth-protected-resource/mcp |
Métadonnées de la ressource protégée |
POST /register |
Enregistrement dynamique de clients |
GET /authorize |
Autorisation (redirige vers la connexion OIDC) |
POST /token |
Échange de jetons (authorization_code, refresh_token) |
POST /revoke |
Révocation de jetons |
Fonctionnalités prises en charge : Authorization Code avec PKCE (S256), jetons de rafraîchissement, portées (mcp:read, mcp:write, mcp:admin).
URL de l’instance
Section intitulée « URL de l’instance »Dans toutes les URL ci-dessous, remplacez <tenant> par l’identifiant de votre instance. Instances courantes :
dev— Essai gratuit et démo (organisation ACME Corp)eu1— Production UE (clients payants et universités)
Point de terminaison MCP : https://portor.<tenant>.askalot.io/mcp
Claude.ai (web)
Section intitulée « Claude.ai (web) »- Rendez-vous sur claude.ai et ouvrez Settings
- Accédez à Integrations (ou Connectors)
- Cliquez sur Add Custom MCP Server
- Saisissez :
- Name :
Askalot - URL :
https://portor.<tenant>.askalot.io/mcp
- Name :
- Cliquez sur Connect — une fenêtre de navigateur s’ouvre pour la connexion OAuth
- Connectez-vous avec vos identifiants Askalot et autorisez l’accès
Claude Desktop
Section intitulée « Claude Desktop »Claude Desktop se connecte à Askalot en tant que connecteur personnalisé distant : vous n’obtenez que les outils / l’API MCP (ni agents, ni compétences, ni commandes), et il n’y a aucune extension de bureau (.mcpb) à installer, puisque Portor est un serveur distant.
Ajouter un connecteur personnalisé (recommandé)
Section intitulée « Ajouter un connecteur personnalisé (recommandé) »- Ouvrez Settings → Connectors (dans certaines versions, sous Customize → Connectors)
- Cliquez sur Add custom connector
- Saisissez :
- Name :
Askalot - Remote MCP server URL :
https://portor.<tenant>.askalot.io/mcp
- Name :
- Cliquez sur Add — une fenêtre de navigateur s’ouvre pour la connexion OAuth
- Connectez-vous avec vos identifiants Askalot et autorisez l’accès
Le consentement OAuth est interactif et n’est demandé qu’une fois ; Claude Desktop stocke et renouvelle le jeton pour vous. Une fois la connexion établie, les outils d’enquête, de campagne, de jeux de données et d’analyse apparaissent dans la liste d’outils du connecteur. Il n’y a aucune clé API ni aucun jeton statique à coller : Askalot utilise OAuth 2.1.
Alternative : le fichier de configuration
Section intitulée « Alternative : le fichier de configuration »Si vous préférez modifier directement le fichier de configuration, ajoutez le serveur distant sous mcpServers dans le fichier correspondant à votre système :
- 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" } }}Redémarrez Claude Desktop après la sauvegarde. À la première utilisation, une fenêtre de navigateur s’ouvre pour la connexion OAuth.
Claude Code (CLI)
Section intitulée « Claude Code (CLI) »Claude Code peut se connecter de deux façons.
Installer le plugin Askalot (intégration complète)
Section intitulée « Installer le plugin Askalot (intégration complète) »/plugin marketplace add askalot-io/askalot-plugin/plugin install askalot@askalotLe plugin regroupe les agents, les compétences, les commandes slash et les outils MCP d’Askalot. Sa configuration MCP (.mcp.json) est de type: http et pointe vers ${ASKALOT_MCP_URL} avec une connexion OAuth interactive — aucun jeton Bearer statique. Définissez ASKALOT_MCP_URL dans votre shell avant de lancer Claude Code :
export ASKALOT_MCP_URL="https://portor.<tenant>.askalot.io/mcp"Si la variable n’est pas définie, le plugin se connecte à l’instance d’essai gratuit. Si votre compte se trouve sur une autre instance, la connexion aboutit quand même, puis se termine par user_not_in_tenant. Le message indique l’instance vérifiée, l’instance concernée par votre connexion et l’URL exacte de cette dernière. Définissez la variable avec cette URL et relancez Claude Code.
Ajouter uniquement le serveur MCP
Section intitulée « Ajouter uniquement le serveur MCP »Si vous voulez seulement les outils (ni agents, ni compétences, ni commandes) :
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcpÀ la première utilisation, Claude Code ouvre un navigateur pour la connexion OAuth. Après l’authentification, le jeton est stocké localement et renouvelé automatiquement.
Exemples d’utilisation
Section intitulée « Exemples d’utilisation »Créer une campagne d’enquête
Section intitulée « Créer une campagne d’enquête »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.Analyser les résultats d’une enquête
Section intitulée « Analyser les résultats d’une enquête »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%.Valider un questionnaire
Section intitulée « Valider un questionnaire »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.Annotations des outils
Section intitulée « Annotations des outils »Tous les outils portent des annotations MCP qui sécurisent l’interaction avec l’IA :
- Outils en lecture seule (
list_*,get_*,search_*) : marquésreadOnlyHint=true— Claude peut les appeler librement - Outils d’écriture (
create_*,update_*) : marquésdestructiveHint=false— des modifications sans danger - Outils de suppression (
delete_*,remove_*) : marquésdestructiveHint=true— Claude demande confirmation avant de les exécuter - Outils externes (
send_*_invitation) : marquésopenWorldHint=true— ils envoient de vrais e-mails
L’annotation de lecture seule n’est pas qu’un conseil adressé à Claude : dans une organisation scellée, c’est sur elle qu’Askalot s’appuie pour décider quels appels refuser. Tout outil qui n’est pas marqué en lecture seule y est traité comme une écriture et reçoit la réponse org_sealed — à l’exception des outils de conception qui se contentent de lancer ou de parcourir un aperçu : ils ne modifient rien dans le dossier de recherche et continuent de fonctionner.
Pagination
Section intitulée « Pagination »Les outils de liste prennent en charge la pagination pour que les réponses restent concises :
→ list_respondents(name="Smith", limit=10)→ list_campaigns(status="active", limit=5)→ list_surveys(status="completed", limit=20)Tous les outils de liste utilisent limit=100 par défaut et renvoient des métadonnées :
{ "items": [...], "count": 10, "limit": 100}