Aller au contenu
Base de connaissances

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.

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

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

  1. Claude découvre les points de terminaison OAuth d’Askalot via /.well-known/oauth-authorization-server
  2. Claude s’enregistre comme client OAuth via POST /register (une seule fois, automatiquement)
  3. Une fenêtre de navigateur s’ouvre pour que vous vous connectiez sur oidc.platform.askalot.io
  4. 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.

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

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

  1. Rendez-vous sur claude.ai et ouvrez Settings
  2. Accédez à Integrations (ou Connectors)
  3. Cliquez sur Add Custom MCP Server
  4. Saisissez :
    • Name : Askalot
    • URL : https://portor.<tenant>.askalot.io/mcp
  5. Cliquez sur Connect — une fenêtre de navigateur s’ouvre pour la connexion OAuth
  6. Connectez-vous avec vos identifiants Askalot et autorisez l’accès

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.

  1. Ouvrez Settings → Connectors (dans certaines versions, sous Customize → Connectors)
  2. Cliquez sur Add custom connector
  3. Saisissez :
    • Name : Askalot
    • Remote MCP server URL : https://portor.<tenant>.askalot.io/mcp
  4. Cliquez sur Add — une fenêtre de navigateur s’ouvre pour la connexion OAuth
  5. 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.

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 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@askalot

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

Fenêtre de terminal
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.

Si vous voulez seulement les outils (ni agents, ni compétences, ni commandes) :

Fenêtre de terminal
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.

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.

Tous les outils portent des annotations MCP qui sécurisent l’interaction avec l’IA :

  • Outils en lecture seule (list_*, get_*, search_*) : marqués readOnlyHint=true — Claude peut les appeler librement
  • Outils d’écriture (create_*, update_*) : marqués destructiveHint=false — des modifications sans danger
  • Outils de suppression (delete_*, remove_*) : marqués destructiveHint=true — Claude demande confirmation avant de les exécuter
  • Outils externes (send_*_invitation) : marqués openWorldHint=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.

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
}