MCP

Le serveur MCP (Model Context Protocol) permet aux assistants IA—comme Cursor ou Claude Desktop—de se connecter à votre compte Drag'n Survey. Une fois configuré, vous pouvez demander à l'assistant de créer des enquêtes, gérer les collecteurs, consulter les réponses, etc., en langage naturel.

URL du serveur

Le serveur MCP de Drag'n Survey est disponible à l'adresse :

https://developer.dragnsurvey.com/mcp

Authentification

Le serveur MCP prend en charge deux méthodes d'authentification :

Option 1 : OAuth (recommandé)

Le moyen le plus simple de se connecter est via OAuth. De nombreux assistants IA prennent en charge OAuth pour les serveurs MCP, ce qui vous permet de vous connecter en quelques clics sans gérer manuellement des clés API.

Lorsque votre assistant IA vous propose l'authentification OAuth :

  1. Cliquez sur le bouton de connexion ou le lien d'autorisation
  2. Connectez-vous à votre compte Drag'n Survey (si ce n'est pas déjà le cas)
  3. Autorisez la connexion
  4. L'assistant IA configurera automatiquement la connexion

Option 2 : Clé API

Vous pouvez aussi vous authentifier avec un token API dans l'en-tête Authorization :

Authorization: Bearer your-api-token

Récupérez votre token ici.

Comment configurer le serveur MCP

Vous avez besoin d'un token API personnel. Créez-en un depuis la page Token dans cette zone API si ce n'est pas déjà fait.

  1. Créez un token API personnel depuis la page Token dans cette zone API. Gardez ce token confidentiel.
  2. Dans votre assistant IA ou client MCP, ajoutez un nouveau serveur MCP avec l'URL : https://developer.dragnsurvey.com/mcp
  3. Utilisez votre token API lorsque le client demande une authentification. Le client pourra alors effectuer des actions en votre nom.

Gardez votre token confidentiel

Votre token API donne un accès complet à votre compte. Ne le partagez pas et ne le committez pas dans le contrôle de version. Stockez-le dans les paramètres sécurisés du client ou dans l'environnement.

Exemples de configuration

Applications desktop (ex. Cursor, Claude Desktop)

Cursor, Claude Desktop et les applications similaires utilisent le même format JSON. Ajoutez le serveur dans les paramètres MCP de l'application (ex. Cursor : Paramètres → MCP ; Claude Desktop : fichier de config) ou dans le fichier de config (ex. ~/.cursor/mcp.json ou ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS).

Cursor

Avec OAuth (recommandé): Ajoutez uniquement l'URL du serveur. Cursor lancera OAuth lors de la première utilisation du serveur MCP. Dans votre configuration MCP (projet ou utilisateur) (ex. ~/.cursor/mcp.json) :

{
  "mcpServers": {
    "dragnsurvey": {
      "url": "https://developer.dragnsurvey.com/mcp"
    }
  }
}

Avec clé API: Ajoutez la même URL et un en-tête Authorization :

{
  "mcpServers": {
    "dragnsurvey": {
      "url": "https://developer.dragnsurvey.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude Desktop

Ouvrez Settings → Connectors → Add custom connector, donnez-lui un nom et l'URL du serveur MCP :

https://developer.dragnsurvey.com/mcp

La première fois que vous utilisez le serveur MCP, Claude ouvrira un flux OAuth pour s'authentifier avec votre compte Drag'n Survey.

Avec clé API (par exemple lorsque OAuth n'est pas disponible): modifiez claude_desktop_config.json (sur macOS : ~/Library/Application Support/Claude/claude_desktop_config.json) et ajoutez :

{
  "mcpServers": {
    "dragnsurvey": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developer.dragnsurvey.com/mcp",
        "--header",
        "Authorization: Bearer ${DRAGNSURVEY_API_TOKEN}"
      ],
      "env": {
        "DRAGNSURVEY_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Set DRAGNSURVEY_API_TOKEN to your personal API token.

Outils CLI (ex. Claude Code, Codex)

Les outils en ligne de commande utilisent leur propre format de configuration. Voici des exemples pour Claude Code et Codex.

Claude Code

Avec OAuth: Ajoutez le serveur uniquement avec l'URL. Claude Code lancera le flux OAuth lors de la première utilisation du serveur MCP.

claude mcp add dragnsurvey --transport http https://developer.dragnsurvey.com/mcp

Avec clé API:

claude mcp add --transport http dragnsurvey https://developer.dragnsurvey.com/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Vous pouvez aussi ajouter le serveur dans ~/.claude.json ou un .mcp.json de projet avec la même URL et les mêmes en-têtes que dans l'exemple desktop.

Codex

Modifiez ~/.codex/config.toml (ou .codex/config.toml du projet). Utilisez bearer_token_env_var pour que le token soit lu depuis une variable d'environnement (recommandé) :

[mcp_servers.dragnsurvey]
url = "https://developer.dragnsurvey.com/mcp"
bearer_token_env_var = "DRAGNSURVEY_API_TOKEN"

Sinon, définissez l'en-tête explicitement (évitez de committer le fichier avec un vrai token) :

[mcp_servers.dragnsurvey]
url = "https://developer.dragnsurvey.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_TOKEN" }

Définissez DRAGNSURVEY_API_TOKEN dans votre environnement (ex. dans votre profil shell) avant d'exécuter Codex.

Ce que le serveur MCP peut faire

Une fois connecté, l'assistant peut utiliser les fonctionnalités suivantes sur votre compte :

Enquêtes

  • Créer des enquêtes, lister vos enquêtes et récupérer les détails et la structure complets.
  • Modifier la structure (ordre des pages et des questions) et les options de l'enquête.

Pages et questions

  • Créer, modifier, supprimer et réordonner les pages.
  • Créer, modifier, supprimer et déplacer les questions entre les pages.
  • Diviser une page à une position donnée (saut de page).

Thèmes

  • Créer et modifier des thèmes ; optionnellement appliquer un thème à une enquête.

Collecteurs

  • Lister, créer, modifier et supprimer les collecteurs (ex. collecteurs par lien).
  • Générer des liens personnalisés identifiant les répondants (ex. e-mail ou id CRM).
  • Configurer les options (redirection, page de remerciement, réponses anonymes, limites de réponses).

Répondants et réponses

  • Lister les répondants d'une enquête, récupérer leurs détails et supprimer des répondants.
  • Obtenir les réponses d'un répondant dans un format lisible.
  • Obtenir les effectifs et statistiques de réponses pour une question donnée.

Webhooks

  • Lister, créer et supprimer des abonnements webhook.
  • S'abonner à des événements (ex. création ou complétion d'une réponse).

Ressources

Le serveur peut aussi exposer vos enquêtes et listes de répondants comme ressources, pour que l'assistant puisse lire les infos d'enquête et les données des répondants par référence.