[{"data":1,"prerenderedAt":184},["ShallowReactive",2],{"seo-verification":3,"blog-self-host-contextforge-vps-ma-fr":6,"promo-bar-likely":183},{"google":4,"bing":5},"EycwPY2XMyTkVzas3n1ygeNJFGAH513qrMjfDljzsMQ","",{"key":7,"data":8},"blog-self-host-contextforge-vps-ma-fr",{"id":9,"slug":10,"slugs":11,"title":15,"excerpt":16,"readTime":17,"views":18,"isPinned":19,"noindex":19,"publishedAt":20,"updatedAt":21,"category":22,"categories":27,"featuredImage":29,"bgImage":30,"posterImage":31,"relatedSolution":32,"intro":35,"keyPoints":36,"sections":37,"ctaTitle":117,"ctaBody":118,"ctaButton":119,"ctaUrl":120,"relatedPosts":121},577,"self-host-contextforge-vps",{"fr":10,"en":12,"ar":13,"es":14},"self-host-contextforge-vps-mcp-gateway","استضافة-contextforge-على-vps","autoalojar-contextforge-vps-pasarela-mcp","ContextForge sur VPS : une passerelle MCP pour vos agents IA","Installez ContextForge sur un VPS avec Docker Compose : passerelle MCP open source d'IBM, API REST en outils MCP, jetons d'API et HTTPS avec nginx.",7,0,false,"2026-11-12T00:00:00+00:00","2026-11-12T13:56:19+00:00",{"id":17,"name":23,"slug":24,"color":25,"icon":26},"Self-hosting","self-hosting","bg-indigo-500\u002F10 text-indigo-400","cloud",[28],{"id":17,"name":23,"slug":24,"color":25,"icon":26},null,"\u002Fblog\u002Fcovers\u002Fbg.svg","\u002Fblog\u002Fcovers\u002Fself-host-contextforge-vps-poster.svg",{"categorySlug":33,"appSlug":34},"ia","contextforge","Chaque agent IA qui doit appeler vos outils réclame sa propre configuration : un serveur MCP par service, déclaré dans chaque client, avec ses identifiants. ContextForge, la passerelle MCP open source d'IBM, réunit tout cela derrière une seule adresse. Ce guide l'installe sur un VPS avec Docker Compose, la ferme par des jetons d'API, la publie en HTTPS derrière nginx, transforme une API REST en outil MCP et y branche un client.",[],[38,42,52,79,82,95,99,102,105,108,111,114],{"type":39,"title":40,"body":41},"h2","Ce que fait ContextForge","ContextForge est une passerelle pour le Model Context Protocol (MCP), le protocole qui permet à un agent IA de découvrir et d'appeler des outils. Elle se place entre vos clients — assistants de code, frameworks d'agents, automatisations — et les outils qu'ils utilisent : serveurs MCP distants, API REST ou gRPC existantes.\n\nLe projet est publié par IBM sous licence Apache-2.0. Il fournit une API d'administration, une console web, une gestion d'utilisateurs et de jetons, et des serveurs virtuels : des regroupements d'outils exposés chacun à sa propre adresse MCP. Sur un VPS, c'est le point d'entrée unique de vos agents.",{"type":43,"title":44,"items":45},"ul","Ce que la passerelle apporte",[46,47,48,49,50,51],"**Une seule adresse** — vos clients se connectent à la passerelle, pas à chaque outil.","**Des API REST devenues outils** — une URL, une méthode et un schéma d'entrée, sans écrire de serveur MCP.","**Des serveurs virtuels** — un jeu d'outils par agent, par projet ou par client.","**La fédération** — des serveurs MCP distants enregistrés et exposés au même endroit.","**Des jetons d'API** — un par client, avec une date d'expiration, révocables un par un.","**Une console web** — outils, serveurs, jetons et utilisateurs gérés depuis `\u002Fadmin`.",{"type":53,"title":54,"headers":55,"rows":58},"comparison","Brancher chaque outil ou passer par ContextForge",[5,56,57],"Un serveur MCP par outil","ContextForge",[59,63,67,71,75],[60,61,62],"Configuration des clients","Un outil à déclarer dans chaque client","Une adresse et un jeton",[64,65,66],"Identifiants des services","Recopiés dans chaque client","Gardés par la passerelle",[68,69,70],"API REST existante","Un serveur MCP à écrire","Déclarée comme outil",[72,73,74],"Retirer un accès","Client par client","Révoquer un jeton",[76,77,78],"Outils visibles par un agent","Tous ceux qu'il a configurés","Ceux de son serveur virtuel",{"type":39,"title":80,"body":81},"Prérequis","Un VPS Ubuntu 24.04 avec **2 Go de RAM et 2 vCPU** suffit : avec deux processus de travail, la passerelle occupe environ 800 Mo de mémoire. Les données tiennent dans une base SQLite de quelques mégaoctets.\n\nIl vous faut Docker avec le plugin Compose, nginx et certbot sur l'hôte, `jq` pour lire les réponses de l'API, et un nom (`mcp.example.com` dans ce guide) qui pointe vers l'IP du VPS.",{"type":83,"title":84,"steps":85},"steps","Installer ContextForge avec Docker Compose",[86,89,92],{"title":87,"body":88},"Générer les secrets","Dans un dossier dédié, écrivez un fichier `.env` avec le nom de domaine, le mot de passe administrateur et deux secrets distincts : `SECRET_KEY` signe les jetons, `ENCRYPTION_KEY_HEX64` chiffre les identifiants des serveurs que vous enregistrez. ContextForge refuse de démarrer avec des secrets trop courts ou laissés à leur valeur d'exemple.\n```bash\nmkdir -p \u002Fopt\u002Fcontextforge && cd \u002Fopt\u002Fcontextforge\ncat > .env \u003C\u003CEOF\nDOMAIN=mcp.example.com\nADMIN_PASSWORD=$(openssl rand -base64 18)\nSECRET_KEY=$(openssl rand -hex 32)\nENCRYPTION_KEY_HEX64=$(openssl rand -hex 32)\nEOF\nchmod 600 .env\n```",{"title":90,"body":91},"Écrire le fichier docker-compose.yml","L'image tourne sous un utilisateur non privilégié (uid 10001) : le service `contextforge-init` rend le volume inscriptible avant le démarrage. `AUTH_REQUIRED` et `MCP_REQUIRE_AUTH` ferment l'API et le point MCP, et le port n'est publié que sur la boucle locale. `DEFAULT_USER_PASSWORD`, le mot de passe provisoire des comptes créés sans mot de passe, est tiré au hasard à chaque démarrage.\n```yaml\nservices:\n  contextforge-init:\n    image: ghcr.io\u002Fibm\u002Fmcp-context-forge:v1.1.1\n    user: \"0:0\"\n    entrypoint: [\"chown\", \"-R\", \"10001:10001\", \"\u002Fapp\u002Fdata\"]\n    restart: \"no\"\n    volumes:\n      - contextforge-data:\u002Fapp\u002Fdata\n\n  contextforge:\n    image: ghcr.io\u002Fibm\u002Fmcp-context-forge:v1.1.1\n    restart: unless-stopped\n    depends_on:\n      contextforge-init:\n        condition: service_completed_successfully\n    environment:\n      HOST: \"0.0.0.0\"\n      PORT: \"4444\"\n      ENVIRONMENT: \"production\"\n      APP_DOMAIN: \"https:\u002F\u002F${DOMAIN}\"\n      ALLOWED_ORIGINS: \"https:\u002F\u002F${DOMAIN}\"\n      DATABASE_URL: \"sqlite:\u002F\u002F\u002F\u002Fapp\u002Fdata\u002Fmcp.db\"\n      CACHE_TYPE: \"database\"\n      GUNICORN_WORKERS: \"2\"\n      MCPGATEWAY_UI_ENABLED: \"true\"\n      MCPGATEWAY_ADMIN_API_ENABLED: \"true\"\n      AUTH_REQUIRED: \"true\"\n      MCP_CLIENT_AUTH_ENABLED: \"true\"\n      MCP_REQUIRE_AUTH: \"true\"\n      EMAIL_AUTH_ENABLED: \"true\"\n      PLATFORM_ADMIN_EMAIL: \"admin@example.com\"\n      PLATFORM_ADMIN_PASSWORD: \"${ADMIN_PASSWORD}\"\n      JWT_SECRET_KEY: \"${SECRET_KEY}\"\n      AUTH_ENCRYPTION_SECRET: \"${ENCRYPTION_KEY_HEX64}\"\n    entrypoint: [\"\u002Fbin\u002Fbash\", \"-c\"]\n    command:\n      - |\n        export DEFAULT_USER_PASSWORD=\"$$(python3 -c 'import secrets; print(secrets.token_urlsafe(24))')\"\n        exec .\u002Fdocker-entrypoint.sh\n    ports:\n      - \"127.0.0.1:4444:4444\"\n    volumes:\n      - contextforge-data:\u002Fapp\u002Fdata\n\nvolumes:\n  contextforge-data: {}\n```",{"title":93,"body":94},"Démarrer et vérifier","Lancez la pile, puis interrogez le point de santé. La première fois, ContextForge crée sa base et le compte administrateur ; le conteneur passe `healthy` en moins d'une minute.\n```bash\ndocker compose up -d\ndocker compose ps\ncurl -s http:\u002F\u002F127.0.0.1:4444\u002Fhealth\n```\nLa réponse attendue est `{\"status\":\"healthy\"}`. Toute autre route, `\u002Ftools` ou `\u002Fversion` par exemple, répond 401 sans jeton.",{"type":96,"title":97,"body":98},"tip","Ne désactivez jamais l'authentification","Une passerelle MCP ouverte donne à n'importe qui les outils que vous y avez branchés — et les identifiants qui vont avec. Gardez `AUTH_REQUIRED` et `MCP_REQUIRE_AUTH` à `true`, le port sur `127.0.0.1`, et laissez nginx seul face à Internet.",{"type":39,"title":100,"body":101},"Publier ContextForge en HTTPS avec nginx","Créez un server block dans `\u002Fetc\u002Fnginx\u002Fsites-available\u002F` et activez-le. `X-Forwarded-Proto` compte : la console compare l'origine du formulaire de connexion à l'adresse de la requête, et refuse la connexion si elles divergent. `proxy_buffering off` laisse passer les réponses en flux du protocole MCP.\n```nginx\nserver {\n    server_name mcp.example.com;\n\n    location \u002F {\n        proxy_pass http:\u002F\u002F127.0.0.1:4444;\n        proxy_http_version 1.1;\n        proxy_set_header Host $host;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_set_header X-Forwarded-Proto $scheme;\n        proxy_buffering off;\n        proxy_read_timeout 300s;\n    }\n}\n```\nVérifiez la configuration, puis demandez le certificat :\n```bash\nsudo nginx -t && sudo systemctl reload nginx\nsudo certbot --nginx -d mcp.example.com\n```",{"type":39,"title":103,"body":104},"Se connecter et créer un jeton d'API","Ouvrez `https:\u002F\u002Fmcp.example.com\u002Fadmin` et connectez-vous avec `admin@example.com` et le mot de passe du fichier `.env`. La console permet de créer des jetons ; l'API aussi. Le login renvoie un jeton de session de courte durée, qui sert à créer un jeton d'API nommé, valable 30 jours ici :\n```bash\nSESSION=$(curl -s https:\u002F\u002Fmcp.example.com\u002Fauth\u002Femail\u002Flogin -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"email\":\"admin@example.com\",\"password\":\"VOTRE_MOT_DE_PASSE\"}' | jq -r .access_token)\nTOKEN=$(curl -s https:\u002F\u002Fmcp.example.com\u002Ftokens -H \"Authorization: Bearer $SESSION\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"name\":\"agent-1\",\"expires_in_days\":30}' | jq -r .access_token)\n```\nCréez un jeton par client ou par agent : vous pourrez en révoquer un sans toucher aux autres.",{"type":39,"title":106,"body":107},"Transformer une API REST en outil MCP","Un outil REST se déclare par son URL, sa méthode et le schéma de ses paramètres. L'exemple ci-dessous expose l'API publique `zen` de GitHub, qui renvoie une phrase et n'attend aucun paramètre :\n```bash\ncurl -s https:\u002F\u002Fmcp.example.com\u002Ftools -H \"Authorization: Bearer $TOKEN\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"tool\":{\"name\":\"github_zen\",\"url\":\"https:\u002F\u002Fapi.github.com\u002Fzen\",\"integration_type\":\"REST\",\"request_type\":\"GET\",\"input_schema\":{\"type\":\"object\",\"properties\":{}}}}' \\\n  | jq -r .id\n```\nLa commande affiche l'identifiant de l'outil. Côté MCP, son nom devient `github-zen`. Pour une API interne, remplacez l'URL et décrivez ses paramètres dans `input_schema` : c'est ce schéma que l'agent lit pour savoir comment l'appeler.",{"type":39,"title":109,"body":110},"Regrouper les outils et brancher un client MCP","Un serveur virtuel regroupe des outils sous une adresse MCP. Créez-le avec l'identifiant de l'outil :\n```bash\ncurl -s https:\u002F\u002Fmcp.example.com\u002Fservers -H \"Authorization: Bearer $TOKEN\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"server\":{\"name\":\"demo\",\"associated_tools\":[\"ID_OUTIL\"]}}' | jq -r .id\n```\nVérifiez ensuite, comme le ferait un client, que l'outil est bien listé :\n```bash\ncurl -s https:\u002F\u002Fmcp.example.com\u002Fservers\u002FID_SERVEUR\u002Fmcp -H \"Authorization: Bearer $TOKEN\" \\\n  -H \"Accept: application\u002Fjson, text\u002Fevent-stream\" -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools\u002Flist\"}'\n```\nDans votre client MCP, déclarez l'adresse du serveur virtuel et le jeton. La forme exacte dépend du client ; beaucoup acceptent une entrée de ce type :\n```json\n{\n  \"mcpServers\": {\n    \"contextforge\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fmcp.example.com\u002Fservers\u002FID_SERVEUR\u002Fmcp\",\n      \"headers\": { \"Authorization\": \"Bearer VOTRE_JETON\" }\n    }\n  }\n}\n```",{"type":39,"title":112,"body":113},"Sauvegarder et mettre à jour","À sauvegarder : le volume `contextforge-data`, qui contient la base SQLite — outils, serveurs, utilisateurs et jetons — et le fichier `.env`. Sans `ENCRYPTION_KEY_HEX64`, les identifiants chiffrés de la base ne se relisent plus. Arrêtez le service le temps de la copie :\n```bash\ncd \u002Fopt\u002Fcontextforge\ndocker compose stop contextforge\ndocker compose cp contextforge:\u002Fapp\u002Fdata .\u002Fsauvegarde-$(date +%F)\ndocker compose start contextforge\n```\nPour mettre à jour, changez le tag de l'image dans les deux services après avoir lu les notes de version, puis :\n```bash\ndocker compose pull\ndocker compose up -d\n```\nContextForge applique ses migrations de base au démarrage : faites la sauvegarde avant.",{"type":39,"title":115,"body":116},"Installation en un clic sur ServOrbit","Sur un VPS ServOrbit, ContextForge s'installe depuis le Marketplace : le script déploie l'image officielle, génère le mot de passe administrateur et les secrets, ferme l'instance à toute requête sans jeton et configure nginx en HTTPS. L'adresse est un sous-domaine de l'un de vos domaines ou le sous-domaine gratuit du VPS, certificat compris, et le mot de passe s'affiche dans votre espace client.","Votre passerelle MCP sur un VPS","Un VPS ServOrbit Ubuntu 24.04 avec 2 Go de RAM suffit pour ContextForge. Installation en un clic depuis le Marketplace, HTTPS sur votre domaine ou sur le sous-domaine gratuit du VPS, mot de passe généré pour vous.","Installer ContextForge","\u002Fapplications\u002Fia\u002Fcontextforge",[122,143,162],{"id":123,"slug":124,"slugs":125,"title":129,"excerpt":130,"readTime":131,"views":132,"isPinned":19,"noindex":19,"publishedAt":133,"updatedAt":134,"category":135,"categories":140,"featuredImage":29,"bgImage":30,"posterImage":142,"relatedSolution":29},214,"mcp-serveur-ia-auto-heberge-vps",{"fr":124,"en":126,"ar":127,"es":128},"how-to-deploy-an-mcp-server-on-a-vps","كيفية-نشر-خادم-mcp-على-vps","desplegar-servidor-mcp-en-un-vps","Déployer un serveur MCP sur VPS auto-hébergé","Guide complet pour déployer, sécuriser et intégrer un serveur MCP sur votre VPS : nginx, TLS, authentification, dépannage et connexion à Claude Desktop.",8,4,"2026-08-03T00:00:00+00:00","2026-10-20T23:18:06+00:00",{"id":136,"name":137,"slug":138,"color":139,"icon":33},1,"Intelligence Artificielle","intelligence-artificielle","bg-purple-500\u002F10 text-purple-400",[141],{"id":136,"name":137,"slug":138,"color":139,"icon":33},"\u002Fblog\u002Fcovers\u002Fmcp-serveur-ia-auto-heberge-vps-poster.svg",{"id":144,"slug":145,"slugs":146,"title":150,"excerpt":151,"readTime":152,"views":153,"isPinned":19,"noindex":19,"publishedAt":154,"updatedAt":155,"category":156,"categories":157,"featuredImage":29,"bgImage":30,"posterImage":159,"relatedSolution":160},156,"self-host-litellm-vps",{"fr":145,"en":147,"ar":148,"es":149},"self-host-litellm-on-a-vps-your-private-llm-api-gateway","استضف-litellm-ذاتيا-على-vps-بوابة-api-خاصة-لنماذج-llm","alojar-litellm-en-un-vps-pasarela-llm-privada","Héberger LiteLLM sur un VPS : votre passerelle d'API LLM privée","Déployez LiteLLM sur un VPS ServOrbit : passerelle d'API compatible OpenAI vers Ollama, Anthropic, Azure et 100+ LLM, avec suivi des dépenses et limites par clé.",9,3,"2026-01-21T00:00:00+00:00","2026-11-09T20:55:12+00:00",{"id":17,"name":23,"slug":24,"color":25,"icon":26},[158],{"id":17,"name":23,"slug":24,"color":25,"icon":26},"\u002Fblog\u002Fcovers\u002Fself-host-litellm-vps-poster.svg",{"categorySlug":33,"appSlug":161},"litellm",{"id":153,"slug":163,"slugs":164,"title":168,"excerpt":169,"readTime":170,"views":132,"isPinned":19,"noindex":19,"publishedAt":171,"updatedAt":172,"category":173,"categories":178,"featuredImage":29,"bgImage":30,"posterImage":180,"relatedSolution":181},"installer-n8n-vps",{"fr":163,"en":165,"ar":166,"es":167},"install-n8n-on-vps-with-docker-complete-2026-guide","تثبيت-n8n-على-vps-مع-docker-دليل-شامل-2026","instalar-n8n-en-vps-con-docker","Installer n8n sur VPS avec Docker : guide complet 2026","Déployez n8n sur VPS avec Docker, reverse proxy et HTTPS. Crash V8, 502 nginx, migration npm vers Docker et sécurisation des exécutions persistées (advisory août 2026).",19,"2026-06-05T00:00:00+00:00","2026-11-10T14:39:01+00:00",{"id":174,"name":175,"slug":176,"color":177,"icon":176},2,"Automatisation","automatisation","bg-brand-action\u002F10 text-brand-action",[179],{"id":174,"name":175,"slug":176,"color":177,"icon":176},"\u002Fblog\u002Fcovers\u002Finstaller-n8n-vps-poster.svg",{"categorySlug":176,"appSlug":182},"n8n",true,1794785659647]