Naski
FonctionnalitésIntégrationsTarifsDocumentationSécuritéBlog
ConnexionCommencer gratuitement
Documentation

Comment s’en servir, concrètement

Les trois choses dont une nouvelle équipe a besoin le premier jour. Tout décrit ici le produit tel qu’il est livré aujourd’hui.

01

Ce qu’est un agent, et comment en demander un

Un agent est un morceau de TypeScript écrit contre un seul objet. Vous n’avez pas à l’écrire : décrivez le travail dans le chat, Naski l’écrit, puis vous montre le code avant tout enregistrement.

  1. 1

    Dites ce qui doit se passer, et quand. « Chaque jour ouvré à 8 h », « dès qu’un PDF arrive dans un dossier », « quand quelqu’un écrit à cette adresse ». L’horaire et le déclencheur sont lus dans le code sans l’exécuter : ils s’écrivent donc en valeurs fixes.

  2. 2

    Lisez ce qu’il fait avant d’enregistrer. Le code est le comportement — il n’y a rien de caché derrière.

  3. 3

    Donnez-lui un dossier s’il ne doit voir qu’une partie de votre espace. Ses outils de fichiers sont alors confinés à cette arborescence.

  4. 4

    Laissez-le tenir un journal. Un agent écrit une ligne en clair par chose faite, marquée en cours ou terminée, et les relit à l’exécution suivante. C’est ainsi qu’un travail long survit à son découpage en exécutions courtes.

  5. 5

    Décidez de ce qui passe par vous. Demander une validation met l’exécution en pause jusqu’à ce qu’une personne réponde, et traite le silence comme un refus ; déposer une relecture met un élément en file sans bloquer.

  6. 6

    Modifier un agent en crée un nouveau : la version qui marchait reste récupérable.

Bon à savoirLes agents n’ont aucun accès réseau ambiant. Tout ce qu’ils atteignent — le web, votre espace, un outil connecté — passe par un appel nommé que la plateforme effectue pour eux.

02

Comment connecter un outil

Un connecteur est de la donnée, pas du code : une adresse de base, une forme d’authentification et une liste d’opérations. Naski construit la requête et injecte votre secret côté serveur.

  1. 1

    Ouvrez Réglages → Connecteurs et installez depuis le catalogue. Vous pouvez aussi demander au chat de le faire.

  2. 2

    Là où le fournisseur est enregistré sur votre déploiement, cliquez sur Connecter et validez sur son propre écran. Aucune clé n’est copiée nulle part.

  3. 3

    Sinon, collez la clé dans les Réglages. Ne collez jamais une clé dans un message du chat : les clés vivent dans les Réglages, où elles sont chiffrées et injectées côté serveur.

  4. 4

    Certains services vivent à l’adresse de votre entreprise — Salesforce, Zendesk, Jira, Confluence, Zoho CRM, Odoo, Shopify, DocuSign. Leur installation demande l’URL de votre instance et refuse sans elle.

  5. 5

    Les appels sortants se font uniquement en HTTPS, et sont refusés si l’adresse résout vers un réseau privé ou réservé.

  6. 6

    Si un fournisseur refuse de rafraîchir un jeton, la connexion est effacée et on vous dit de vous reconnecter — plutôt que de laisser chaque appel échouer en silence.

Bon à savoirUn service absent du catalogue reste atteignable : le chat peut écrire un connecteur pour lui dans la même forme déclarative, et un serveur MCP distant couvre les services outillés.

03

Comment connecter un client IA externe

Naski expose son propre serveur MCP : un client comme Claude Code, Claude Desktop ou ChatGPT peut lister, créer, exécuter et inspecter vos agents depuis l’endroit où vous travaillez déjà.

  1. 1

    Ouvrez Réglages → Serveurs MCP. L’adresse y est affichée, et c’est celle-ci :

    https://api.blackbox.finance/mcp
  2. 2

    Claude Desktop et ChatGPT se connectent en OAuth : ajoutez l’adresse comme connecteur et validez. Aucun jeton à copier.

  3. 3

    Pour un client en ligne de commande, générez un jeton dans les Réglages et lancez :

    claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"
  4. 4

    Un jeton n’est affiché qu’une fois et n’est stocké que sous forme de hachage. Révoquez-le depuis le même écran ; un compte peut en détenir jusqu’à vingt.

  5. 5

    Les connexions IA externes font partie des offres payantes — l’offre gratuite ne les inclut pas.

Bon à savoirTout ce qu’un client MCP voit est limité au compte dont il utilise le jeton : ses agents, ses exécutions et ses crédits, rien d’autre.

Prêt à l’essayer sur un vrai flux de travail ?

L’offre gratuite comprend un agent actif et une exécution planifiée — de quoi voir si la forme convient avant que quiconque signe quoi que ce soit.

Commencer gratuitementNous contacter