# Serveurs MCP

> Connectez des serveurs MCP distants pour que les agents d'AI CodeOps puissent appeler leurs outils : ajoutez un serveur, gardez ses en-têtes chiffrés et limitez les outils par agent et par politique.

Source: https://aicodeops.dev/fr/docs/mcp-servers · Mis à jour le: 2026-10-18

Le Model Context Protocol (MCP) permet à un agent IA d'appeler des outils sur un autre service, comme un gestionnaire de tickets ou une recherche dans la documentation. Dans AI CodeOps, vous connectez des serveurs MCP à votre espace de travail et les agents de vos sessions peuvent utiliser leurs outils.

Ici, AI CodeOps est le client : il se connecte **aux** serveurs MCP que vous ajoutez. Pour utiliser plutôt AI CodeOps depuis votre propre assistant de codage, consultez [le serveur MCP d'AI CodeOps](https://aicodeops.dev/fr/docs/mcp-server).

La prise en charge de MCP est en bêta.

## Serveurs distants et locaux

| Type                      | Ce que vous saisissez                         | Utilisé par les sessions ?                                     |
| ------------------------- | --------------------------------------------- | -------------------------------------------------------------- |
| **Remote (HTTP/SSE URL)** | L'URL du serveur et des en-têtes HTTP         | Oui                                                            |
| **Local (stdio command)** | Une commande et des variables d'environnement | Non. Il est enregistré, mais les sessions ne le démarrent pas. |

Les sessions s'exécutent sur la plateforme, pas sur votre ordinateur : elles ne peuvent donc pas démarrer un programme sur votre machine. Utilisez un serveur distant pour tout ce que vos agents doivent appeler.

Les serveurs distants doivent :

- se trouver à une adresse HTTPS publique (les réseaux privés et `localhost` sont refusés) ;
- parler le transport MCP **Streamable HTTP** (JSON-RPC sur POST, avec une réponse en JSON ou en flux d'événements) ;
- accepter l'authentification dans des en-têtes statiques, comme un bearer token. Les serveurs qui nécessitent une connexion OAuth ne sont pas encore pris en charge, pas plus que l'ancien transport uniquement SSE.

## Ajouter un serveur

1. Ouvrez **Configure → MCP Servers** et choisissez **Add MCP server**.
2. Saisissez un **Name**, par exemple « GitHub ». AI CodeOps en tire l'identifiant du serveur, en minuscules avec des tirets : « GitHub » devient `github`, « Docs Search » devient `docs-search`. Les noms d'outils et les règles de politique utilisent cet identifiant.
3. Choisissez **Remote (HTTP/SSE URL)** et saisissez la **Server URL**.
4. Sous **Headers**, ajoutez un `KEY=value` par ligne, par exemple :

   ```text
   Authorization=Bearer <your token>
   ```

5. Choisissez **Save MCP server**.

Le serveur apparaît sous **Servers** avec **Disable** et **Remove**. Il n'y a pas encore de formulaire de modification : pour changer un serveur, supprimez-le et ajoutez-le de nouveau.

La gestion des serveurs MCP nécessite la permission MCP-manage : les rôles Owner, Admin et DevOps Admin par défaut.

## Comment les secrets sont stockés

Les en-têtes (serveurs distants) et les variables d'environnement (serveurs locaux) sont chiffrés au repos avec AES-256-GCM. Ils ne sont jamais renvoyés au navigateur ; la liste indique seulement quelles clés sont définies, par exemple « 1 header: Authorization ». Ils ne sont déchiffrés que lorsqu'une session se connecte au serveur. La création, la modification, l'activation, la désactivation et la suppression d'un serveur sont enregistrées dans le [journal d'audit](https://aicodeops.dev/fr/docs/audit-logs).

## Comment les agents obtiennent les outils

Lorsqu'une session démarre, AI CodeOps se connecte à chaque serveur distant activé et liste ses outils. Un serveur injoignable est ignoré, et la session s'exécute sans ses outils.

- Les outils sont nommés `<server>__<tool>`, par exemple `github__create_issue`.
- Une session peut proposer jusqu'à 32 outils MCP au total.
- À chaque étape d'agent, un agent peut effectuer jusqu'à 6 séries d'appels d'outils.
- Chaque appel expire au bout de 30 secondes, et les résultats longs sont raccourcis.

Vous pouvez restreindre de deux façons les outils qui parviennent aux agents.

### Par agent

Dans **Configure → Agents**, un agent personnalisé a un choix **MCP tools this agent may use** : **None** (la valeur par défaut pour un nouvel agent), **Only the tools listed** ou **All tools the workspace allows**. Pour une liste, saisissez des serveurs, des outils ou des noms `server__tool`, séparés par des virgules. Un agent enregistré avant l'existence de ce choix conserve tous les outils tant que vous ne le modifiez pas.

### Par la politique de l'espace de travail

Une [règle de politique](https://aicodeops.dev/fr/docs/policy-engine) sur l'action `mcp.invoke` vise `server/tool`. Un outil que la politique n'autorise pas n'est jamais proposé aux agents. Par exemple, pour tenir tous les outils de suppression du serveur GitHub à l'écart de vos sessions :

```json
{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
```

Les règles `mcp.invoke` peuvent utiliser `allow` ou `deny`, pas `ask`. Avec le réglage de confiance **None**, les outils MCP sont refusés sauf si une règle les autorise.

## Dépannage

Si une session n'utilise pas les outils d'un serveur :

- Vérifiez que le serveur est activé et qu'il s'agit d'un serveur **Remote**.
- Vérifiez que l'URL est en HTTPS public et que le serveur prend en charge Streamable HTTP, pas seulement SSE.
- Vérifiez les en-têtes : un token expiré fait que le serveur refuse la connexion.
- Vérifiez le champ **MCP tools allowed** de l'agent personnalisé et la politique de votre espace de travail.

## Étapes suivantes

- [Agents et workflows](https://aicodeops.dev/fr/docs/agents)
- [Référence des règles de politique](https://aicodeops.dev/fr/docs/policy-engine)
- [Audit des dépendances](https://aicodeops.dev/fr/docs/dependency-audit)

## Questions fréquentes

### AI CodeOps est-il lui-même un serveur MCP ?

Oui, indépendamment de cette page. Son serveur MCP permet à Claude Code, à Cursor ou à un autre client MCP d'utiliser votre espace de travail ; consultez le guide du serveur MCP d'AI CodeOps. Cette page traite de l'autre sens, les serveurs auxquels vos sessions se connectent.

### Les sessions démarrent-elles des serveurs MCP locaux (stdio) ?

Non. Vous pouvez enregistrer un serveur local, mais les sessions ne se connectent qu'à des serveurs distants, en HTTPS.

### Puis-je voir un en-tête après l'avoir enregistré ?

Non. Les en-têtes et les variables d'environnement sont chiffrés au repos et ne sont plus jamais affichés. La liste indique seulement quelles clés sont définies.
