Connecter Nicoka dans Mistral

Le connecteur MCP Nicoka vous permet d'interroger et de mettre à jour vos données Nicoka (candidats, contacts, opportunités, factures…) directement depuis Le Chat de Mistral. Vous pouvez par exemple demander « Liste-moi les candidats ajoutés cette semaine » ou « Ajoute une note au contact Jean Dupont ».

Avant de commencer

• Côté Mistral : l'ajout d'un connecteur personnalisé peut être réservé aux administrateurs de votre organisation Le Chat. En cas de doute, consultez l'aide de Mistral.
• Côté Nicoka : votre profil doit vous autoriser à connecter une application. Si la connexion est refusée, demandez à l'administrateur Nicoka de votre entreprise.
• L'adresse de votre serveur MCP : https://VOTRE-INSTANCE.nicoka.com/api/mcp. Remplacez VOTRE-INSTANCE par le sous-domaine de votre espace Nicoka, celui que vous voyez dans la barre d'adresse de votre navigateur. En cas de doute, demandez-la au support Nicoka.

1. Ajouter le connecteur Nicoka dans Le Chat

1. Connectez-vous au Chat de Mistral, puis ouvrez la gestion des connecteurs.
2. Ajoutez un connecteur MCP personnalisé et renseignez :
   • Nom du connecteur : nicoka (sans espace ni caractère spécial) ;
   • URL du serveur : https://VOTRE-INSTANCE.nicoka.com/api/mcp ;
   • Description (facultatif) : Accès aux données Nicoka.
3. Lancez la connexion.

2. Autoriser l'accès avec votre compte Nicoka

1. Le Chat détecte que le serveur Nicoka utilise OAuth et vous redirige vers Nicoka. Si vous n'êtes pas déjà connecté, identifiez-vous avec votre compte Nicoka habituel.
2. L'écran Autoriser l'accès de Nicoka indique l'application qui demande l'accès, votre nom, et liste ce qu'elle pourra faire. Cliquez sur Autoriser.

Vous revenez ensuite dans Le Chat, où le connecteur Nicoka apparaît parmi vos connecteurs. Le Chat n'a jamais accès à votre mot de passe Nicoka, et il agit avec vos droits : il ne voit que ce que vous voyez dans Nicoka.

3. Régler les permissions et tester

1. Dans les réglages du connecteur Nicoka, choisissez pour chaque fonction si Le Chat peut l'utiliser sans vous demander confirmation.
2. Ouvrez une nouvelle conversation, activez le connecteur Nicoka dans le menu des outils, puis posez une première question, par exemple : « Liste mes 5 dernières opportunités dans Nicoka ».

Conseil : autorisez en permanence les fonctions de lecture que vous utilisez souvent (liste des candidats, recherche de contacts…). Gardez la confirmation pour les fonctions d'écriture (création ou modification de fiches) le temps de prendre vos marques. Le détail des outils est dans Ce que votre assistant IA peut faire dans Nicoka (MCP).

4. En cas de problème

• Le Chat signale que la connexion MCP est invalide : vérifiez que l'adresse du serveur se termine bien par /api/mcp et que vous avez le droit d'ajouter un connecteur dans votre organisation.
• Nicoka refuse l'accès : votre profil Nicoka ne vous autorise pas à connecter une application. Contactez l'administrateur Nicoka de votre entreprise.
• L'autorisation a expiré ou de nouveaux outils n'apparaissent pas : déconnectez puis reconnectez le connecteur, comme expliqué dans Actualisez votre connexion IA avec Nicoka (MCP).

Besoin d'aide ? Contactez le support Nicoka.