Skip to main content

​
En un coup d’œil

  • Ce que vous pouvez faire : connecter n’importe quel serveur MCP que vous hébergez, comme un pont vers un CMS maison, un outil interne ou un service tiers, et laisser les agents IA de Semji utiliser ses outils.
  • Pour qui : propriétaires de workspace et développeurs qui exploitent le serveur MCP.
  • Comment ça marche : vous enregistrez le serveur une fois pour le workspace, vous le connectez avec OAuth ou une clé d’API, puis vous l’activez sur les agents IA qui doivent utiliser ses outils.
En plus des intégrations CMS natives, c’est le moyen de brancher tout ce que Semji ne couvre pas nativement.

​
Exigences pour votre serveur MCP

  • Servi en HTTPS et accessible depuis l’internet public. Les serveurs sur réseau privé ne peuvent pas être connectés.
  • Compatible avec le transport MCP streamable HTTP.
  • Si vous utilisez OAuth, le serveur doit implémenter la spécification d’autorisation MCP :
    • Il annonce ses métadonnées de ressource protégée (RFC 9728), soit via un en-tête WWW-Authenticate sur les requêtes non authentifiées, soit à l’adresse /.well-known/oauth-protected-resource.
    • Son serveur d’autorisation publie des métadonnées de découverte standard (RFC 8414 ou découverte OpenID Connect).
    • Son serveur d’autorisation prend en charge le Dynamic Client Registration (RFC 7591). Semji s’enregistre automatiquement, les identifiants client préenregistrés manuellement ne sont pas pris en charge.
    • Il accepte l’URI de redirection https://app.semji.com/integrations/mcp/callback.
  • Si vous utilisez une clé d’API, le serveur doit l’accepter sous la forme Authorization: Bearer <clé> à chaque requête.
Vous devez aussi être propriétaire du workspace dans Semji pour ajouter un serveur.

​
Comment ajouter votre serveur MCP

1

Ouvrir les intégrations MCP

Dans Semji, ouvrez Paramètres → Intégrations, allez dans l’onglet MCP et cliquez sur Ajouter un serveur. Vous devez être propriétaire du workspace.
2

Décrire le serveur

Remplissez le formulaire :
  • Nom : un nom d’affichage. Les agents le voient comme le nom du serveur.
  • Description : facultative.
  • URL : l’URL HTTPS de votre serveur MCP, par exemple https://mcp.example.com. L’URL ne peut pas être modifiée après la création.
  • Méthode d’authentification : OAuth (connexion via l’écran de consentement du fournisseur) ou clé d’API (collez un jeton). Avec la clé d’API, collez-la dans le champ Clé d’API.
3

Connecter

Cliquez sur Connecter.
  • OAuth : un nouvel onglet s’ouvre sur l’écran de consentement de votre fournisseur. Connectez-vous et validez en moins de 10 minutes.
  • Clé d’API : la clé est enregistrée immédiatement, sans test en direct auprès de votre serveur.
De retour dans l’onglet MCP, la ligne du serveur affiche son statut : Connecté, Non connecté ou Expiré.
4

L'activer sur vos agents

Ouvrez la configuration de l’agent, allez dans Enhancements → Custom MCP Servers, et activez votre serveur. L’agent découvre les outils du serveur au moment de l’exécution.
Selon la configuration de votre Semji, les connexions sont partagées par tout le workspace ou faites par utilisateur (« Each team member connects their own account. »). Avec des connexions par utilisateur, chaque collègue se connecte depuis l’onglet MCP ou depuis les paramètres de son profil. Les agents ignorent silencieusement les serveurs que l’utilisateur courant n’a pas connectés, et le chat affiche « You are not connected to …. Connect it to let this agent use it. »

​
Gérer le serveur

Depuis l’onglet MCP, chaque ligne de serveur propose :
  • Connecter / Déconnecter : gérer les identifiants stockés.
  • Modifier : changer le nom et la description. L’URL est immuable : pour la changer, supprimez le serveur et ajoutez-le de nouveau.
  • Supprimer : retire définitivement le serveur du workspace. Tous les membres connectés perdent l’accès.

​
Pare-feu et autorisation d’IP

Votre serveur MCP doit être accessible depuis l’internet public. Les serveurs de Semji l’appellent pour les connexions et les flux OAuth (découverte, enregistrement du client, échange de jeton). Semji’s servers reach the internet through a fixed set of outbound IP addresses. If a firewall, WAF, or anti-bot protection (Cloudflare, Akamai, Sucuri, …) sits in front of your site, it can block Semji’s requests — typically with a 403 Forbidden — before they ever reach your CMS, even when your credentials are correct. Allow the following Semji IP addresses:
Ne limitez pas l’accès à votre serveur MCP à la seule liste d’IP ci-dessus. Les appels d’outils des agents IA partent de l’infrastructure du fournisseur d’IA de Semji, dont les adresses ne sont pas fixes. Appuyez-vous sur OAuth ou sur la clé d’API pour l’authentification, et utilisez la liste d’IP pour exempter Semji des vérifications d’un WAF ou d’un anti-bot, pas comme une liste d’autorisation exclusive.

​
Dépannage

Semji découvre la configuration OAuth de votre serveur en direct. Les causes fréquentes, signalées par des messages d’erreur explicites :
  • Le serveur ne prend pas en charge le Dynamic Client Registration (RFC 7591). Les clients préenregistrés ne sont pas pris en charge.
  • Les métadonnées de ressource protégée sont absentes ou ne déclarent aucun serveur d’autorisation.
  • Les métadonnées du serveur d’autorisation n’ont pas d’authorization_endpoint ou de token_endpoint, ou ne sont pas servies en HTTPS.
  • Les requêtes de découverte expirent (limite de 10 secondes par requête).
Autorisez les popups pour le domaine de l’application Semji, puis reconnectez-vous.
L’autorisation du serveur n’accepte plus les identifiants stockés par Semji (pour OAuth, le jeton de rafraîchissement a été rejeté). Cliquez sur Connecter pour vous réauthentifier. Les serveurs à clé d’API redemandent la clé.
  • Le serveur n’est pas activé sur l’agent (Enhancements → Custom MCP Servers).
  • Le serveur n’est pas connecté pour l’utilisateur courant (mode par utilisateur) ou pour le workspace.
  • La clé d’API est erronée. Elle est stockée sans test en direct, une mauvaise clé n’apparaît donc qu’à l’exécution.
  • Un pare-feu bloque les appels d’outils (voir la section pare-feu ci-dessus).
Chaque URL ne peut être enregistrée qu’une fois par workspace. Réutilisez le serveur existant, ou supprimez-le d’abord si vous devez le recréer.

​
Articles liés