@faqwise/mcp

Serveur MCP de faqwise : il donne à un assistant (Claude) un accès en lecture seule aux FAQ, à la file de modération, aux conversations du chat et à l'état d'indexation d'une instance.

La passerelle tourne sur votre poste. Elle garde la clé dans la configuration de Claude et appelle la même API REST que le back-office — elle n'ouvre aucune surface publique nouvelle sur l'instance, et ne décide de rien : tout ce qu'elle rend vient de l'API.

Installation

Rien à installer : npx la récupère au lancement.

{
  "mcpServers": {
    "faqwise": {
      "command": "npx",
      "args": ["-y", "@faqwise/mcp"],
      "env": {
        "FAQWISE_URL": "https://faqwise.cloud",
        "FAQWISE_CLE": "<votre clé>"
      }
    }
  }
}

La clé s'émet dans Paramètres → Clés MCP, réservé aux super-administrateurs. Elle n'est affichée qu'une fois, à la création : une clé relisible dans une page d'administration finit recopiée ailleurs, et l'on ne sait plus combien d'exemplaires circulent.

Outils

| Outil | Ce qu'il rend | |---|---| | faqwise_moi | Vérifie la clé — le premier appel quand rien ne répond | | faqwise_statistiques | FAQ, modération, conversations et satisfaction sur une fenêtre | | faqwise_faqs | Les FAQ filtrables par statut et thème, réponse entière | | faqwise_faq_statistiques | Répartition, vues, les plus consultées et les moins utiles | | faqwise_recherche | Cherche dans les FAQ existantes | | faqwise_moderation | Les questions soumises en attente, avec leur ancienneté | | faqwise_conversations | Le chat, filtrable par feedback, statut, commentaire | | faqwise_conversation | Un échange complet, avec les sources fournies au modèle | | faqwise_lacunes | Les questions mal répondues croisées avec les FAQ | | faqwise_sources | L'indexation : documents, articles, produits | | faqwise_magasins | Le référentiel des magasins, et lesquels sont interrogeables pour le stock | | faqwise_taches | Les passes planifiées, statut et motif d'échec | | faqwise_suggestions | Les pastilles : affichées, cliquées, ignorées, et les questions tapées malgré elles |

Ce qu'il ne fait pas

Aucun outil n'écrit. Ni publier une FAQ, ni relancer une indexation, ni changer un statut. C'est ce qui permet de distribuer une clé sans arrière-pensée — le pilotage viendra avec un niveau de clé distinct.

Sécurité

La passerelle refuse de démarrer plutôt que de laisser fuir la clé :

• HTTPS exigé hors boucle locale — la clé voyage dans un en-tête, et en clair sur un réseau qu'on ne maîtrise pas elle est lisible par qui écoute ;
• NODE_TLS_REJECT_UNAUTHORIZED=0 refusé — cette variable se pose pour « faire passer » un proxy qui intercepte le TLS, c'est-à-dire exactement la situation où la clé se ferait lire ;
• aucune redirection suivie — fetch ne retire pas un en-tête personnalisé en changeant d'hôte : sur un réseau filtré, la clé partirait au portail de blocage qui répond 307 ;
• clé masquée dans tout message rendu, et jamais écrite sur stdout, qui porte le protocole.

Licence

MIT