Connecter Nicoka dans Microsoft Copilot

Le MCP Nicoka relie Microsoft Copilot à votre espace Nicoka : candidats, missions, contacts, opportunités, factures. Vous posez vos questions dans Copilot, la réponse arrive dans la conversation, avec vos droits et vos données. Quand vous le demandez, Copilot crée aussi des éléments dans Nicoka, par exemple une note ou une tâche.

Deux chemins, selon votre Copilot

  • Copilot Studio : vous ajoutez le serveur MCP Nicoka comme outil d'un agent. C'est le chemin le plus direct, sans identifiant ni secret à créer au préalable. Commencez par celui-là.
  • Microsoft 365 Copilot : vous déclarez Nicoka comme connecteur pour toute l'organisation, depuis le centre d'administration Microsoft 365. Réservé à un administrateur, avec une inscription OAuth préalable et une préparation côté Nicoka.

Avant de commencer

  • 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.
  • Côté Nicoka : votre profil doit vous autoriser à connecter une application. Si la connexion est refusée, demandez à l'administrateur Nicoka de votre entreprise.
  • Côté Microsoft : l'ajout d'un outil ou d'un connecteur dépend de votre licence et des règles de votre organisation. En cas de doute, rapprochez-vous de votre administrateur Microsoft 365.

Parcours 1. Ajouter Nicoka dans un agent Copilot Studio

  1. Ouvrez votre agent dans Copilot Studio, puis la page Outils.
  2. Cliquez sur Ajouter un outil, puis sur Nouvel outil.
  3. Dans la section Créer, choisissez Model Context Protocol : l'assistant d'intégration MCP s'ouvre.
  4. Renseignez les trois champs demandés :
    • Nom du serveur : Nicoka ;
    • Description du serveur : par exemple « Données Nicoka : candidats, missions, contacts, opportunités, factures ». L'agent s'en sert pour décider quand appeler Nicoka ;
    • URL du serveur : https://VOTRE-INSTANCE.nicoka.com/api/mcp.
  5. Comme type d'authentification, choisissez OAuth 2.0, puis le type Découverte dynamique (Dynamic discovery). Nicoka publie ses adresses d'autorisation et enregistre l'agent tout seul : vous n'avez ni identifiant ni secret à saisir.
  6. Cliquez sur Créer, puis sur Suivant : la fenêtre Ajouter un outil s'affiche.
  7. Choisissez Créer une connexion. Copilot vous redirige vers Nicoka : identifiez-vous avec votre compte habituel si vous n'êtes pas déjà connecté, puis, sur l'écran Autoriser l'accès, vérifiez les autorisations affichées et cliquez sur Autoriser.
  8. De retour dans Copilot Studio, cliquez sur Ajouter à l'agent.

Testez dans le volet de conversation de l'agent, par exemple : « Liste mes 5 dernières opportunités dans Nicoka ». Copilot 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.

Parcours 2. Déclarer Nicoka comme connecteur Microsoft 365 Copilot

Ce parcours est réservé à un administrateur disposant du rôle Administrateur général ou Administrateur IA. Il se fait en deux temps : l'inscription OAuth dans le Portail développeur Teams, puis la création du connecteur.

Ce parcours demande une préparation de notre côté : contactez le support Nicoka avant de commencer. L'adresse de redirection de Microsoft, https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect, n'est pas autorisée par défaut sur votre espace ; le support l'ajoute et vous transmet l'identifiant client et le secret client OAuth. Sans cette étape, la connexion est refusée.

a. Inscrire la connexion OAuth

  1. Connectez-vous au Portail développeur Teams.
  2. Ouvrez Outils, puis Inscription du client OAuth, et cliquez sur Nouvelle connexion OAuth.
  3. Renseignez la connexion :
    • Nom : Nicoka ;
    • Identifiant client et secret client : ceux fournis par Nicoka ;
    • Point de terminaison d'autorisation : https://VOTRE-INSTANCE.nicoka.com/api/oauth/authorize ;
    • Point de terminaison de jeton et point de terminaison d'actualisation : https://VOTRE-INSTANCE.nicoka.com/api/oauth/token ;
    • Étendues : mcp:read mcp:write.
  4. Activez PKCE, pris en charge par Nicoka, puis enregistrez. Notez l'identifiant d'inscription OAuth affiché : il est demandé à l'étape suivante.

b. Créer le connecteur

  1. Dans le centre d'administration Microsoft 365, ouvrez Copilot, puis Connecteurs.
  2. Dans l'onglet Galerie, section Créé par votre organisation, cliquez sur Ajouter dans la tuile Créer un connecteur.
  3. Sur la page Connecteur personnalisé, sous Se connecter à un serveur MCP, cliquez sur Ajouter.
  4. Renseignez le nom d'affichage (Nicoka), une description des données accessibles, et l'URL de base : https://VOTRE-INSTANCE.nicoka.com/api/mcp.
  5. Saisissez l'identifiant d'inscription OAuth obtenu au Portail développeur Teams, puis cliquez sur Enregistrer.

Le connecteur apparaît dans Vos connexions. Déployez-le d'abord sur quelques utilisateurs avec le déploiement par étapes, puis sur toute l'organisation. Comptez jusqu'à dix minutes de propagation. Chaque utilisateur se connecte ensuite avec son propre compte Nicoka, depuis Paramètres puis Sources dans Copilot.

En cas de problème

  • Le serveur ne se crée pas dans Copilot Studio : vérifiez que l'adresse se termine bien par /api/mcp, et que vous avez choisi OAuth 2.0 puis Découverte dynamique.
  • Nicoka refuse l'accès : votre profil Nicoka ne vous autorise pas à connecter une application. Contactez l'administrateur Nicoka de votre entreprise.
  • Nicoka refuse l'adresse de redirection : l'adresse de Microsoft n'a pas encore été autorisée sur votre espace. C'est l'étape préalable du parcours 2 : contactez le support Nicoka.
  • Copilot n'utilise pas Nicoka : vérifiez que l'outil est bien rattaché à l'agent, puis nommez Nicoka dans votre demande : « Dans Nicoka, liste mes 5 dernières opportunités ».
  • Un utilisateur ne voit pas le connecteur Microsoft 365 : vérifiez qu'il est inclus dans le déploiement par étapes et dans l'accès utilisateur, puis demandez-lui d'ouvrir une nouvelle conversation.
  • Votre espace filtre les accès par adresse IP : autorisez les adresses de sortie de Microsoft 365 Copilot, listées dans la documentation Microsoft.
  • L'autorisation a expiré ou de nouveaux outils n'apparaissent pas : déconnectez puis reconnectez Nicoka, comme expliqué dans Actualisez votre connexion IA avec Nicoka (MCP).

Le détail des actions possibles, module par module, est dans Ce que votre assistant IA peut faire dans Nicoka (MCP). Besoin d'aide ? Contactez le support Nicoka.

Ces informations vous ont-elles été utiles ?

 Sommaire