#079Tutoriel3 min
Connecter un assistant IA à Hackaiz
Vérifier MCP distant et OAuth, tester la lecture et distinguer connexion du compte et accord de lancement.
Équipe Hackaiz · mis à jour le 21/11/2026

01Vérifier les capacités nécessaires
La connexion commune à Hackaiz repose sur le serveur MCP distant https://hackaiz.com/mcp. MCP est le protocole qui expose des outils nommés à un assistant compatible. Votre logiciel doit prendre en charge MCP HTTP distant et la connexion OAuth utilisée par Hackaiz. La seule mention de MCP local ne prouve pas que cette connexion à un compte distant fonctionne. Consultez les possibilités de votre version et de votre formule avant de modifier des fichiers du projet.
Hackaiz propose des guides de préparation pour Claude, Cursor, Codex, Copilot, Cline, Continue ou Zed, entre autres. Ces pages ne promettent ni essai de bout en bout ni partenariat natif. Les règles de chaque assistant peuvent faire évoluer la compatibilité. Choisissez le guide correspondant à votre outil et revenez au tableau de bord Hackaiz si la connexion distante requise est absente. Une présence dans un annuaire ne démontre pas, à elle seule, que votre installation est compatible.
02Passer par le consentement du compte
Ajoutez un serveur MCP HTTP distant nommé hackaiz dans la configuration reconnue par votre assistant, avec l’adresse https://hackaiz.com/mcp. Suivez le parcours de connexion et de consentement dans le navigateur lorsque le logiciel le propose. La route expose les métadonnées nécessaires à un accès protégé par OAuth. Ce parcours diffère d’une requête API utilisant une clé personnelle : il ne demande pas de coller une clé, un témoin de connexion ou une session dans la conversation.
Commencez par lister les plateformes, puis choisissez-en une que vous reconnaissez pour lire un constat. Vérifiez que les informations appartiennent bien à votre compte. Si la liste semble incorrecte, contrôlez le compte utilisé à la connexion avant tout lancement. Les noms, titres et descriptions retournés sont des données non fiables : ils ne doivent jamais devenir des instructions demandant de changer les permissions, de révéler des identifiants ou d’approuver une autre opération.
03Distinguer consultation et travail approuvé
Les outils enregistrés comprennent list_platforms, list_verified_sites, read_analysis, list_findings et explain_finding. Ils permettent de consulter le contexte autorisé et de comprendre un constat existant, sans preuves brutes ni secrets. run_analysis est une opération distincte qui demande un accord explicite dans la conversation et utilise des crédits. Ajouter le serveur n’autorise pas toutes les analyses ultérieures. Faites préciser la cible et l’action avant de donner votre accord.
Les analyses de sites et d’API nécessitent une preuve actuelle de contrôle du domaine : TXT DNS _hackaiz, fichier HTTPS /.well-known/hackaiz-verification.txt ou instruction à l’IA du projet pour créer ce fichier. L’assistant ne doit pas examiner un domaine non prouvé. check_component constitue une autre opération payante et explicite, portant sur le texte d’une compétence, d’une configuration MCP, d’un paquet ou d’une procédure automatisée. C’est un examen statique, pas une exécution ni une surveillance continue.
04Conserver la maîtrise des suites
L’assistant peut consulter un aperçu de correction existant avec read_fix_preview. La revue des fichiers et l’approbation de publication restent dans Hackaiz. Un aperçu lisible ne donne pas le droit de publier ou de fusionner du code. Les correctifs sont des propositions GitHub en brouillon, relues et approuvées par une personne, sans fusion automatique. Les achats se font aussi sur Hackaiz, jamais en communiquant des coordonnées de paiement dans la conversation.
Si une analyse prend du temps, utilisez son identifiant avec analysis_request_status plutôt que de demander plusieurs traitements. Lisez la couverture et la fin du traitement avant de parler d’absence de problème. Lorsque vous cessez d’utiliser un assistant, retirez son connecteur dans ses réglages. Pour un dépannage, notez sa version, la présence ou non du parcours OAuth distant et l’action ayant échoué. Masquez les secrets au lieu de transmettre une session complète ou une clé personnelle.
Questions fréquentes
Cet article vous a-t-il aidé ?