Intégration MCP

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

Nouveaux utilisateurs - commencez par Unity, Unreal Engine, ou Godot. 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.

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 ? d’abord.

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.

Si vous avez besoin d’aide, veuillez nous contacter sur Discord. Pour l’assistance aux jeux en direct, consultez notre système de tickets.

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 Intégration MCP ou avec Intégration MCP.

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.

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

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 pour des points de terminaison et des fonctions d’API sécurisés destinés au client.

Si vos jetons secrets sont compromis ou divulgués, supprimez-les et recréez-les depuis le tableau de bord.

Agents populaires

Installez le serveur Edgegap MCP dans votre IDE agentique préféré : CursorVS Code

Claude Code

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

ChatGPT Codex

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 :

mcp.json

{
    "mcpServers" : {
        "Edgegap" : {
            "type" : "http",
            "url" : "https://mcp.edgegap.dev/mcp",
            "headers" : {
                "Authorization" : "token xxxxxxxx-e458-4592-b607-c2c28afd8b62"
            }
        }
    }
}

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 :

GitHub - edgegap/edgegap-mcp: Edgegap MCP server for LLM agentsGitHub

Installez le serveur MCP Edgegap distant dans l’environnement virtualisé de votre agent (jamais dans votre projet !) :

node avec le package npx

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

python avec le package uvx

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

🚨 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, 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.

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 pour connaître les réponses d’erreur possibles pour chaque point de terminaison d’API.

Si vous avez besoin d’aide, veuillez nous contacter sur Discord. Pour l’assistance aux jeux en direct, consultez notre système de tickets.