Assistant IA — celui du panneau, et comment connecter Claude à votre panneau

Nimbopanel vous offre deux façons d'utiliser l'IA. Les deux sont désactivées tant que vous ne les activez pas, et dans les deux cas l'assistant ne voit que ce que la personne qui l'utilise a le droit de voir.

L'assistant intégré

Les gens posent leurs questions dans leur propre langue — « pourquoi mon e-mail n'arrive-t-il pas ? », « combien d'espace disque reste-t-il ? » — et l'assistant lit le panneau pour répondre.

L'activer (administrateur) :

1. Ouvrez Système → Sécurité → Assistant IA dans le panneau.
2. Choisissez le fournisseur d'IA (voir la liste ci-dessous). Un lien à côté du choix vous mène à l'endroit où ce fournisseur crée ses clés.
3. Collez votre clé API pour ce fournisseur. Elle est enregistrée dans un fichier réservé à root sur votre serveur et n'est plus jamais affichée — ni à vous, ni à personne. Changer de fournisseur ne reporte pas la clé de l'ancien.
4. Choisissez le modèle. La liste propose quelques noms courants pour le fournisseur, et vous pouvez saisir n'importe quel nom de modèle exactement tel que le fournisseur le liste.
5. Choisissez qui peut l'utiliser : administrateurs, revendeurs, clients, utilisateurs d'équipe.
6. Fixez les limites : questions par personne et par jour et le budget mensuel de jetons pour tout le serveur. Quand le budget est épuisé, l'assistant se met en pause jusqu'au mois suivant.
7. Cochez Activer l'assistant et enregistrez.

Les fournisseurs que vous pouvez choisir. Dix sont listés par leur nom, plus deux pour n'importe quelle autre adresse :

Pour les deux choix Autre, vous saisissez vous-même l'adresse de l'API du fournisseur, telle que sa documentation la donne. L'adresse doit commencer par https://. Le simple http:// n'est accepté que pour ce serveur ou un réseau privé (un serveur de modèles que vous faites tourner vous-même). Une adresse contenant un nom d'utilisateur, une requête ou un fragment, ainsi que les adresses de la plage de métadonnées du cloud, sont refusées.

Limite honnête. L'assistant a été testé avec un fournisseur de substitution qui se comporte comme chaque protocole. Il n'a pas encore été testé contre le service réel de chaque éditeur ; essayez donc une question ou deux après l'avoir activé et avant d'en parler à vos clients. Les noms de modèles changent souvent ; si un fournisseur répond qu'il ne connaît pas le modèle, saisissez le nom actuel.

Choisir un fournisseur d’IA et garder la facture petite

• Vous payez le fournisseur, selon l’usage — Le coût augmente avec le nombre de questions et la longueur des réponses. Les prix changent souvent : consultez la page de tarifs du fournisseur avant de décider, et fixez aussi une limite de dépense dans le tableau de bord du fournisseur. Nimbopanel n’ajoute aucun frais.
• Quel fournisseur ? — Pour de bonnes réponses avec le moins d’efforts, choisissez un fournisseur hébergé comme Anthropic, OpenAI ou Google. Pour une seule clé donnant accès à de nombreux modèles, choisissez OpenRouter. Pour que chaque question reste sur votre propre serveur, faites tourner Ollama dessus : pas de frais par question, mais il faut assez de mémoire et les petits modèles répondent moins bien. Vous pouvez changer de fournisseur plus tard.
• Commencez petit — Gardez les limites de départ (30 questions par personne et par jour, 2 000 000 de jetons par mois pour tout le serveur) et laissez d’abord seuls les administrateurs l’utiliser. 0 signifie aucune limite : gardez-le pour plus tard.
• Décidez ce que l’IA peut lire — Cochez « Garder les tickets de support à l’écart du service d’IA » si vous ne voulez pas que les messages des clients soient envoyés à un fournisseur. Chaque personne voit un avis de confidentialité avant sa première question.
• Essayez avant d’en parler aux clients — Posez quelques questions sur un compte de test et essayez une modification proposée : l’approuver demande le mot de passe de la personne qui approuve.

Ce qu'il peut faire et ne peut pas faire

