> 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 des serveurs MCP, en exposant une boîte à outils de dépannage pour vos déploiements de serveurs de jeu.
Les serveurs MCP offrent une boîte à outils pratique de dépannage pour vos agents d’IA de codage personnalisés.
## 👉 Fonctionnalités prises en charge
{% hint style="success" %}
**Nouveaux utilisateurs - commencez par** [Unity](/fr/unity.md)**,** [Unreal Engine](/fr/unreal-engine.md)**, ou** [Godot](/fr/godot.md)**.** L’utilisation du serveur MCP n’est recommandée qu’après avoir téléchargé sur un registre de conteneurs un serveur de jeu conteneurisé fonctionnel.
{% endhint %}
Utilisez notre serveur MCP lorsque :
* **Conteneuriser votre serveur de jeu** - votre agent rédige un Dockerfile pour votre build (ou vérifie celui que vous avez) par rapport aux exigences d’Edgegap, puis pousse l’image vers votre registre de conteneurs Edgegap privé.
* **Déployer un serveur dédié** - créer une application et une version, déployer près de vos joueurs et obtenir les détails de connexion.
* **Construire un pipeline CI/CD** - tester vos déploiements et leur suppression depuis un système de build.
* **Résoudre un problème de serveur de jeu** avec votre propre agent de codage : inspecter les versions d’application et l’état du déploiement, lire les journaux du conteneur ou reproduire un déploiement échoué.
* **Exécuter un jeu hôte-client** - créer une session relais si votre jeu est construit avec un joueur en tant qu’hôte. Voir [Serveurs dédiés ou relais ?](https://github.com/edgegap/edgegap-mcp#dedicated-servers-or-relays) d’abord.
{% hint style="warning" %}
Hors champ / non pris en charge par MCP : créer l’exécutable Linux du serveur ; configurer le matchmaking ; le navigateur de serveurs ; les salons ; les clusters gérés ; les flottes privées ; les relais ; ou la 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 %}
### Exemples d’invites
* *« Écris un Dockerfile pour ma 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. »*
* *« Mon jeu utilise un réseau hôte-client. Configure un relais Edgegap pour deux joueurs. »*
## 🚀 Installation
L’installation du serveur MCP est très simple :
1. Installez le serveur MCP pour [#popular-agents](#popular-agents "mention") ou avec [#custom-integration](#custom-integration "mention").
2. Générez et joignez un jeton API pour que votre agent l’utilise avec notre serveur MCP :
Générez (et consultez) vos jetons secrets pour l’API Edgegap dans [Tableau de bord - Paramètres utilisateur / Jetons](https://app.edgegap.com/user-settings?tab=tokens).
Ajoutez votre jeton secret à chaque requête API sous forme d’en-tête HTTP (incluez le mot `jeton`):
`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 offre un accès illimité à votre compte. Voir** [Intégration](/fr/docs/api/integration.md) **pour des points de terminaison et des fonctions d’API sécurisés destinés au client.**
{% endhint %}
{% hint style="success" %}
Si vos jetons secrets sont compromis ou divulgués, supprimez-les et recréez-les depuis le tableau de bord.
{% endhint %}
### Agents populaires
Installez le serveur Edgegap MCP dans votre IDE agentique préféré : CursorVS Code
#### Claude Code
```bash
claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp \\
-H "Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62" --scope user
```
#### ChatGPT Codex
```bash
codex mcp add edgegap --url https://mcp.edgegap.dev/mcp
```
#### mcp.json
La plupart des IDE agentiques prennent également en charge l’intégration en collant une configuration JSON :
{% code title="mcp.json" %}
```json
{
"mcpServers" : {
"Edgegap" : {
"type" : "http",
"url" : "https://mcp.edgegap.dev/mcp",
"headers" : {
"Authorization" : "token xxxxxxxx-e458-4592-b607-c2c28afd8b62"
}
}
}
}
```
{% 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="" %}
Installez le serveur MCP Edgegap distant dans l’environnement virtualisé de votre agent (jamais dans votre projet !) :
{% code title="node avec le package npx" %}
```json
{
"command" : "npx",
"args" : ["-y", "mcp-remote", "https://mcp.edgegap.dev/mcp", "--transport", "http-only"]
}
```
{% endcode %}
{% code title="python avec le package uvx" %}
```json
{
"command" : "uvx",
"args" : ["mcp-proxy", "--transport", "streamablehttp", "https://mcp.edgegap.dev/mcp"]
}
```
{% endcode %}
## 🚨 Dépannage
Passez en revue les codes d’erreur courants et découvrez comment déverrouiller votre intégration.
### 401 Non autorisé
Il est très probable que votre intégration MCP n’inclue pas correctement l’en-tête Authorization.
### 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.
### 424 Impossible de récupérer l’image
Edgegap n’a pas pu récupérer votre image de conteneur. Vérifiez le dépôt, le nom de l’image et le tag, et vérifiez si le tag a bien été poussé (demandez à votre agent d’afficher les tags du registre). Pour les images du registre Edgegap, le nom de l’image doit inclure votre projet, par ex. `my-project/my-game-server`.
### Identifiants du registre indisponibles
Si votre agent ne peut pas récupérer les identifiants du registre, [demandez-les dans le tableau de bord sous **Registre de conteneurs**](https://app.edgegap.com/registry-management/repositories/list), ou poussez vers un autre registre depuis lequel Edgegap peut récupérer l’image (Docker Hub, GitHub, AWS ECR, GCP, GitLab). Voir [Registres externes](https://docs.edgegap.com/docs/tools-and-integrations/docker/external-registries).
### Le serveur 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 écoutant 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](/fr/docs/api.md) pour connaître les réponses d’erreur possibles pour chaque point de terminaison d’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 %}