> ## Documentation Index
> Fetch the complete documentation index at: https://help.semji.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Serveur MCP personnalisé : connectez vos propres outils aux agents Semji

> Apportez votre propre serveur MCP, pont vers un CMS maison ou outil interne, et laissez les agents IA de Semji utiliser ses outils via OAuth ou une clé d'API.

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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é.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  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. »
</Note>

## 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:

```text theme={null}
63.34.75.122
63.35.78.179
54.228.104.165
18.200.156.37
34.248.117.83
52.213.28.177
```

<Warning>
  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.
</Warning>

## Dépannage

<AccordionGroup>
  <Accordion title="La connexion OAuth échoue immédiatement">
    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).
  </Accordion>

  <Accordion title="La fenêtre popup a été bloquée par votre navigateur. Autorisez les popups pour vous connecter au serveur MCP.">
    Autorisez les popups pour le domaine de l'application Semji, puis reconnectez-vous.
  </Accordion>

  <Accordion title="Le statut affiche Expiré">
    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é.
  </Accordion>

  <Accordion title="Les agents ne voient pas les outils du serveur">
    * 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).
  </Accordion>

  <Accordion title="Un serveur MCP avec l'URL … existe déjà dans ce workspace">
    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.
  </Accordion>
</AccordionGroup>

## Articles liés

* [MCP : connectez Claude ou un autre assistant IA à Semji](/fr/connect-your-tools/mcp) : le sens inverse, utiliser les outils de Semji depuis Claude et d'autres assistants.
* [Connecter votre CMS : publiez vos contenus dans votre CMS sans quitter Semji](/fr/connect-your-tools/cms-publisher)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.