[{"data":1,"prerenderedAt":1429},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Freplacing-local-eval-with-isolated-cloudflare-workers":3,"series-context-\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers":1235},{"id":4,"title":5,"body":6,"contentId":1220,"date":1221,"description":1222,"extension":1223,"github":1224,"meetTheInstructor":1226,"meta":1227,"navigation":459,"part":219,"path":1228,"rawbody":1229,"robots":1226,"schemaOrg":1226,"seo":1230,"seriesSlug":1231,"sitemap":1232,"stem":1233,"subtitle":1226,"topics":1226,"__hash__":1234},"series\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Freplacing-local-eval-with-isolated-cloudflare-workers.md","Remplacer l'évaluateur par des Workers Cloudflare isolés",{"type":7,"value":8,"toc":1210},"minimark",[9,18,21,26,29,32,35,79,85,92,96,99,102,105,108,112,115,118,121,124,127,138,145,149,152,155,159,162,165,298,301,315,685,688,741,754,758,761,866,886,1066,1069,1073,1076,1079,1082,1185,1188,1192,1195,1203,1206],[10,11,12,13,17],"p",{},"Dans les parties précédentes, nous avons implémenté des outils de recherche et d'exécution qui utilisaient un évaluateur local de confiance basé sur le constructeur ",[14,15,16],"code",{},"Function"," pour exécuter le code généré par l'IA. Cette approche fonctionnait pour le développement, mais soulevait de sérieux problèmes de sécurité.",[10,19,20],{},"Dans cette partie, nous remplacerons cet évaluateur local par un environnement isolé fondé sur les Workers Cloudflare dynamiques. L'isolation et les capacités explicites nous permettront de limiter les actions du code généré au lieu de lui accorder les permissions de l'hôte.",[22,23,25],"h2",{"id":24},"les-entrées-utilisateur-ne-sont-pas-fiables","Les entrées utilisateur ne sont pas fiables",[10,27,28],{},"L'une des premières choses que nous apprenons en créant des sites avec des formulaires est que les entrées utilisateur ne sont pas fiables. Le danger ne vient pas seulement des personnes malveillantes, mais aussi des erreurs et des valeurs inattendues.",[10,30,31],{},"Le code généré est lui aussi une entrée utilisateur. Un modèle peut se tromper, et une personne malveillante peut essayer de l'orienter vers une action dangereuse.",[10,33,34],{},"Imaginez qu'au lieu d'écrire une fonction pour rechercher dans la spécification OpenAPI, le modèle produise le code suivant :",[36,37,43],"pre",{"className":38,"code":39,"filename":40,"language":41,"meta":42,"style":42},"language-typescript shiki shiki-themes github-light github-light github-dark","async () => {\n  return process.env\n}\n","Exemple","typescript","",[14,44,45,64,73],{"__ignoreMap":42},[46,47,50,54,58,61],"span",{"class":48,"line":49},"line",1,[46,51,53],{"class":52},"s8jYJ","async",[46,55,57],{"class":56},"sxrX7"," () ",[46,59,60],{"class":52},"=>",[46,62,63],{"class":56}," {\n",[46,65,67,70],{"class":48,"line":66},2,[46,68,69],{"class":52},"  return",[46,71,72],{"class":56}," process.env\n",[46,74,76],{"class":48,"line":75},3,[46,77,78],{"class":56},"}\n",[10,80,81,82,84],{},"Lorsque le code généré s'exécute dans le processus hôte, il peut accéder à toutes les variables globales et capacités exposées par celui-ci. Selon l'environnement, cela peut inclure les variables d'environnement, le système de fichiers, les API du processus ou un accès réseau sans restriction. Le constructeur ",[14,83,16],{}," est un évaluateur. Il n'a jamais été conçu pour exécuter du code non fiable.",[10,86,87,88],{},"Nous avons donc besoin d'un bac à sable. ",[89,90,91],"em",{},"Ne faites jamais confiance à l'utilisateur ni au code généré.",[22,93,95],{"id":94},"les-bacs-à-sable-sont-lents-et-coûteux","Les bacs à sable sont lents et coûteux",[10,97,98],{},"Un bac à sable est un environnement isolé dans lequel du code non fiable ne peut pas affecter le reste du système. Dans notre cas, c'est la bonne manière d'exécuter le code généré.",[10,100,101],{},"Les bacs à sable traditionnels utilisent souvent des machines virtuelles ou des conteneurs. Leur temps de démarrage, leur consommation de mémoire et leur prix varient selon le fournisseur et la configuration, mais un système d'exploitation complet dépasse largement les besoins de notre tâche.",[10,103,104],{},"Un autre problème se pose. De nombreux Agents ont besoin d'environnements pour exécuter du code. Si chaque outil éphémère démarre un système d'exploitation complet, les besoins en capacité et les coûts augmentent vite.",[10,106,107],{},"Il nous faut une solution plus légère, plus rapide et capable de monter en charge. Nous exécutons de petites fonctions JavaScript. Un environnement JavaScript limité suffit.",[22,109,111],{"id":110},"isoler-la-mémoire","Isoler la mémoire",[10,113,114],{},"Prenons un peu de recul. Existe-t-il déjà une solution qui exécute du code non fiable dans un environnement isolé ?",[10,116,117],{},"Les navigateurs !",[10,119,120],{},"Les navigateurs exécutent couramment sur une même machine du code provenant de nombreux sites. Pour séparer ce code, V8 utilise des isolats, c'est-à-dire des tas JavaScript indépendants qui peuvent partager un processus sans partager leur mémoire.",[10,122,123],{},"Un isolat est bien plus léger qu'une machine virtuelle ou un conteneur. Chaque exécution dispose de son propre espace mémoire. Le code d'un isolat ne peut donc pas inspecter ni modifier directement les objets d'une autre exécution.",[10,125,126],{},"L'isolation de la mémoire ne suffit cependant pas. Le code non fiable doit recevoir uniquement les capacités dont il a besoin : aucun accès au système de fichiers, aucun secret arbitraire et aucun accès réseau illimité.",[10,128,129,130,137],{},"Les Workers Cloudflare conviennent particulièrement bien à ce besoin. ",[131,132,136],"a",{"href":133,"rel":134},"https:\u002F\u002Fblog.cloudflare.com\u002Fintroducing-cloudflare-workers\u002F#:~:text=We%20run%20JavaScript,top%20of%20this.",[135],"nofollow","Ils reposent sur les isolats V8"," et sur un environnement fondé sur les capacités. Un Worker ne reçoit que les liaisons et les accès sortants que nous lui accordons explicitement.",[10,139,140,141,144],{},"Node.js utilise lui aussi V8, mais Node n'est pas un bac à sable sécurisé. La documentation du module ",[14,142,143],{},"node:vm"," précise explicitement qu'il ne faut pas l'utiliser pour exécuter du code non fiable. Notre cas nécessite un environnement conçu pour faire respecter ces limites.",[22,146,148],{"id":147},"les-workers-dynamiques-à-la-rescousse","Les Workers dynamiques à la rescousse",[10,150,151],{},"Les Workers Cloudflare fournissent ce type d'environnement isolé. Avec les Workers dynamiques, nous n'avons pas besoin de déployer un nouveau Worker par l'intermédiaire d'un endpoint HTTP pour chaque exécution.",[10,153,154],{},"Le Worker parent utilise plutôt la liaison Dynamic Worker Loader pour créer un nouveau Worker à l'exécution, attendre sa réponse RPC, puis la renvoyer au client MCP. Cloudflare indique qu'un nouvel isolat démarre en quelques millisecondes et utilise quelques mégaoctets de mémoire, ce qui convient aux exécutions courtes.",[22,156,158],{"id":157},"passer-de-lévaluation-locale-aux-workers-dynamiques","Passer de l'évaluation locale aux Workers dynamiques",[10,160,161],{},"Le concept est posé, implémentons-le maintenant dans notre code.",[10,163,164],{},"Pour le moment, nous avons ceci :",[36,166,168],{"className":38,"code":167,"filename":40,"language":41,"meta":42,"style":42},"\u002F* eslint-disable no-new-func *\u002F\nlet searchFunction: unknown\ntry {\n  searchFunction = new Function(\n    'spec',\n    `\"use strict\"; return (${trimmedCode});`\n  )(searchSpec)\n}\ncatch (error) {\n  throw new Error(`Could not compile search code: ${errorMessage(error)}`)\n}\n",[14,169,170,176,191,198,217,227,239,245,250,259,293],{"__ignoreMap":42},[46,171,172],{"class":48,"line":49},[46,173,175],{"class":174},"sCsY4","\u002F* eslint-disable no-new-func *\u002F\n",[46,177,178,181,184,187],{"class":48,"line":66},[46,179,180],{"class":52},"let",[46,182,183],{"class":56}," searchFunction",[46,185,186],{"class":52},":",[46,188,190],{"class":189},"sBjJW"," unknown\n",[46,192,193,196],{"class":48,"line":75},[46,194,195],{"class":52},"try",[46,197,63],{"class":56},[46,199,201,204,207,210,214],{"class":48,"line":200},4,[46,202,203],{"class":56},"  searchFunction ",[46,205,206],{"class":52},"=",[46,208,209],{"class":52}," new",[46,211,213],{"class":212},"snPdu"," Function",[46,215,216],{"class":56},"(\n",[46,218,220,224],{"class":48,"line":219},5,[46,221,223],{"class":222},"sIIMD","    'spec'",[46,225,226],{"class":56},",\n",[46,228,230,233,236],{"class":48,"line":229},6,[46,231,232],{"class":222},"    `\"use strict\"; return (${",[46,234,235],{"class":56},"trimmedCode",[46,237,238],{"class":222},"});`\n",[46,240,242],{"class":48,"line":241},7,[46,243,244],{"class":56},"  )(searchSpec)\n",[46,246,248],{"class":48,"line":247},8,[46,249,78],{"class":56},[46,251,253,256],{"class":48,"line":252},9,[46,254,255],{"class":52},"catch",[46,257,258],{"class":56}," (error) {\n",[46,260,262,265,267,270,273,276,279,281,284,287,290],{"class":48,"line":261},10,[46,263,264],{"class":52},"  throw",[46,266,209],{"class":52},[46,268,269],{"class":212}," Error",[46,271,272],{"class":56},"(",[46,274,275],{"class":222},"`Could not compile search code: ${",[46,277,278],{"class":212},"errorMessage",[46,280,272],{"class":222},[46,282,283],{"class":56},"error",[46,285,286],{"class":222},")",[46,288,289],{"class":222},"}`",[46,291,292],{"class":56},")\n",[46,294,296],{"class":48,"line":295},11,[46,297,78],{"class":56},[10,299,300],{},"Nous allons le remplacer par un appel à un nouveau Worker créé à la volée.",[302,303,306],"callout",{"color":304,"icon":305},"info","i-ph-info-duotone",[10,307,308,309,314],{},"Cette série suppose que vous connaissez déjà les ",[131,310,313],{"href":311,"rel":312},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fruntime-apis\u002Fbindings\u002F",[135],"liaisons Cloudflare",".",[36,316,318],{"className":38,"code":317,"filename":40,"language":41,"meta":42,"style":42},"async function runSearch(code: string): Promise\u003Cunknown> {\n  const worker = env.LOADER.get(`markethub-search-${crypto.randomUUID()}`, () => ({\n    compatibilityDate: '2026-07-11',\n    globalOutbound: null,\n    mainModule: 'worker.js',\n    modules: {\n      'worker.js': `\nimport { WorkerEntrypoint } from \"cloudflare:workers\";\n\nconst spec = ${JSON.stringify(searchSpec)};\n\nexport default class SearchExecutor extends WorkerEntrypoint {\n  async evaluate() {\n    try {\n      const result = await (${code})();\n      return { result, err: undefined };\n    } catch (error) {\n      return {\n        result: undefined,\n        err: error instanceof Error ? error.message : String(error)\n      };\n    }\n  }\n}\n      `\n    }\n  }))\n\n  const entrypoint = worker.getEntrypoint() as unknown as SearchExecutorEntrypoint\n  const response = await entrypoint.evaluate()\n\n  if (response.err)\n    throw new Error(response.err)\n  return response.result\n}\n",[14,319,320,356,404,414,424,434,439,450,455,461,484,488,494,500,506,517,523,529,535,541,547,553,559,565,570,576,581,587,592,623,645,650,659,672,680],{"__ignoreMap":42},[46,321,322,324,327,330,332,335,337,340,342,344,347,350,353],{"class":48,"line":49},[46,323,53],{"class":52},[46,325,326],{"class":52}," function",[46,328,329],{"class":212}," runSearch",[46,331,272],{"class":56},[46,333,14],{"class":334},"sP4rz",[46,336,186],{"class":52},[46,338,339],{"class":189}," string",[46,341,286],{"class":56},[46,343,186],{"class":52},[46,345,346],{"class":212}," Promise",[46,348,349],{"class":56},"\u003C",[46,351,352],{"class":189},"unknown",[46,354,355],{"class":56},"> {\n",[46,357,358,361,364,367,370,373,375,378,380,383,386,388,391,394,396,399,401],{"class":48,"line":66},[46,359,360],{"class":52},"  const",[46,362,363],{"class":189}," worker",[46,365,366],{"class":52}," =",[46,368,369],{"class":56}," env.",[46,371,372],{"class":189},"LOADER",[46,374,314],{"class":56},[46,376,377],{"class":212},"get",[46,379,272],{"class":56},[46,381,382],{"class":222},"`markethub-search-${",[46,384,385],{"class":56},"crypto",[46,387,314],{"class":222},[46,389,390],{"class":212},"randomUUID",[46,392,393],{"class":222},"()",[46,395,289],{"class":222},[46,397,398],{"class":56},", () ",[46,400,60],{"class":52},[46,402,403],{"class":56}," ({\n",[46,405,406,409,412],{"class":48,"line":75},[46,407,408],{"class":56},"    compatibilityDate: ",[46,410,411],{"class":222},"'2026-07-11'",[46,413,226],{"class":56},[46,415,416,419,422],{"class":48,"line":200},[46,417,418],{"class":56},"    globalOutbound: ",[46,420,421],{"class":189},"null",[46,423,226],{"class":56},[46,425,426,429,432],{"class":48,"line":219},[46,427,428],{"class":56},"    mainModule: ",[46,430,431],{"class":222},"'worker.js'",[46,433,226],{"class":56},[46,435,436],{"class":48,"line":229},[46,437,438],{"class":56},"    modules: {\n",[46,440,441,444,447],{"class":48,"line":241},[46,442,443],{"class":222},"      'worker.js'",[46,445,446],{"class":56},": ",[46,448,449],{"class":222},"`\n",[46,451,452],{"class":48,"line":247},[46,453,454],{"class":222},"import { WorkerEntrypoint } from \"cloudflare:workers\";\n",[46,456,457],{"class":48,"line":252},[46,458,460],{"emptyLinePlaceholder":459},true,"\n",[46,462,463,466,469,471,474,476,479,481],{"class":48,"line":261},[46,464,465],{"class":222},"const spec = ${",[46,467,468],{"class":189},"JSON",[46,470,314],{"class":222},[46,472,473],{"class":212},"stringify",[46,475,272],{"class":222},[46,477,478],{"class":56},"searchSpec",[46,480,286],{"class":222},[46,482,483],{"class":222},"};\n",[46,485,486],{"class":48,"line":295},[46,487,460],{"emptyLinePlaceholder":459},[46,489,491],{"class":48,"line":490},12,[46,492,493],{"class":222},"export default class SearchExecutor extends WorkerEntrypoint {\n",[46,495,497],{"class":48,"line":496},13,[46,498,499],{"class":222},"  async evaluate() {\n",[46,501,503],{"class":48,"line":502},14,[46,504,505],{"class":222},"    try {\n",[46,507,509,512,514],{"class":48,"line":508},15,[46,510,511],{"class":222},"      const result = await (${",[46,513,14],{"class":56},[46,515,516],{"class":222},"})();\n",[46,518,520],{"class":48,"line":519},16,[46,521,522],{"class":222},"      return { result, err: undefined };\n",[46,524,526],{"class":48,"line":525},17,[46,527,528],{"class":222},"    } catch (error) {\n",[46,530,532],{"class":48,"line":531},18,[46,533,534],{"class":222},"      return {\n",[46,536,538],{"class":48,"line":537},19,[46,539,540],{"class":222},"        result: undefined,\n",[46,542,544],{"class":48,"line":543},20,[46,545,546],{"class":222},"        err: error instanceof Error ? error.message : String(error)\n",[46,548,550],{"class":48,"line":549},21,[46,551,552],{"class":222},"      };\n",[46,554,556],{"class":48,"line":555},22,[46,557,558],{"class":222},"    }\n",[46,560,562],{"class":48,"line":561},23,[46,563,564],{"class":222},"  }\n",[46,566,568],{"class":48,"line":567},24,[46,569,78],{"class":222},[46,571,573],{"class":48,"line":572},25,[46,574,575],{"class":222},"      `\n",[46,577,579],{"class":48,"line":578},26,[46,580,558],{"class":56},[46,582,584],{"class":48,"line":583},27,[46,585,586],{"class":56},"  }))\n",[46,588,590],{"class":48,"line":589},28,[46,591,460],{"emptyLinePlaceholder":459},[46,593,595,597,600,602,605,608,611,614,617,620],{"class":48,"line":594},29,[46,596,360],{"class":52},[46,598,599],{"class":189}," entrypoint",[46,601,366],{"class":52},[46,603,604],{"class":56}," worker.",[46,606,607],{"class":212},"getEntrypoint",[46,609,610],{"class":56},"() ",[46,612,613],{"class":52},"as",[46,615,616],{"class":189}," unknown",[46,618,619],{"class":52}," as",[46,621,622],{"class":212}," SearchExecutorEntrypoint\n",[46,624,626,628,631,633,636,639,642],{"class":48,"line":625},30,[46,627,360],{"class":52},[46,629,630],{"class":189}," response",[46,632,366],{"class":52},[46,634,635],{"class":52}," await",[46,637,638],{"class":56}," entrypoint.",[46,640,641],{"class":212},"evaluate",[46,643,644],{"class":56},"()\n",[46,646,648],{"class":48,"line":647},31,[46,649,460],{"emptyLinePlaceholder":459},[46,651,653,656],{"class":48,"line":652},32,[46,654,655],{"class":52},"  if",[46,657,658],{"class":56}," (response.err)\n",[46,660,662,665,667,669],{"class":48,"line":661},33,[46,663,664],{"class":52},"    throw",[46,666,209],{"class":52},[46,668,269],{"class":212},[46,670,671],{"class":56},"(response.err)\n",[46,673,675,677],{"class":48,"line":674},34,[46,676,69],{"class":52},[46,678,679],{"class":56}," response.result\n",[46,681,683],{"class":48,"line":682},35,[46,684,78],{"class":56},[10,686,687],{},"Cela peut sembler compliqué, mais ça ne l'est pas tant que cela.",[689,690,691,698,712,733],"ul",{},[692,693,694,697],"li",{},[14,695,696],{},"env.LOADER.get"," est une liaison Cloudflare qui permet de créer un Worker à la volée. Nous lui donnons un nom unique à chaque appel d'outil pour garantir l'isolation de chaque exécution.",[692,699,700,703,704,707,708,711],{},[14,701,702],{},"globalOutbound: null"," désactive tous les appels sortants à ",[14,705,706],{},"fetch()"," et ",[14,709,710],{},"connect()"," depuis le Worker dynamique. L'exécuteur de recherche peut donc inspecter la spécification embarquée, mais ne peut pas accéder au réseau.",[692,713,714,717,718,721,722,725,726,729,730,314],{},[14,715,716],{},"mainModule"," désigne le point d'entrée de notre Worker. C'est comme demander à Vite de lire ",[14,719,720],{},"index.ts"," ou ",[14,723,724],{},"main.ts"," depuis le fichier HTML. Ici, nous lui demandons de lire le fichier ",[14,727,728],{},"worker.js"," défini dans la propriété ",[14,731,732],{},"modules",[692,734,735,737,738,740],{},[14,736,732],{}," associe les noms des modules à leur contenu, comme un système de fichiers virtuel. Il s'agit ici de modules ECMAScript. Nous définissons un seul module, ",[14,739,728],{},", qui contient le code chargé d'exécuter celui de l'IA.",[10,742,743,744,749,750,753],{},"Cloudflare utilise RPC entre notre Worker et celui qui vient d'être créé, par l'intermédiaire de ",[131,745,748],{"href":746,"rel":747},"https:\u002F\u002Fcapnproto.org\u002F",[135],"Cap'n Proto",". Nous pouvons donc appeler ",[14,751,752],{},"entrypoint.evaluate()"," comme s'il s'agissait d'une fonction locale. Cloudflare sérialise la requête, l'envoie au nouveau Worker, l'exécute et renvoie le résultat.",[22,755,757],{"id":756},"donner-à-lexécution-une-passerelle-avec-liste-dautorisations","Donner à l'exécution une passerelle avec liste d'autorisations",[10,759,760],{},"La recherche n'a besoin d'aucun accès sortant, mais l'exécution doit appeler l'API MarketHub locale. L'implémentation de l'exécution ne modifie que cette frontière de capacité :",[36,762,764],{"className":38,"code":763,"filename":40,"language":41,"meta":42,"style":42},"const worker = env.LOADER.get(`markethub-execute-${crypto.randomUUID()}`, () => ({\n  compatibilityDate: '2026-07-11',\n  globalOutbound: exports.GlobalOutbound({}),\n  mainModule: 'worker.js',\n  modules: {\n    'worker.js': executeWorkerSource(code),\n  },\n}))\n",[14,765,766,804,813,829,838,843,856,861],{"__ignoreMap":42},[46,767,768,771,773,775,777,779,781,783,785,788,790,792,794,796,798,800,802],{"class":48,"line":49},[46,769,770],{"class":52},"const",[46,772,363],{"class":189},[46,774,366],{"class":52},[46,776,369],{"class":56},[46,778,372],{"class":189},[46,780,314],{"class":56},[46,782,377],{"class":212},[46,784,272],{"class":56},[46,786,787],{"class":222},"`markethub-execute-${",[46,789,385],{"class":56},[46,791,314],{"class":222},[46,793,390],{"class":212},[46,795,393],{"class":222},[46,797,289],{"class":222},[46,799,398],{"class":56},[46,801,60],{"class":52},[46,803,403],{"class":56},[46,805,806,809,811],{"class":48,"line":66},[46,807,808],{"class":56},"  compatibilityDate: ",[46,810,411],{"class":222},[46,812,226],{"class":56},[46,814,815,818,821,823,826],{"class":48,"line":75},[46,816,817],{"class":56},"  globalOutbound: ",[46,819,820],{"class":189},"exports",[46,822,314],{"class":56},[46,824,825],{"class":212},"GlobalOutbound",[46,827,828],{"class":56},"({}),\n",[46,830,831,834,836],{"class":48,"line":200},[46,832,833],{"class":56},"  mainModule: ",[46,835,431],{"class":222},[46,837,226],{"class":56},[46,839,840],{"class":48,"line":219},[46,841,842],{"class":56},"  modules: {\n",[46,844,845,848,850,853],{"class":48,"line":229},[46,846,847],{"class":222},"    'worker.js'",[46,849,446],{"class":56},[46,851,852],{"class":212},"executeWorkerSource",[46,854,855],{"class":56},"(code),\n",[46,857,858],{"class":48,"line":241},[46,859,860],{"class":56},"  },\n",[46,862,863],{"class":48,"line":247},[46,864,865],{"class":56},"}))\n",[10,867,868,869,871,872,876,877,880,881,707,883,885],{},"La valeur ",[14,870,421],{}," signifie ",[873,874,875],"strong",{},"refuser tout accès sortant",". La valeur ",[14,878,879],{},"exports.GlobalOutbound({})"," achemine à la place chaque appel ",[14,882,706],{},[14,884,710],{}," du Worker dynamique vers la passerelle du Worker parent. Le bac à sable ne dispose toujours d'aucun accès réseau direct. Il reçoit uniquement le comportement autorisé par la passerelle.",[36,887,889],{"className":38,"code":888,"filename":40,"language":41,"meta":42,"style":42},"export class GlobalOutbound extends WorkerEntrypoint\u003CEnv> {\n  async fetch(request: Request): Promise\u003CResponse> {\n    const allowedOrigin = new URL(this.env.MARKETHUB_API_BASE).origin\n    const requestedOrigin = new URL(request.url).origin\n\n    if (requestedOrigin !== allowedOrigin) {\n      return new Response('Forbidden: outbound destination is not allowed', {\n        status: 403\n      })\n    }\n\n    return fetch(request)\n  }\n}\n",[14,890,891,915,946,975,991,995,1009,1027,1035,1040,1044,1048,1058,1062],{"__ignoreMap":42},[46,892,893,896,899,902,905,908,910,913],{"class":48,"line":49},[46,894,895],{"class":52},"export",[46,897,898],{"class":52}," class",[46,900,901],{"class":212}," GlobalOutbound",[46,903,904],{"class":52}," extends",[46,906,907],{"class":212}," WorkerEntrypoint",[46,909,349],{"class":56},[46,911,912],{"class":212},"Env",[46,914,355],{"class":56},[46,916,917,920,923,925,928,930,933,935,937,939,941,944],{"class":48,"line":66},[46,918,919],{"class":52},"  async",[46,921,922],{"class":212}," fetch",[46,924,272],{"class":56},[46,926,927],{"class":334},"request",[46,929,186],{"class":52},[46,931,932],{"class":212}," Request",[46,934,286],{"class":56},[46,936,186],{"class":52},[46,938,346],{"class":212},[46,940,349],{"class":56},[46,942,943],{"class":212},"Response",[46,945,355],{"class":56},[46,947,948,951,954,956,958,961,963,966,969,972],{"class":48,"line":75},[46,949,950],{"class":52},"    const",[46,952,953],{"class":189}," allowedOrigin",[46,955,366],{"class":52},[46,957,209],{"class":52},[46,959,960],{"class":212}," URL",[46,962,272],{"class":56},[46,964,965],{"class":189},"this",[46,967,968],{"class":56},".env.",[46,970,971],{"class":189},"MARKETHUB_API_BASE",[46,973,974],{"class":56},").origin\n",[46,976,977,979,982,984,986,988],{"class":48,"line":200},[46,978,950],{"class":52},[46,980,981],{"class":189}," requestedOrigin",[46,983,366],{"class":52},[46,985,209],{"class":52},[46,987,960],{"class":212},[46,989,990],{"class":56},"(request.url).origin\n",[46,992,993],{"class":48,"line":219},[46,994,460],{"emptyLinePlaceholder":459},[46,996,997,1000,1003,1006],{"class":48,"line":229},[46,998,999],{"class":52},"    if",[46,1001,1002],{"class":56}," (requestedOrigin ",[46,1004,1005],{"class":52},"!==",[46,1007,1008],{"class":56}," allowedOrigin) {\n",[46,1010,1011,1014,1016,1019,1021,1024],{"class":48,"line":241},[46,1012,1013],{"class":52},"      return",[46,1015,209],{"class":52},[46,1017,1018],{"class":212}," Response",[46,1020,272],{"class":56},[46,1022,1023],{"class":222},"'Forbidden: outbound destination is not allowed'",[46,1025,1026],{"class":56},", {\n",[46,1028,1029,1032],{"class":48,"line":247},[46,1030,1031],{"class":56},"        status: ",[46,1033,1034],{"class":189},"403\n",[46,1036,1037],{"class":48,"line":252},[46,1038,1039],{"class":56},"      })\n",[46,1041,1042],{"class":48,"line":261},[46,1043,558],{"class":56},[46,1045,1046],{"class":48,"line":295},[46,1047,460],{"emptyLinePlaceholder":459},[46,1049,1050,1053,1055],{"class":48,"line":490},[46,1051,1052],{"class":52},"    return",[46,1054,922],{"class":212},[46,1056,1057],{"class":56},"(request)\n",[46,1059,1060],{"class":48,"line":496},[46,1061,564],{"class":56},[46,1063,1064],{"class":48,"line":502},[46,1065,78],{"class":56},[10,1067,1068],{},"L'environnement de test n'utilise aucune authentification. Sa passerelle autorise donc uniquement l'origine MarketHub. En production, cette même passerelle peut ajouter un identifiant conservé par le Worker parent avant de transmettre la requête. Le code généré ne voit jamais cet identifiant. C'est la propriété essentielle de cette approche.",[22,1070,1072],{"id":1071},"borner-chaque-exécution","Borner chaque exécution",[10,1074,1075],{},"L'isolation contrôle les ressources auxquelles le code généré peut accéder. Les limites contrôlent la quantité de travail qu'il peut effectuer.",[10,1077,1078],{},"L'implémentation associée rejette déjà les programmes générés de plus de 20 000 caractères et tronque les résultats formatés après 12 000 caractères. Ces bornes empêchent une réponse ou un résultat du modèle de consommer indéfiniment le contexte de l'Agent.",[10,1080,1081],{},"Les Workers dynamiques peuvent également imposer des limites de CPU et de sous-requêtes pour chaque appel. Une configuration de production pourrait commencer avec le budget prudent suivant, puis l'ajuster selon les charges observées :",[36,1083,1085],{"className":38,"code":1084,"filename":40,"language":41,"meta":42,"style":42},"const worker = env.LOADER.get(workerId, () => ({\n  compatibilityDate: '2026-07-11',\n  limits: {\n    cpuMs: 50,\n    subRequests: 10,\n  },\n  globalOutbound: exports.GlobalOutbound({}),\n  mainModule: 'worker.js',\n  modules: { 'worker.js': executeWorkerSource(code) },\n}))\n",[14,1086,1087,1110,1118,1123,1133,1143,1147,1159,1167,1181],{"__ignoreMap":42},[46,1088,1089,1091,1093,1095,1097,1099,1101,1103,1106,1108],{"class":48,"line":49},[46,1090,770],{"class":52},[46,1092,363],{"class":189},[46,1094,366],{"class":52},[46,1096,369],{"class":56},[46,1098,372],{"class":189},[46,1100,314],{"class":56},[46,1102,377],{"class":212},[46,1104,1105],{"class":56},"(workerId, () ",[46,1107,60],{"class":52},[46,1109,403],{"class":56},[46,1111,1112,1114,1116],{"class":48,"line":66},[46,1113,808],{"class":56},[46,1115,411],{"class":222},[46,1117,226],{"class":56},[46,1119,1120],{"class":48,"line":75},[46,1121,1122],{"class":56},"  limits: {\n",[46,1124,1125,1128,1131],{"class":48,"line":200},[46,1126,1127],{"class":56},"    cpuMs: ",[46,1129,1130],{"class":189},"50",[46,1132,226],{"class":56},[46,1134,1135,1138,1141],{"class":48,"line":219},[46,1136,1137],{"class":56},"    subRequests: ",[46,1139,1140],{"class":189},"10",[46,1142,226],{"class":56},[46,1144,1145],{"class":48,"line":229},[46,1146,860],{"class":56},[46,1148,1149,1151,1153,1155,1157],{"class":48,"line":241},[46,1150,817],{"class":56},[46,1152,820],{"class":189},[46,1154,314],{"class":56},[46,1156,825],{"class":212},[46,1158,828],{"class":56},[46,1160,1161,1163,1165],{"class":48,"line":247},[46,1162,833],{"class":56},[46,1164,431],{"class":222},[46,1166,226],{"class":56},[46,1168,1169,1172,1174,1176,1178],{"class":48,"line":252},[46,1170,1171],{"class":56},"  modules: { ",[46,1173,431],{"class":222},[46,1175,446],{"class":56},[46,1177,852],{"class":212},[46,1179,1180],{"class":56},"(code) },\n",[46,1182,1183],{"class":48,"line":261},[46,1184,865],{"class":56},[10,1186,1187],{},"Si le Worker dynamique dépasse l'une de ces limites, il lève une exception. Les bonnes valeurs dépendent du travail attendu. La recherche demande peu de CPU et aucune sous-requête, tandis que l'exécution doit disposer d'assez de sous-requêtes pour les appels API prévus.",[22,1189,1191],{"id":1190},"vous-êtes-prêt","Vous êtes prêt",[10,1193,1194],{},"Vous disposez maintenant d'un serveur MCP qui utilise le Code Mode tout en conservant le code généré dans un environnement neuf et isolé. La recherche ne possède aucun accès sortant. L'exécution dispose uniquement d'une passerelle avec une liste d'autorisations. Enfin, les budgets d'entrée, de sortie, de CPU et de sous-requêtes empêchent une exécution de consommer des ressources sans limite.",[10,1196,1197,1198,1202],{},"J'espère que cette série vous a plu et qu'elle vous a appris quelque chose. Le dépôt associé, ",[1199,1200],"git-hub-link",{"repo":1201},"barbapapazes\u002Fcode-mode",", contient tout le code abordé. Chaque article possède sa propre branche.",[10,1204,1205],{},"Si vous avez des questions, vous pouvez me contacter sur Twitter ou LinkedIn.",[1207,1208,1209],"style",{},"html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":42,"searchDepth":66,"depth":66,"links":1211},[1212,1213,1214,1215,1216,1217,1218,1219],{"id":24,"depth":66,"text":25},{"id":94,"depth":66,"text":95},{"id":110,"depth":66,"text":111},{"id":147,"depth":66,"text":148},{"id":157,"depth":66,"text":158},{"id":756,"depth":66,"text":757},{"id":1071,"depth":66,"text":1072},{"id":1190,"depth":66,"text":1191},"334230f9-e74b-4174-b2f1-05bf1ec0d1fd","2026-07-12","Remplacez l'évaluateur local basé sur Function par des Workers Cloudflare isolés, avec des sorties bornées et un accès réseau contrôlé.","md",{"branch":1225},"part-5-dynamic-workers",null,{},"\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Freplacing-local-eval-with-isolated-cloudflare-workers","---\ncontentId: 334230f9-e74b-4174-b2f1-05bf1ec0d1fd\npart: 5\ntitle: Remplacer l'évaluateur par des Workers Cloudflare isolés\ndescription: Remplacez l'évaluateur local basé sur Function par des Workers Cloudflare isolés, avec des sorties bornées et un accès réseau contrôlé.\ngithub:\n  branch: part-5-dynamic-workers\ndate: 2026-07-12\nseriesSlug: building-code-mode-for-apis-with-mcp-and-isolated-workers\n---\n\nDans les parties précédentes, nous avons implémenté des outils de recherche et d'exécution qui utilisaient un évaluateur local de confiance basé sur le constructeur `Function` pour exécuter le code généré par l'IA. Cette approche fonctionnait pour le développement, mais soulevait de sérieux problèmes de sécurité.\n\nDans cette partie, nous remplacerons cet évaluateur local par un environnement isolé fondé sur les Workers Cloudflare dynamiques. L'isolation et les capacités explicites nous permettront de limiter les actions du code généré au lieu de lui accorder les permissions de l'hôte.\n\n## Les entrées utilisateur ne sont pas fiables\n\nL'une des premières choses que nous apprenons en créant des sites avec des formulaires est que les entrées utilisateur ne sont pas fiables. Le danger ne vient pas seulement des personnes malveillantes, mais aussi des erreurs et des valeurs inattendues.\n\nLe code généré est lui aussi une entrée utilisateur. Un modèle peut se tromper, et une personne malveillante peut essayer de l'orienter vers une action dangereuse.\n\nImaginez qu'au lieu d'écrire une fonction pour rechercher dans la spécification OpenAPI, le modèle produise le code suivant :\n\n```typescript [Exemple]\nasync () => {\n  return process.env\n}\n```\n\nLorsque le code généré s'exécute dans le processus hôte, il peut accéder à toutes les variables globales et capacités exposées par celui-ci. Selon l'environnement, cela peut inclure les variables d'environnement, le système de fichiers, les API du processus ou un accès réseau sans restriction. Le constructeur `Function` est un évaluateur. Il n'a jamais été conçu pour exécuter du code non fiable.\n\nNous avons donc besoin d'un bac à sable. _Ne faites jamais confiance à l'utilisateur ni au code généré._\n\n## Les bacs à sable sont lents et coûteux\n\nUn bac à sable est un environnement isolé dans lequel du code non fiable ne peut pas affecter le reste du système. Dans notre cas, c'est la bonne manière d'exécuter le code généré.\n\nLes bacs à sable traditionnels utilisent souvent des machines virtuelles ou des conteneurs. Leur temps de démarrage, leur consommation de mémoire et leur prix varient selon le fournisseur et la configuration, mais un système d'exploitation complet dépasse largement les besoins de notre tâche.\n\nUn autre problème se pose. De nombreux Agents ont besoin d'environnements pour exécuter du code. Si chaque outil éphémère démarre un système d'exploitation complet, les besoins en capacité et les coûts augmentent vite.\n\nIl nous faut une solution plus légère, plus rapide et capable de monter en charge. Nous exécutons de petites fonctions JavaScript. Un environnement JavaScript limité suffit.\n\n## Isoler la mémoire\n\nPrenons un peu de recul. Existe-t-il déjà une solution qui exécute du code non fiable dans un environnement isolé ?\n\nLes navigateurs !\n\nLes navigateurs exécutent couramment sur une même machine du code provenant de nombreux sites. Pour séparer ce code, V8 utilise des isolats, c'est-à-dire des tas JavaScript indépendants qui peuvent partager un processus sans partager leur mémoire.\n\nUn isolat est bien plus léger qu'une machine virtuelle ou un conteneur. Chaque exécution dispose de son propre espace mémoire. Le code d'un isolat ne peut donc pas inspecter ni modifier directement les objets d'une autre exécution.\n\nL'isolation de la mémoire ne suffit cependant pas. Le code non fiable doit recevoir uniquement les capacités dont il a besoin : aucun accès au système de fichiers, aucun secret arbitraire et aucun accès réseau illimité.\n\nLes Workers Cloudflare conviennent particulièrement bien à ce besoin. [Ils reposent sur les isolats V8](https:\u002F\u002Fblog.cloudflare.com\u002Fintroducing-cloudflare-workers\u002F#:~:text=We%20run%20JavaScript,top%20of%20this.) et sur un environnement fondé sur les capacités. Un Worker ne reçoit que les liaisons et les accès sortants que nous lui accordons explicitement.\n\nNode.js utilise lui aussi V8, mais Node n'est pas un bac à sable sécurisé. La documentation du module `node:vm` précise explicitement qu'il ne faut pas l'utiliser pour exécuter du code non fiable. Notre cas nécessite un environnement conçu pour faire respecter ces limites.\n\n## Les Workers dynamiques à la rescousse\n\nLes Workers Cloudflare fournissent ce type d'environnement isolé. Avec les Workers dynamiques, nous n'avons pas besoin de déployer un nouveau Worker par l'intermédiaire d'un endpoint HTTP pour chaque exécution.\n\nLe Worker parent utilise plutôt la liaison Dynamic Worker Loader pour créer un nouveau Worker à l'exécution, attendre sa réponse RPC, puis la renvoyer au client MCP. Cloudflare indique qu'un nouvel isolat démarre en quelques millisecondes et utilise quelques mégaoctets de mémoire, ce qui convient aux exécutions courtes.\n\n## Passer de l'évaluation locale aux Workers dynamiques\n\nLe concept est posé, implémentons-le maintenant dans notre code.\n\nPour le moment, nous avons ceci :\n\n```typescript [Exemple]\n\u002F* eslint-disable no-new-func *\u002F\nlet searchFunction: unknown\ntry {\n  searchFunction = new Function(\n    'spec',\n    `\"use strict\"; return (${trimmedCode});`\n  )(searchSpec)\n}\ncatch (error) {\n  throw new Error(`Could not compile search code: ${errorMessage(error)}`)\n}\n```\n\nNous allons le remplacer par un appel à un nouveau Worker créé à la volée.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nCette série suppose que vous connaissez déjà les [liaisons Cloudflare](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fworkers\u002Fruntime-apis\u002Fbindings\u002F).\n::\n\n```typescript [Exemple]\nasync function runSearch(code: string): Promise\u003Cunknown> {\n  const worker = env.LOADER.get(`markethub-search-${crypto.randomUUID()}`, () => ({\n    compatibilityDate: '2026-07-11',\n    globalOutbound: null,\n    mainModule: 'worker.js',\n    modules: {\n      'worker.js': `\nimport { WorkerEntrypoint } from \"cloudflare:workers\";\n\nconst spec = ${JSON.stringify(searchSpec)};\n\nexport default class SearchExecutor extends WorkerEntrypoint {\n  async evaluate() {\n    try {\n      const result = await (${code})();\n      return { result, err: undefined };\n    } catch (error) {\n      return {\n        result: undefined,\n        err: error instanceof Error ? error.message : String(error)\n      };\n    }\n  }\n}\n      `\n    }\n  }))\n\n  const entrypoint = worker.getEntrypoint() as unknown as SearchExecutorEntrypoint\n  const response = await entrypoint.evaluate()\n\n  if (response.err)\n    throw new Error(response.err)\n  return response.result\n}\n```\n\nCela peut sembler compliqué, mais ça ne l'est pas tant que cela.\n\n- `env.LOADER.get` est une liaison Cloudflare qui permet de créer un Worker à la volée. Nous lui donnons un nom unique à chaque appel d'outil pour garantir l'isolation de chaque exécution.\n- `globalOutbound: null` désactive tous les appels sortants à `fetch()` et `connect()` depuis le Worker dynamique. L'exécuteur de recherche peut donc inspecter la spécification embarquée, mais ne peut pas accéder au réseau.\n- `mainModule` désigne le point d'entrée de notre Worker. C'est comme demander à Vite de lire `index.ts` ou `main.ts` depuis le fichier HTML. Ici, nous lui demandons de lire le fichier `worker.js` défini dans la propriété `modules`.\n- `modules` associe les noms des modules à leur contenu, comme un système de fichiers virtuel. Il s'agit ici de modules ECMAScript. Nous définissons un seul module, `worker.js`, qui contient le code chargé d'exécuter celui de l'IA.\n\nCloudflare utilise RPC entre notre Worker et celui qui vient d'être créé, par l'intermédiaire de [Cap'n Proto](https:\u002F\u002Fcapnproto.org\u002F). Nous pouvons donc appeler `entrypoint.evaluate()` comme s'il s'agissait d'une fonction locale. Cloudflare sérialise la requête, l'envoie au nouveau Worker, l'exécute et renvoie le résultat.\n\n## Donner à l'exécution une passerelle avec liste d'autorisations\n\nLa recherche n'a besoin d'aucun accès sortant, mais l'exécution doit appeler l'API MarketHub locale. L'implémentation de l'exécution ne modifie que cette frontière de capacité :\n\n```typescript [Exemple]\nconst worker = env.LOADER.get(`markethub-execute-${crypto.randomUUID()}`, () => ({\n  compatibilityDate: '2026-07-11',\n  globalOutbound: exports.GlobalOutbound({}),\n  mainModule: 'worker.js',\n  modules: {\n    'worker.js': executeWorkerSource(code),\n  },\n}))\n```\n\nLa valeur `null` signifie **refuser tout accès sortant**. La valeur `exports.GlobalOutbound({})` achemine à la place chaque appel `fetch()` et `connect()` du Worker dynamique vers la passerelle du Worker parent. Le bac à sable ne dispose toujours d'aucun accès réseau direct. Il reçoit uniquement le comportement autorisé par la passerelle.\n\n```typescript [Exemple]\nexport class GlobalOutbound extends WorkerEntrypoint\u003CEnv> {\n  async fetch(request: Request): Promise\u003CResponse> {\n    const allowedOrigin = new URL(this.env.MARKETHUB_API_BASE).origin\n    const requestedOrigin = new URL(request.url).origin\n\n    if (requestedOrigin !== allowedOrigin) {\n      return new Response('Forbidden: outbound destination is not allowed', {\n        status: 403\n      })\n    }\n\n    return fetch(request)\n  }\n}\n```\n\nL'environnement de test n'utilise aucune authentification. Sa passerelle autorise donc uniquement l'origine MarketHub. En production, cette même passerelle peut ajouter un identifiant conservé par le Worker parent avant de transmettre la requête. Le code généré ne voit jamais cet identifiant. C'est la propriété essentielle de cette approche.\n\n## Borner chaque exécution\n\nL'isolation contrôle les ressources auxquelles le code généré peut accéder. Les limites contrôlent la quantité de travail qu'il peut effectuer.\n\nL'implémentation associée rejette déjà les programmes générés de plus de 20 000 caractères et tronque les résultats formatés après 12 000 caractères. Ces bornes empêchent une réponse ou un résultat du modèle de consommer indéfiniment le contexte de l'Agent.\n\nLes Workers dynamiques peuvent également imposer des limites de CPU et de sous-requêtes pour chaque appel. Une configuration de production pourrait commencer avec le budget prudent suivant, puis l'ajuster selon les charges observées :\n\n```typescript [Exemple]\nconst worker = env.LOADER.get(workerId, () => ({\n  compatibilityDate: '2026-07-11',\n  limits: {\n    cpuMs: 50,\n    subRequests: 10,\n  },\n  globalOutbound: exports.GlobalOutbound({}),\n  mainModule: 'worker.js',\n  modules: { 'worker.js': executeWorkerSource(code) },\n}))\n```\n\nSi le Worker dynamique dépasse l'une de ces limites, il lève une exception. Les bonnes valeurs dépendent du travail attendu. La recherche demande peu de CPU et aucune sous-requête, tandis que l'exécution doit disposer d'assez de sous-requêtes pour les appels API prévus.\n\n## Vous êtes prêt\n\nVous disposez maintenant d'un serveur MCP qui utilise le Code Mode tout en conservant le code généré dans un environnement neuf et isolé. La recherche ne possède aucun accès sortant. L'exécution dispose uniquement d'une passerelle avec une liste d'autorisations. Enfin, les budgets d'entrée, de sortie, de CPU et de sous-requêtes empêchent une exécution de consommer des ressources sans limite.\n\nJ'espère que cette série vous a plu et qu'elle vous a appris quelque chose. Le dépôt associé, \u003CGitHubLink repo=\"barbapapazes\u002Fcode-mode\" \u002F>, contient tout le code abordé. Chaque article possède sa propre branche.\n\nSi vous avez des questions, vous pouvez me contacter sur Twitter ou LinkedIn.\n",{"title":5,"description":1222},"building-code-mode-for-apis-with-mcp-and-isolated-workers",{"loc":1228},"fr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Freplacing-local-eval-with-isolated-cloudflare-workers","yxGyFOHd-bIxiljxGKYxH9N3F8mWPQvPEA0d5GDx2N4",{"overview":1236,"chapters":1398},{"id":1237,"title":1238,"body":1239,"contentId":1378,"date":1221,"description":1379,"extension":1223,"github":1380,"meetTheInstructor":1382,"meta":1383,"navigation":459,"part":1226,"path":1384,"rawbody":1385,"robots":1226,"schemaOrg":1226,"seo":1386,"seriesSlug":1231,"sitemap":1387,"stem":1388,"subtitle":1389,"topics":1390,"__hash__":1397},"series\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers.md","Construire le Code Mode pour les API avec MCP et Workers",{"type":7,"value":1240,"toc":1375},[1241,1244,1252,1258,1270,1285,1288,1291,1294,1351,1357,1365,1369],[10,1242,1243],{},"Bonjour et bienvenue ! 👋",[10,1245,1246,1247,1251],{},"Cette série prolonge de manière concrète l'article ",[131,1248,1250],{"href":1249},"\u002Ffr\u002Fposts\u002Fcode-mode-two-tools-and-an-mcp-can-save-your-llm-context","Code Mode, deux outils et un MCP peuvent préserver le contexte de votre LLM",". Celui-ci présentait l'idée suivante : au lieu de demander à un modèle d'orchestrer chaque appel d'outil dépendant, laissons-le écrire cette orchestration sous forme de code et renvoyer uniquement le résultat nécessaire à sa prochaine décision.",[10,1253,1254,1255,1257],{},"Ici, nous allons construire cette approche étape par étape. Nous commencerons par une petite transformation de fichier en local, puis nous passerons à une API décrite avec OpenAPI avant de remplacer l'évaluateur local de confiance basé sur le constructeur ",[14,1256,16],{}," par un environnement d'exécution isolé. Nous obtiendrons un serveur MCP exécutable en local, capable de rechercher dans la spécification d'une API et d'exécuter une requête ciblée vers cette API.",[10,1259,1260,1261,1265,1266,314],{},"Les principes fondamentaux de MCP sortent du cadre de cette série. Si vous avez besoin d'une introduction au protocole ou à la relation entre un Agent IA et un serveur MCP, commencez par ",[131,1262,1264],{"href":1263},"\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web","Agents IA et serveur MCP au service du web agentique",", en particulier ",[131,1267,1269],{"href":1268},"\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent","son article sur le serveur MCP",[10,1271,1272,1273,1276,1277,1280,1281,1284],{},"Tout au long de la série, le ",[873,1274,1275],{},"modèle"," génère des appels d'outils ou du code, le ",[873,1278,1279],{},"client MCP"," ou Agent exécute la boucle du modèle et le ",[873,1282,1283],{},"serveur MCP"," fournit les capacités. Il faut bien distinguer ces rôles : l'hôte, et non le code généré, définit les capacités disponibles.",[10,1286,1287],{},"L'idée centrale est simple. Avec des outils MCP directs, le modèle doit appeler un outil, recevoir l'intégralité du résultat intermédiaire, puis utiliser ce résultat pour décider comment appeler l'outil suivant. Avec le Code Mode, le modèle écrit l'orchestration sous forme de code. Ce code accède aux capacités dont il a besoin dans l'environnement d'exécution, et le modèle reçoit uniquement le résultat final souhaité pour poursuivre son travail.",[10,1289,1290],{},"Le Code Mode n'est pas toujours le bon choix. Les outils MCP directs restent plus simples pour les actions courtes et évidentes. L'environnement d'exécution supplémentaire devient utile lorsqu'une tâche comporte des appels dépendants, nécessite un traitement local des données ou doit parcourir une API vaste et évolutive. C'est par exemple le cas d'une spécification OpenAPI qui peut dépasser la fenêtre de contexte du modèle.",[10,1292,1293],{},"Au fil de cette série, nous allons :",[1295,1296,1297,1307,1322,1332,1346],"ol",{},[692,1298,1299,1302,1303,1306],{},[873,1300,1301],{},"Au-delà d'un appel d'outil à la fois : découvrir le Code Mode"," : construire deux outils ",[14,1304,1305],{},"Drive"," directs autour d'un fichier Markdown de test et observer comment l'intégralité de son contenu traverse le contexte du modèle avant l'appel d'outil suivant.",[692,1308,1309,1312,1313,1315,1316,1318,1319,1321],{},[873,1310,1311],{},"Laisser le modèle orchestrer les outils dans un environnement local"," : remplacer les deux outils directs par un outil ",[14,1314,14],{}," générique, exposer une façade ",[14,1317,1305],{}," typée et introduire l'interface de l'exécuteur que les parties suivantes remplaceront. L'évaluateur local basé sur le constructeur ",[14,1320,16],{}," est volontairement un raccourci réservé au développement de confiance, et non un bac à sable de production.",[692,1323,1324,1327,1328,1331],{},[873,1325,1326],{},"Rechercher dans une spécification OpenAPI sans remplir le contexte"," : conserver le document OpenAPI dans le serveur, résoudre ses références ",[14,1329,1330],{},"$ref"," locales et laisser le code généré effectuer ses recherches dans une façade de types compacte au lieu de renvoyer toute la spécification au modèle.",[692,1333,1334,1337,1338,1341,1342,1345],{},[873,1335,1336],{},"Appeler des API avec le Code Mode et ne renvoyer que l'essentiel"," : ajouter un outil ",[14,1339,1340],{},"execute"," distinct avec une fonction ",[14,1343,1344],{},"api.request()"," contrôlée par l'hôte. Nous validerons les options de la requête, appellerons l'API MarketHub locale utilisée pour les tests et renverrons une projection ciblée plutôt que la réponse complète de l'API.",[692,1347,1348,1350],{},[873,1349,5],{}," : remplacer uniquement l'exécuteur par de nouveaux Workers dynamiques. La recherche s'exécutera sans accès sortant, tandis que les appels passeront par une passerelle avec une liste d'autorisations. Les identifiants resteront hors du code généré. Nous aborderons également les limites des résultats, les limites de ressources et les délais imposés par l'hôte.",[10,1352,1353,1354,1356],{},"Le dépôt associé, ",[1199,1355],{"repo":1201},", est un manuel exécutable pour cette série. Chaque article dispose d'une branche qui représente un état complet, d'une petite évaluation et d'un diff ciblé par rapport à l'étape précédente. Je vous recommande d'extraire une branche et d'étudier l'implémentation pour mieux comprendre les concepts, car les articles ne couvriront pas chaque détail.",[302,1358,1359],{"color":304,"icon":305},[10,1360,1361,1362,1364],{},"Cette série suppose que vous connaissez TypeScript, les promesses JavaScript, les API HTTP et les concepts de base de MCP. Les étapes locales ne contiennent aucun identifiant. Les parties 2 à 4 utilisent un évaluateur local de confiance basé sur le constructeur ",[14,1363,16],{}," pour le développement. La partie 5 fournit une base de déploiement Cloudflare et une évaluation structurelle de la sécurité.",[22,1366,1368],{"id":1367},"chapitres","Chapitres",[1370,1371],"series-chapters-list",{"className":1372},[1373,1374],"mx-auto","max-w-5xl",{"title":42,"searchDepth":66,"depth":66,"links":1376},[1377],{"id":1367,"depth":66,"text":1368},"4fc50be1-a524-474e-8426-392581f8b0e8","Construisez un serveur MCP pour une API décrite par OpenAPI, puis remplacez l'évaluateur local par des Workers Cloudflare isolés.",{"name":1381,"repository":1201},"Code Mode","J'ai créé cette série pour transformer l'idée du Code Mode en une implémentation concrète. Nous commencerons avec deux outils MCP ordinaires, puis nous confierons l'orchestration au code généré avant de remplacer un évaluateur local de confiance basé sur le constructeur Function par des Workers Cloudflare dynamiques et isolés.",{},"\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers","---\ncontentId: 4fc50be1-a524-474e-8426-392581f8b0e8\ntitle: Construire le Code Mode pour les API avec MCP et Workers\nsubtitle: Créez un serveur MCP économe en contexte pour les API décrites avec OpenAPI\ndescription: Construisez un serveur MCP pour une API décrite par OpenAPI, puis remplacez l'évaluateur local par des Workers Cloudflare isolés.\ndate: 2026-07-12\ntopics:\n  - ai\n  - ai-agents\n  - mcp\n  - code-mode\n  - openapi\n  - cloudflare\n  - typescript\ngithub:\n  name: Code Mode\n  repository: barbapapazes\u002Fcode-mode\nmeetTheInstructor: J'ai créé cette série pour transformer l'idée du Code Mode en une implémentation concrète. Nous commencerons avec deux outils MCP ordinaires, puis nous confierons l'orchestration au code généré avant de remplacer un évaluateur local de confiance basé sur le constructeur Function par des Workers Cloudflare dynamiques et isolés.\nseriesSlug: building-code-mode-for-apis-with-mcp-and-isolated-workers\n---\n\nBonjour et bienvenue ! 👋\n\nCette série prolonge de manière concrète l'article [Code Mode, deux outils et un MCP peuvent préserver le contexte de votre LLM](\u002Ffr\u002Fposts\u002Fcode-mode-two-tools-and-an-mcp-can-save-your-llm-context). Celui-ci présentait l'idée suivante : au lieu de demander à un modèle d'orchestrer chaque appel d'outil dépendant, laissons-le écrire cette orchestration sous forme de code et renvoyer uniquement le résultat nécessaire à sa prochaine décision.\n\nIci, nous allons construire cette approche étape par étape. Nous commencerons par une petite transformation de fichier en local, puis nous passerons à une API décrite avec OpenAPI avant de remplacer l'évaluateur local de confiance basé sur le constructeur `Function` par un environnement d'exécution isolé. Nous obtiendrons un serveur MCP exécutable en local, capable de rechercher dans la spécification d'une API et d'exécuter une requête ciblée vers cette API.\n\nLes principes fondamentaux de MCP sortent du cadre de cette série. Si vous avez besoin d'une introduction au protocole ou à la relation entre un Agent IA et un serveur MCP, commencez par [Agents IA et serveur MCP au service du web agentique](\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web), en particulier [son article sur le serveur MCP](\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent).\n\nTout au long de la série, le **modèle** génère des appels d'outils ou du code, le **client MCP** ou Agent exécute la boucle du modèle et le **serveur MCP** fournit les capacités. Il faut bien distinguer ces rôles : l'hôte, et non le code généré, définit les capacités disponibles.\n\nL'idée centrale est simple. Avec des outils MCP directs, le modèle doit appeler un outil, recevoir l'intégralité du résultat intermédiaire, puis utiliser ce résultat pour décider comment appeler l'outil suivant. Avec le Code Mode, le modèle écrit l'orchestration sous forme de code. Ce code accède aux capacités dont il a besoin dans l'environnement d'exécution, et le modèle reçoit uniquement le résultat final souhaité pour poursuivre son travail.\n\nLe Code Mode n'est pas toujours le bon choix. Les outils MCP directs restent plus simples pour les actions courtes et évidentes. L'environnement d'exécution supplémentaire devient utile lorsqu'une tâche comporte des appels dépendants, nécessite un traitement local des données ou doit parcourir une API vaste et évolutive. C'est par exemple le cas d'une spécification OpenAPI qui peut dépasser la fenêtre de contexte du modèle.\n\nAu fil de cette série, nous allons :\n\n1. **Au-delà d'un appel d'outil à la fois : découvrir le Code Mode** : construire deux outils `Drive` directs autour d'un fichier Markdown de test et observer comment l'intégralité de son contenu traverse le contexte du modèle avant l'appel d'outil suivant.\n2. **Laisser le modèle orchestrer les outils dans un environnement local** : remplacer les deux outils directs par un outil `code` générique, exposer une façade `Drive` typée et introduire l'interface de l'exécuteur que les parties suivantes remplaceront. L'évaluateur local basé sur le constructeur `Function` est volontairement un raccourci réservé au développement de confiance, et non un bac à sable de production.\n3. **Rechercher dans une spécification OpenAPI sans remplir le contexte** : conserver le document OpenAPI dans le serveur, résoudre ses références `$ref` locales et laisser le code généré effectuer ses recherches dans une façade de types compacte au lieu de renvoyer toute la spécification au modèle.\n4. **Appeler des API avec le Code Mode et ne renvoyer que l'essentiel** : ajouter un outil `execute` distinct avec une fonction `api.request()` contrôlée par l'hôte. Nous validerons les options de la requête, appellerons l'API MarketHub locale utilisée pour les tests et renverrons une projection ciblée plutôt que la réponse complète de l'API.\n5. **Remplacer l'évaluateur par des Workers Cloudflare isolés** : remplacer uniquement l'exécuteur par de nouveaux Workers dynamiques. La recherche s'exécutera sans accès sortant, tandis que les appels passeront par une passerelle avec une liste d'autorisations. Les identifiants resteront hors du code généré. Nous aborderons également les limites des résultats, les limites de ressources et les délais imposés par l'hôte.\n\nLe dépôt associé, \u003CGitHubLink repo=\"barbapapazes\u002Fcode-mode\" \u002F>, est un manuel exécutable pour cette série. Chaque article dispose d'une branche qui représente un état complet, d'une petite évaluation et d'un diff ciblé par rapport à l'étape précédente. Je vous recommande d'extraire une branche et d'étudier l'implémentation pour mieux comprendre les concepts, car les articles ne couvriront pas chaque détail.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nCette série suppose que vous connaissez TypeScript, les promesses JavaScript, les API HTTP et les concepts de base de MCP. Les étapes locales ne contiennent aucun identifiant. Les parties 2 à 4 utilisent un évaluateur local de confiance basé sur le constructeur `Function` pour le développement. La partie 5 fournit une base de déploiement Cloudflare et une évaluation structurelle de la sécurité.\n::\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1238,"description":1379},{"loc":1384},"fr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers","Créez un serveur MCP économe en contexte pour les API décrites avec OpenAPI",[1391,1392,1393,1394,1395,1396,41],"ai","ai-agents","mcp","code-mode","openapi","cloudflare","HqoFmkgNETmMSWXeXg8BeVY4Vjz1w13UtWu2_6vvVaE",[1399,1406,1413,1420,1427],{"contentId":1400,"title":1401,"description":1402,"path":1403,"part":49,"github":1404,"topics":1226},"02726224-2677-4d4b-9390-cf6543caba80","Au-delà d'un appel d'outil : découvrir le Code Mode","Découvrez pourquoi les appels d'outils MCP dépendants remplissent le contexte du modèle et comment le Code Mode déplace leur orchestration dans le code.","\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Fbeyond-one-tool-call-at-a-time-introducing-code-mode",{"branch":1405},"part-1-direct-tools",{"contentId":1407,"title":1408,"description":1409,"path":1410,"part":66,"github":1411,"topics":1226},"2eaa3055-6247-4237-aad6-cde698eedb82","Laisser le modèle orchestrer les outils avec du code local","Créez un environnement Code Mode local minimal et fiable avec une façade Drive typée, ainsi qu'un exécuteur prêt à être isolé.","\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Flet-the-model-orchestrate-tools-with-a-local-code-runtime",{"branch":1412},"part-2-generic-code-mode",{"contentId":1414,"title":1415,"description":1416,"path":1417,"part":75,"github":1418,"topics":1226},"c32e838b-fc65-4cf8-a541-db7017ff7c0e","Chercher dans OpenAPI sans saturer la fenêtre de contexte","Conservez la spécification OpenAPI côté serveur et recherchez dans une façade typée compacte sans renvoyer le document complet.","\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Fsearching-openapi-specification-without-filling-the-context",{"branch":1419},"part-3-search",{"contentId":1421,"title":1422,"description":1423,"path":1424,"part":200,"github":1425,"topics":1226},"5097481f-e94c-409c-865b-78f9bbf83a68","Appeler des API avec le Code Mode et garder l'essentiel","Utilisez une fonction de requête contrôlée par l'hôte pour valider et exécuter un appel API ciblé, puis ne renvoyer que le résultat utile.","\u002Ffr\u002Fseries\u002Fbuilding-code-mode-for-apis-with-mcp-and-isolated-workers\u002Fcalling-apis-with-code-mode-and-returning-only-what-matters",{"branch":1426},"part-4-local-execute",{"contentId":1220,"title":5,"description":1222,"path":1228,"part":219,"github":1428,"topics":1226},{"branch":1225},1795016702475]