Serveur MCP

Road To expose un serveur MCP (Model Context Protocol) qui permet aux assistants IA comme Claude de créer des templates et des projets directement.

Configuration

Claude Desktop

Ajoutez la configuration suivante dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "road-to": {
      "command": "curl",
      "args": ["-X", "POST", "https://roadto.app/api/mcp"],
      "headers": {
        "X-Api-Key": "rt_org_votreclé..."
      }
    }
  }
}

Claude Code (CLI)

Configurez le serveur MCP avec l'URL de base :

Endpoint: https://roadto.app/api/mcp
Auth header: X-Api-Key: rt_org_votreclé...

Authentification

Le serveur MCP utilise les clés API Road To via le header X-Api-Key ou Authorization: Bearer ....

Obtenez votre clé API depuis :

• Clé personnelle : Compte → Clés API
• Clé d'organisation : Organisation → Paramètres → Clés API

Outils disponibles

create_template

Crée un nouveau template dans votre organisation Road To.

Paramètres :

• template (requis) — Structure RtTemplate complète avec name, description, sections, locale, etc.
• notify (optionnel) — Liste d'emails à notifier de la création

Exemple de prompt Claude :

Crée un template Road To pour l'onboarding d'un nouveau client SaaS avec 3 sections :
découverte, configuration et formation.

---

create_project

Crée un nouveau projet dans votre organisation Road To à partir d'un template.

Paramètres :

• name (requis) — Nom du projet
• description (optionnel) — Description du projet
• templateId (optionnel) — ID d'un template existant dans Road To
• template (optionnel) — Structure RtTemplate inline
• notify (optionnel) — Liste d'emails à notifier avec le lien du projet

Exemple de prompt Claude :

Crée un projet Road To pour le client Acme Corp en utilisant le template "Onboarding SaaS"
et envoie le lien à contact@acme.com

Format RtTemplate

Le format complet d'un template Road To :

{
  "version": 1.0,
  "versionTemplate": 1,
  "id": "UNIQUE_ID",
  "locale": "fr",
  "name": "Nom du template",
  "description": "Description courte",
  "sections": [
    {
      "id": "SECTION_ID",
      "version": 1,
      "title": "Titre de la section",
      "subtitle": "Sous-titre optionnel",
      "description": "Description de la section",
      "tasks": [
        {
          "id": "TASK_ID",
          "version": 1,
          "text": "Texte de la tâche",
          "estimatedTime": 30,
          "difficulty": "medium"
        }
      ]
    }
  ]
}

Les valeurs possibles pour difficulty sont : low, medium, high. estimatedTime est en minutes.