> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/docs/integration-mcp.md).

# Intégration MCP

Connectez des agents de codage IA à Edgegap via notre serveur MCP : des outils pour conteneuriser, déployer, faire du matchmaking et dépanner des serveurs de jeu, ainsi que des workflows testés pour chaque moteur et netcode.

Notre serveur MCP fournit à votre agent de codage IA personnalisé les outils dont il a besoin pour démarrer avec des builds de serveurs de jeu personnalisés et aide à valider chaque étape d'intégration grâce à notre suite de tests vérifiés.

## 👉 Fonctionnalités prises en charge

{% hint style="success" %}
**Nouveaux utilisateurs - commencez par** [Unity](https://docs.edgegap.com/fr/unity.md)**,** [Unreal Engine](https://docs.edgegap.com/fr/unreal-engine.md)**, ou** [Godot](https://docs.edgegap.com/fr/godot.md)**.** Il est recommandé d'utiliser le serveur MCP uniquement après avoir mis en ligne un serveur de jeu conteneurisé fonctionnel vers un registre de conteneurs.
{% endhint %}

Utilisez notre serveur MCP lorsque :

* **Conteneurisation de votre serveur de jeu** - votre agent rédige un Dockerfile pour votre build (ou examine celui que vous avez) selon les bonnes pratiques, pousse l'image vers notre registre de conteneurs privé et supprime les anciens tags d'image inutilisés pour libérer de la capacité dans le registre.
* **Déploiement d'un serveur dédié** - créez et mettez à jour des versions d'application, examinez les emplacements disponibles, déployez au plus près de vos joueurs et obtenez l'IP du serveur avec les ports pour tester la connexion client.
* **Construction d'un pipeline CI/CD** - testez vos déploiements et leurs suppressions depuis un système de build.
* **Dépannage d'un problème de serveur de jeu** - inspectez les versions d'application et l'état du déploiement, lisez les journaux du conteneur et l'utilisation CPU/mémoire, ou reproduisez un déploiement échoué.
* **Exécution de jeux client-hôte et pair à pair** - créez des sessions de relais offrant le NAT punchthrough et évitez le blocage des connexions. Consultez [Modèles d'orchestration](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#orchestration) avant de vous décider.

{% hint style="warning" %}
Hors périmètre / non pris en charge par MCP : création de l'exécutable serveur Linux ; création, démarrage ou arrêt d'un matchmaking (téléchargez la configuration générée dans le tableau de bord) ; navigateur de serveurs ; lobbies ; clusters gérés ; flottes privées ; ou facturation.
{% endhint %}

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Compétences

Liste et récupération des compétences de l'agent, y compris des workflows entièrement testés, des modèles de code et des garde-fous contre les pièges connus pour les moteurs, les backends de jeu et les netcodes :

* Unity, y compris Mirror, Netcode for GameObjects, FishNet, PurrNet, Photon Fusion 1 et 2.
* Unreal Engine - y compris le chat vocal EOS.
* Godot - ENET et netfox.
* Colyseus, Nakama, PlayFab, Three.js et Manus AI.

Votre agent charge la compétence correspondant à votre projet avant d'agir, et `edgegap_update_skills`  maintient à jour les copies que vous avez installées localement. [Des compétences autonomes sont également disponibles sur GitHub.](https://github.com/edgegap/llm-agent-skills)

### Garde-fous

Votre jeton API peut tout faire dans votre organisation, donc le serveur MCP limite ce qu'un agent en fait :

* **Exécution à blanc** - chaque outil qui modifie quelque chose peut d'abord afficher la requête exacte, et n'envoyer aucune donnée.
* **Aucun jeton dans les conteneurs** - les déploiements et les versions sont refusés si votre jeton API apparaît dans une variable d'environnement, un tag ou une URL de webhook.
* **Aucun tag d'image mouvant** - `latest`  et les tags vides sont refusés, car Edgegap met les images en cache par tag.
* **Limite de déploiement et arrêt automatique** - chaque déploiement est tagué `edgegap-mcp`  afin qu'il puisse être retrouvé et arrêté, indique quand Edgegap l'arrêtera, et qu'un agent en boucle ne puisse pas en lancer plus de quelques-uns à la fois.
* **Un à la fois** - l'arrêt des déploiements et la suppression des tags du registre nécessitent un identifiant exact unique ; il n'y a pas de suppression en masse.

### Exemples d'invites

* *"Écris un Dockerfile pour mon build de serveur three.js, puis pousse-le et déploie un serveur près de chez moi."*
* *"Vérifie mon Dockerfile pour Edgegap et corrige les éventuels problèmes."*
* *"Mon déploiement a échoué. Lis les journaux et dis-moi pourquoi."*
* *"Quelle quantité de CPU et de mémoire mon dernier match a-t-il utilisée ? Dimensionne ma version en conséquence."*
* *"Mon jeu utilise un réseau client-hôte. Mets en place un relais Edgegap pour deux joueurs."*

## 🚀 Installation

L'installation du serveur MCP est très simple :

1. Installez le serveur MCP pour [Intégration MCP](https://docs.edgegap.com/fr/docs/integration-mcp.md#popular-agents) ou avec [Intégration MCP](https://docs.edgegap.com/fr/docs/integration-mcp.md#custom-integration).
2. Générez et associez un jeton API que votre agent utilisera avec notre serveur MCP :

Générez des jetons secrets pour l’API Edgegap dans [Tableau de bord – Paramètres utilisateur / Jetons](https://app.edgegap.com/user-settings?tab=tokens).

Ajoutez un jeton secret à chaque requête API dans l’en-tête HTTP (incluez le mot `token`):

`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`

{% hint style="danger" %}
**N’intégrez pas les points de terminaison de l’API Edgegap dans le client du jeu, car votre jeton API donne un accès illimité à votre compte. Consultez** [Intégration](https://docs.edgegap.com/fr/docs/api/integration.md) **pour découvrir les points de terminaison et les fonctions d’API sécurisés destinés aux clients.**
{% endhint %}

{% hint style="success" %}
Si vos jetons secrets sont compromis ou divulgués, supprimez-les et créez-en de nouveaux depuis le tableau de bord.
{% endhint %}

### Agents populaires

Installez le serveur Edgegap MCP dans votre IDE agentique préféré : <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=Edgegap&#x26;config=eyJ1cmwiOiJodHRwczovL21jcC5lZGdlZ2FwLmRldi9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiIifX0%3D" class="button secondary" data-icon="cursor">Cursor</a><a href="vscode:mcp/install?%7B%22name%22%3A%22Edgegap%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.edgegap.dev%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22%22%7D%7D" class="button secondary" data-icon="vscode">VS Code</a>

Ajoutez ensuite votre jeton au `Authorization` en-tête.

#### Claude Code

{% code collapsedlinecount="10" %}

```bash
claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp \
  -H "Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62" --scope user
```

{% endcode %}

#### ChatGPT Codex

Codex lit le jeton à partir d'une variable d'environnement. Ajoutez ceci à `~/.codex/config.toml`, puis définissez `EDGEGAP_API_TOKEN` sur votre jeton dans l'environnement à partir duquel Codex démarre :

{% code title="config.toml" collapsedlinecount="10" %}

```toml
[mcp_servers.edgegap]
url = "https://mcp.edgegap.dev/mcp"
bearer_token_env_var = "EDGEGAP_API_TOKEN"
```

{% endcode %}

#### Claude Desktop

Télécharger [edgegap-mcp.mcpb](https://github.com/edgegap/llm-mcp-server/releases/latest/download/edgegap-mcp.mcpb) et ouvrez-le. Claude Desktop installe le serveur MCP comme une extension et vous demande votre jeton API, qu'il conserve dans le stockage sécurisé de votre système d'exploitation.

{% hint style="info" %}
Les connecteurs personnalisés dans claude.ai et Claude Desktop ne peuvent pas encore envoyer un `Authorization` en-tête, donc ils se connectent à `mcp.edgegap.dev` mais chaque appel d'outil échoue. Dans Claude Desktop, utilisez plutôt l'extension en un clic ci-dessus.
{% endhint %}

#### mcp.json

La plupart des IDE agentiques prennent également en charge l'intégration en collant une configuration JSON :

{% code title="mcp.json" collapsedlinecount="10" %}

```json
{
    "mcpServers": {
        "Edgegap": {
            "type": "http",
            "url": "https://mcp.edgegap.dev/mcp",
            "headers": {
                "Authorization": "EDGEGAP_API_TOKEN"
            }
        }
    }
}
```

{% endcode %}

### Intégration personnalisée

Le dépôt officiel est la source de vérité unique pour l'intégration personnalisée de notre serveur MCP :

{% embed url="<https://github.com/edgegap/llm-mcp-server>" %}

Pour conserver votre jeton API sur votre propre machine, exécutez le serveur MCP localement avec Node 18+. Ne mettez pas le jeton, et votre agent vous le demandera lors de la première utilisation :

{% code title="serveur local utilisant npx" collapsedlinecount="10" %}

```json
{
  "command": "npx",
  "args": ["-y", "@edgegap/mcp"],
  "env": { "EDGEGAP_API_TOKEN": "xxxxxxxx-e458-4592-b607-c2c28afd8b62" }
}
```

{% endcode %}

Le serveur local peut aussi être restreint davantage, par exemple à des outils en lecture seule ou à une liste d'applications. Voir le [dépôt](https://github.com/edgegap/llm-mcp-server#local-server) pour les paramètres.

Ou connectez-vous au serveur MCP Edgegap distant depuis l'environnement virtualisé de votre agent (jamais dans votre projet !) :

{% code title="node à l'aide du package npx" collapsedlinecount="10" %}

```json
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```

{% endcode %}

{% code title="python à l'aide du package uvx" collapsedlinecount="10" %}

```json
{
  "command": "uvx",
  "args": ["mcp-proxy", "--transport", "streamablehttp", "https://mcp.edgegap.dev/mcp"]
}
```

{% endcode %}

## 🚨 Dépannage

Consultez les codes d'erreur courants et découvrez comment débloquer votre intégration.

### 401 Non autorisé

Votre intégration MCP n'inclut très probablement pas correctement l'en-tête Authorization.

### Échec de l'appel d'outil

Votre client ne dispose pas d'un jeton Edgegap. Cela se produit avec les connecteurs personnalisés de claude.ai et de Claude Desktop, qui ne peuvent pas envoyer de `Authorization` en-tête. Voir [Claude Desktop](https://docs.edgegap.com/fr/docs/integration-mcp.md#claude-desktop) pour l'alternative.

{% hint style="warning" %}
Il s'agit d'une limitation connue qui sera résolue prochainement ; restez à l'écoute pour les mises à jour !
{% endhint %}

### 403 Interdit

Votre intégration MCP utilise probablement le jeton modèle ou un jeton supprimé. Veuillez vérifier que la valeur du jeton utilisée par votre intégration correspond exactement au jeton affiché dans le tableau de bord. Pour les outils de relais, un 403 signifie que votre organisation n'a pas accès aux relais.

### 424 Impossible de récupérer l'image

Veuillez vérifier votre dépôt, le nom de l'image et le tag, et vérifier si le tag a bien été poussé (demandez à votre agent de lister les tags du registre). Pour les images dans le registre Edgegap, le nom de l'image doit inclure votre projet, par exemple `my-project/my-game-server`.

### Identifiants du registre indisponibles

La récupération des identifiants nécessite un jeton spécial de démarrage rapide. [Créez-en un dans le tableau de bord sous **Registre de conteneurs**](https://app.edgegap.com/registry-management/repositories/list), ou poussez vers un autre registre (par ex. Docker Hub, GitHub, AWS ECR, GCP, GitLab).

Voir [Registres externes](https://docs.edgegap.com/docs/tools-and-integrations/docker/external-registries) pour des alternatives entièrement prises en charge au registre de conteneurs Edgegap.

### Démarre localement mais pas sur Edgegap

Demandez à votre agent de valider la configuration de votre serveur, ou de générer un nouveau Dockerfile. Les causes les plus courantes sont une image construite sur Apple Silicon sans `docker build --platform linux/amd64`, un serveur qui écoute sur un port différent de celui exposé par la version, ou un transport UDP configuré en TCP.

### Autres erreurs d'API

Veuillez consulter notre [Référence de l’API](https://docs.edgegap.com/fr/docs/api.md) pour connaître les réponses d'erreur possibles pour chaque point de terminaison individuel de l'API.

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
