Connecter Claude Code à votre panneau — Documentation

Une fois ce réglage fait, Claude Code peut consulter votre panneau pendant que vous travaillez dans un terminal : « quel compte est le plus proche de sa limite d'espace disque ? », « affiche les enregistrements DNS de example.com ». Il ne lit que ce que votre jeton autorise. Tout ce qui supprime ou interrompt devient une demande qui attend que vous appuyiez sur Approuver dans le panneau. L'assistant n'approuve jamais lui-même sa propre demande.

C'est la seconde façon d'utiliser l'IA avec Nimbopanel. La première, un panneau de discussion intégré au panneau, est décrite dans Assistant IA. Vous n'avez pas besoin de celle-ci pour utiliser cette méthode.

Avant de commencer

L'adresse de votre panneau, par exemple https://panel.yourdomain.com. Utilisez l'adresse du panneau lui-même, pas une adresse IP.
Claude Code installé sur votre ordinateur (la commande claude fonctionne dans un terminal).
Un compte sur le panneau : administrateur, revendeur, client ou utilisateur d'équipe.

1. L'administrateur active la connexion (une seule fois)

Ouvrez Système → Sécurité → Connexion d'un assistant IA (MCP), cochez Autoriser la connexion d'assistants IA, choisissez quels types de personnes peuvent en connecter un, puis appuyez sur Enregistrer. La carte affiche l'adresse que les assistants utilisent : /mcp à la suite de l'adresse de votre panneau.

Sur une installation neuve, cette option est désactivée. Tant qu'elle ne l'est pas, /mcp répond 404 et rien de ce qui suit ne fonctionne.

2. Créez un jeton réservé à l'assistant

Connectez-vous au panneau et ouvrez Jetons API : pour les administrateurs et les revendeurs sous Sécurité, pour les clients sous Avancé. Ouvrez Connecter un assistant IA (Claude et autres).

Donnez-lui un nom que vous reconnaîtrez, par exemple Claude Code sur mon portable.
Pour chaque partie du panneau, choisissez Aucun accès, Lecture ou Lire et modifier. Commencez par Lecture : l'assistant peut tout consulter de ce que vous cochez et ne modifie rien.
Laissez Cesse de fonctionner après (jours) à 90, ou indiquez le nombre de votre choix.
Appuyez sur Créer un jeton d'assistant.

Le panneau affiche alors le jeton une seule fois. Copiez-le avant de quitter la page.

3. Collez une commande

Le panneau affiche la commande avec votre adresse et le jeton déjà en place. Copiez-la et exécutez-la dans un terminal. Elle ressemble à ceci :

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

Ce qu'elle dit : ajouter un serveur MCP nommé nimbopanel, joint en HTTP à l'adresse /mcp du panneau, et envoyer votre jeton dans l'en-tête Authorization à chaque appel.

Où Claude Code le range. Par défaut, le serveur n'est enregistré que pour le projet en cours, dans ~/.claude.json sur votre ordinateur, et non dans le dossier du projet. Ajoutez --scope user pour l'utiliser dans tous vos projets. N'ajoutez pas --scope project avec un vrai jeton : cela écrirait le jeton dans .mcp.json, un fichier fait pour être versionné et partagé. Si une équipe partage la connexion, mettez une référence dans .mcp.json et laissez chacun garder son propre jeton dans une variable d'environnement :

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

Chaque personne devrait créer son propre jeton : ainsi, une demande indique qui l'a faite, et un jeton peut être révoqué seul.

4. Vérifiez que cela fonctionne

claude mcp list

nimbopanel doit apparaître comme connecté. Dans Claude Code, vous pouvez aussi taper /mcp. Posez ensuite vos questions en langage courant :

« Liste mes comptes d'hébergement et dis-moi lequel utilise le plus d'espace disque. »
« Affiche les enregistrements DNS de example.com. »
« Quelles sont mes plus grosses bases de données ? »
Administrateurs : « Tous les services tournent-ils ? », « La file d'attente des e-mails grossit-elle ? »

L'assistant peut consulter les comptes et leur consommation, les domaines, les enregistrements DNS, les comptes e-mail (jamais les mots de passe), les bases de données, les sauvegardes, la charge du serveur et les services, la file d'attente des e-mails, les revendeurs et les tickets d'assistance, dans la limite des parties désignées par votre jeton et de votre propre rôle.

Quand vous demandez une modification

Avec Lire et modifier, un enregistrement d'adresse (A ou AAAA) ou de texte (TXT) ordinaire, sur un nom neuf et courant, est ajouté immédiatement.
Tout le reste attend votre feu vert : supprimer un enregistrement, suspendre ou réactiver un compte, les enregistrements de messagerie, le domaine lui-même, les enregistrements CNAME, SRV et CAA, les wildcards, et les noms que les logiciels de messagerie consultent. Cela devient une demande.

Ouvrez Jetons API → Demandes de l'assistant. Chaque demande explique en termes simples ce qui va se passer. Appuyez sur Approuver…, puis sur Oui, le faire maintenant. Une demande expire au bout de 30 minutes. Lisez la demande, pas le message de l'assistant : la demande est rédigée par le panneau et dit exactement ce qui sera fait.

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.

En cas de problème

Ce que vous voyez	Ce que cela signifie	Que faire
`404 Not found` sur `/mcp`, ou une page indiquant qu'aucun site web n'est configuré pour l'adresse	La connexion est désactivée, ou vous avez utilisé une adresse qui n'est pas celle de votre panneau (une IP, ou un autre domaine)	Étape 1 ; utilisez l'adresse du panneau lui-même, terminée par `/mcp`
`403 forbidden_host`	L'adresse atteint le panneau, mais il ne la reconnaît pas comme la sienne	Utilisez l'adresse du panneau lui-même, par exemple `https://panel.yourdomain.com`
`401 Login required`	Le jeton est absent, mal saisi, expiré ou révoqué	Créez un nouveau jeton et relancez la commande
`403 mcp_scope_required`	Il s'agit d'un jeton API ordinaire, pas d'un jeton pour assistant	Créez un jeton sous Connecter un assistant IA (Claude et autres)
`403 mcp_off_for_role`	Votre type de compte n'a pas le droit de connecter un assistant	Demandez à l'administrateur (étape 1)
`429 rate_limited`	Trop d'appels en peu de temps	Attendez une minute
Une partie du panneau est absente	Son domaine est réglé sur Aucun accès	Créez un nouveau jeton avec ce domaine sur Lecture

Si claude mcp list signale un échec, c'est le plus souvent que l'adresse n'a pas /mcp à la fin, ou que l'en-tête n'est pas exactement Authorization: Bearer <token>.

Tout retirer

claude mcp remove nimbopanel

le retire de votre ordinateur. Pour que le jeton cesse de fonctionner partout, supprimez-le sous Jetons API ; toute demande qu'il avait laissée ouverte est annulée. L'administrateur peut désactiver toute la connexion à l'étape 1, et /mcp répond de nouveau 404.

Bonnes habitudes

Privilégiez Lecture. N'utilisez Lire et modifier que pour les domaines qui en ont besoin.
Un jeton par ordinateur ou par personne, avec un nom qui dit à qui il appartient.
Gardez les 90 jours par défaut, ou moins sur une machine partagée.
Ne collez jamais un jeton dans une discussion, un ticket ou un fichier que vous versionnez.

Pas encore pris en charge : les clients qui ne peuvent se connecter qu'avec une connexion OAuth. Ce point d'accès accepte un jeton dans l'en-tête.