• Il lit avec les accès de la personne qui pose la question : l'assistant d'un client voit le compte de ce client et rien d'autre ; l'assistant d'un revendeur garde les droits du revendeur.
• Il ne peut rien modifier par lui-même. Pour quelques modifications (ajouter ou supprimer un enregistrement DNS, suspendre ou réactiver un compte), il prépare une carte sous sa réponse. La carte est rédigée par le panneau — pas par l'IA — et indique exactement ce qui va se passer. Rien ne se passe tant que la personne n'a pas appuyé sur Approuver… puis sur Oui, le faire maintenant. Elle peut aussi appuyer sur Refuser. Comme c’est un assistant qui a demandé le changement, le panneau vous demande d’abord de confirmer que c’est bien vous avec votre mot de passe (et votre code de vérification si vous utilisez la connexion en deux étapes) ; ensuite, il ne vous le redemande pas pendant quelques minutes.
• Si l'assistant a lu des messages écrits par d'autres personnes (par exemple des tickets d'assistance) avant de proposer quelque chose, la carte le signale. N'approuvez que ce que vous avez réellement demandé.
• Les demandes attendent 30 minutes, puis expirent. Désactiver l'assistant annule toutes les propositions en attente.
• Il n'est pas disponible via un jeton API ni dans un onglet « Se connecter en tant que » — uniquement dans la propre session d'une personne.

Confidentialité. Chaque personne voit un avertissement avant sa première question : les questions, ainsi que les données du panneau que l'assistant lit pour y répondre, sont envoyées au fournisseur que vous avez choisi, sous votre compte. Les mots de passe et les clés sont retirés de ce qui est envoyé lorsque le panneau peut les reconnaître, mais personne ne devrait jamais taper un mot de passe dans l'assistant. L'assistant d'un administrateur ou d'un revendeur peut lire les données d'autres clients qu'ils ont le droit de voir.

Connecter un assistant IA (MCP)

Cela permet à quelqu'un d'utiliser son propre assistant (par exemple Claude) avec le panneau, via le Model Context Protocol.

1. Administrateur : ouvrez Système → Sécurité → Connexion d'un assistant IA (MCP), cochez Autoriser la connexion d'assistants IA, choisissez les rôles autorisés à se connecter, enregistrez.

2. La personne (administrateur, revendeur, client ou utilisateur d'équipe) ouvre Jetons API → Connecter un assistant IA (Claude et autres). Pour chaque partie du panneau, choisissez Aucun accès, Lecture ou Lire et modifier — choisissez Lecture lorsque l'assistant doit seulement consulter — puis appuyez sur Créer un jeton d'assistant. Le jeton cesse de fonctionner au bout de 90 jours, sauf si vous indiquez un autre nombre dans Cesse de fonctionner après (jours).

3. Le panneau affiche la commande à coller. Pour Claude Code :

   claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"
   

   Les autres clients MCP utilisent la même adresse avec le jeton dans l'en-tête Authorization: Bearer.

Ce qu'un assistant connecté peut faire : lire les parties que son jeton désigne ; ajouter un enregistrement d'adresse ou de texte pour un nouveau nom ordinaire. Tout le reste — supprimer un enregistrement, suspendre ou réactiver un compte, les enregistrements de messagerie, le domaine lui-même, les enregistrements CNAME/SRV/CAA, les wildcards et les noms que les logiciels de messagerie consultent (autodiscover, autoconfig, mail, …) — devient une demande. Le propriétaire du jeton la voit sous Jetons API → Demandes de l'assistant et l'approuve ou la refuse. Un assistant ne peut jamais approuver sa propre demande.

Pas encore pris en charge : les clients qui ne peuvent se connecter qu'avec une connexion OAuth (le point d'accès accepte un jeton dans l'en-tête). Révoquez un jeton à tout moment sous Jetons API ; ses demandes en attente sont annulées.

Bonnes habitudes

• Ne donnez à chaque jeton d'assistant que les parties dont il a besoin, et privilégiez Lecture plutôt que Lire et modifier.
• Lisez chaque carte d'approbation. C'est la carte — et non le message de l'assistant — qui indique ce qui va se passer.
• Gardez la limite quotidienne de questions et le budget mensuel en place ; l'utilisation de ce mois-ci s'affiche sur la même carte.