[{"data":1,"prerenderedAt":1609},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare":3,"series-context-\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web":1471},{"id":4,"title":5,"body":6,"contentId":1454,"date":1455,"description":1456,"extension":1457,"github":1458,"meetTheInstructor":1460,"meta":1461,"navigation":740,"part":133,"path":1462,"rawbody":1463,"robots":1460,"schemaOrg":1460,"seo":1464,"seriesSlug":1465,"sitemap":1466,"stem":1469,"subtitle":1460,"topics":1460,"__hash__":1470},"series\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare.md","Déployer notre Agent IA dans le monde avec Cloudflare",{"type":7,"value":8,"toc":1449},"minimark",[9,13,33,38,41,74,81,154,165,241,252,270,277,503,513,637,640,655,658,669,673,684,690,1263,1285,1288,1302,1305,1323,1327,1330,1333,1347,1356,1359,1403,1413,1424,1427,1442,1445],[10,11,12],"p",{},"Cette dernière partie est optionnelle : vous pouvez déployer l'application et le serveur MCP où vous le souhaitez. J'ai choisi Cloudflare, car c'est la plateforme que j'utilise quotidiennement pour déployer des projets JavaScript. Nous allons effectuer un petit refactoring pour exécuter le serveur MCP dans un Worker Cloudflare, tout en conservant l'Agent et son interface Nuxt dans une application distincte.",[10,14,15,16,23,24,28,29,32],{},"Cloudflare fournit plusieurs primitives pour ",[17,18,22],"a",{"href":19,"rel":20},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F",[21],"nofollow","les Agents IA et les serveurs MCP",". Notre outil d'addition n'a pas d'état, nous pouvons donc l'héberger dans un Worker classique. Le transport Web Standards du SDK MCP fonctionne directement avec les API ",[25,26,27],"code",{},"Request"," et ",[25,30,31],{},"Response"," du Worker, nous n'avons donc pas besoin d'un Durable Object. Un serveur MCP avec état aurait besoin d'une gestion persistante des sessions.",[34,35,37],"h2",{"id":36},"mettre-en-place-loutillage","Mettre en place l'outillage",[10,39,40],{},"D'abord, installez les dépendances :",[42,43,49],"pre",{"className":44,"code":45,"filename":46,"language":47,"meta":48,"style":48},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm add -D wrangler @types\u002Fnode\n","terminal","bash","",[25,50,51],{"__ignoreMap":48},[52,53,56,60,64,68,71],"span",{"class":54,"line":55},"line",1,[52,57,59],{"class":58},"snPdu","pnpm",[52,61,63],{"class":62},"sIIMD"," add",[52,65,67],{"class":66},"sBjJW"," -D",[52,69,70],{"class":62}," wrangler",[52,72,73],{"class":62}," @types\u002Fnode\n",[10,75,76,77,80],{},"Ensuite, ajoutez les scripts suivants à ",[25,78,79],{},"package.json"," :",[42,82,86],{"className":83,"code":84,"filename":79,"language":85,"meta":48,"style":48},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"scripts\": {\n    \"dev:wrangler\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc dev\",\n    \"deploy:wrangler\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc deploy\",\n    \"cf-typegen\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc types worker\u002Fworker-configuration.d.ts\"\n  }\n}\n","json",[25,87,88,94,103,118,131,142,148],{"__ignoreMap":48},[52,89,90],{"class":54,"line":55},[52,91,93],{"class":92},"sxrX7","{\n",[52,95,97,100],{"class":54,"line":96},2,[52,98,99],{"class":66},"  \"scripts\"",[52,101,102],{"class":92},": {\n",[52,104,106,109,112,115],{"class":54,"line":105},3,[52,107,108],{"class":66},"    \"dev:wrangler\"",[52,110,111],{"class":92},": ",[52,113,114],{"class":62},"\"wrangler --config .\u002Fworker\u002Fwrangler.jsonc dev\"",[52,116,117],{"class":92},",\n",[52,119,121,124,126,129],{"class":54,"line":120},4,[52,122,123],{"class":66},"    \"deploy:wrangler\"",[52,125,111],{"class":92},[52,127,128],{"class":62},"\"wrangler --config .\u002Fworker\u002Fwrangler.jsonc deploy\"",[52,130,117],{"class":92},[52,132,134,137,139],{"class":54,"line":133},5,[52,135,136],{"class":66},"    \"cf-typegen\"",[52,138,111],{"class":92},[52,140,141],{"class":62},"\"wrangler --config .\u002Fworker\u002Fwrangler.jsonc types worker\u002Fworker-configuration.d.ts\"\n",[52,143,145],{"class":54,"line":144},6,[52,146,147],{"class":92},"  }\n",[52,149,151],{"class":54,"line":150},7,[52,152,153],{"class":92},"}\n",[10,155,156,157,160,161,164],{},"Nous avons aussi besoin d'un ",[25,158,159],{},"wrangler.jsonc"," pour configurer notre Worker Cloudflare. Créez ",[25,162,163],{},"worker\u002Fwrangler.jsonc"," avec le contenu suivant :",[42,166,171],{"className":167,"code":168,"filename":169,"language":170,"meta":48,"style":48},"language-jsonc shiki shiki-themes github-light github-light github-dark","{\n  \"$schema\": \"node_modules\u002Fwrangler\u002Fconfig-schema.json\",\n  \"name\": \"our-mcp\",\n  \"main\": \"index.ts\",\n  \"compatibility_date\": \"2025-03-10\",\n  \"compatibility_flags\": [\n    \"nodejs_compat\"\n  ],\n  \"observability\": {\n    \"enabled\": true,\n    \"head_sampling_rate\": 0.1\n  }\n}\n","Exemple","jsonc",[25,172,173,177,182,187,192,197,202,207,213,219,225,231,236],{"__ignoreMap":48},[52,174,175],{"class":54,"line":55},[52,176,93],{},[52,178,179],{"class":54,"line":96},[52,180,181],{},"  \"$schema\": \"node_modules\u002Fwrangler\u002Fconfig-schema.json\",\n",[52,183,184],{"class":54,"line":105},[52,185,186],{},"  \"name\": \"our-mcp\",\n",[52,188,189],{"class":54,"line":120},[52,190,191],{},"  \"main\": \"index.ts\",\n",[52,193,194],{"class":54,"line":133},[52,195,196],{},"  \"compatibility_date\": \"2025-03-10\",\n",[52,198,199],{"class":54,"line":144},[52,200,201],{},"  \"compatibility_flags\": [\n",[52,203,204],{"class":54,"line":150},[52,205,206],{},"    \"nodejs_compat\"\n",[52,208,210],{"class":54,"line":209},8,[52,211,212],{},"  ],\n",[52,214,216],{"class":54,"line":215},9,[52,217,218],{},"  \"observability\": {\n",[52,220,222],{"class":54,"line":221},10,[52,223,224],{},"    \"enabled\": true,\n",[52,226,228],{"class":54,"line":227},11,[52,229,230],{},"    \"head_sampling_rate\": 0.1\n",[52,232,234],{"class":54,"line":233},12,[52,235,147],{},[52,237,239],{"class":54,"line":238},13,[52,240,153],{},[242,243,246],"callout",{"color":244,"icon":245},"info","i-ph-info-duotone",[10,247,248,249,251],{},"Le fichier ",[25,250,159],{}," n'est pas stocké à la racine pour éviter les conflits lorsque nous déploierons l'application Nuxt.",[10,253,254,255,258,259,262,263,266,267,269],{},"Avec ce fichier, Wrangler cherchera ",[25,256,257],{},"index.ts"," dans le répertoire ",[25,260,261],{},"worker",", ce qui correspond à ",[25,264,265],{},"worker\u002Findex.ts",". La configuration se trouve dans le répertoire ",[25,268,261],{}," afin de ne pas entrer en conflit avec le déploiement Cloudflare Pages de l'application Nuxt.",[10,271,272,273,276],{},"Pour terminer la mise en place, créez un fichier ",[25,274,275],{},"tsconfig.worker.json"," pour configurer TypeScript pour le Worker :",[42,278,280],{"className":83,"code":279,"filename":275,"language":85,"meta":48,"style":48},"{\n  \"compilerOptions\": {\n    \"target\": \"es2021\",\n    \"jsx\": \"react-jsx\",\n    \"lib\": [\n      \"es2021\"\n    ],\n    \"module\": \"es2022\",\n    \"moduleResolution\": \"bundler\",\n    \"resolveJsonModule\": true,\n    \"allowJs\": true,\n    \"checkJs\": false,\n    \"strict\": true,\n    \"noEmit\": true,\n    \"allowSyntheticDefaultImports\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"isolatedModules\": true,\n    \"skipLibCheck\": true\n  },\n  \"include\": [\n    \"worker\u002Fworker-configuration.d.ts\",\n    \"worker\u002F**\u002F*.ts\"\n  ]\n}\n",[25,281,282,286,293,305,317,325,330,335,347,359,371,382,394,405,417,429,441,453,464,470,478,486,492,498],{"__ignoreMap":48},[52,283,284],{"class":54,"line":55},[52,285,93],{"class":92},[52,287,288,291],{"class":54,"line":96},[52,289,290],{"class":66},"  \"compilerOptions\"",[52,292,102],{"class":92},[52,294,295,298,300,303],{"class":54,"line":105},[52,296,297],{"class":66},"    \"target\"",[52,299,111],{"class":92},[52,301,302],{"class":62},"\"es2021\"",[52,304,117],{"class":92},[52,306,307,310,312,315],{"class":54,"line":120},[52,308,309],{"class":66},"    \"jsx\"",[52,311,111],{"class":92},[52,313,314],{"class":62},"\"react-jsx\"",[52,316,117],{"class":92},[52,318,319,322],{"class":54,"line":133},[52,320,321],{"class":66},"    \"lib\"",[52,323,324],{"class":92},": [\n",[52,326,327],{"class":54,"line":144},[52,328,329],{"class":62},"      \"es2021\"\n",[52,331,332],{"class":54,"line":150},[52,333,334],{"class":92},"    ],\n",[52,336,337,340,342,345],{"class":54,"line":209},[52,338,339],{"class":66},"    \"module\"",[52,341,111],{"class":92},[52,343,344],{"class":62},"\"es2022\"",[52,346,117],{"class":92},[52,348,349,352,354,357],{"class":54,"line":215},[52,350,351],{"class":66},"    \"moduleResolution\"",[52,353,111],{"class":92},[52,355,356],{"class":62},"\"bundler\"",[52,358,117],{"class":92},[52,360,361,364,366,369],{"class":54,"line":221},[52,362,363],{"class":66},"    \"resolveJsonModule\"",[52,365,111],{"class":92},[52,367,368],{"class":66},"true",[52,370,117],{"class":92},[52,372,373,376,378,380],{"class":54,"line":227},[52,374,375],{"class":66},"    \"allowJs\"",[52,377,111],{"class":92},[52,379,368],{"class":66},[52,381,117],{"class":92},[52,383,384,387,389,392],{"class":54,"line":233},[52,385,386],{"class":66},"    \"checkJs\"",[52,388,111],{"class":92},[52,390,391],{"class":66},"false",[52,393,117],{"class":92},[52,395,396,399,401,403],{"class":54,"line":238},[52,397,398],{"class":66},"    \"strict\"",[52,400,111],{"class":92},[52,402,368],{"class":66},[52,404,117],{"class":92},[52,406,408,411,413,415],{"class":54,"line":407},14,[52,409,410],{"class":66},"    \"noEmit\"",[52,412,111],{"class":92},[52,414,368],{"class":66},[52,416,117],{"class":92},[52,418,420,423,425,427],{"class":54,"line":419},15,[52,421,422],{"class":66},"    \"allowSyntheticDefaultImports\"",[52,424,111],{"class":92},[52,426,368],{"class":66},[52,428,117],{"class":92},[52,430,432,435,437,439],{"class":54,"line":431},16,[52,433,434],{"class":66},"    \"forceConsistentCasingInFileNames\"",[52,436,111],{"class":92},[52,438,368],{"class":66},[52,440,117],{"class":92},[52,442,444,447,449,451],{"class":54,"line":443},17,[52,445,446],{"class":66},"    \"isolatedModules\"",[52,448,111],{"class":92},[52,450,368],{"class":66},[52,452,117],{"class":92},[52,454,456,459,461],{"class":54,"line":455},18,[52,457,458],{"class":66},"    \"skipLibCheck\"",[52,460,111],{"class":92},[52,462,463],{"class":66},"true\n",[52,465,467],{"class":54,"line":466},19,[52,468,469],{"class":92},"  },\n",[52,471,473,476],{"class":54,"line":472},20,[52,474,475],{"class":66},"  \"include\"",[52,477,324],{"class":92},[52,479,481,484],{"class":54,"line":480},21,[52,482,483],{"class":62},"    \"worker\u002Fworker-configuration.d.ts\"",[52,485,117],{"class":92},[52,487,489],{"class":54,"line":488},22,[52,490,491],{"class":62},"    \"worker\u002F**\u002F*.ts\"\n",[52,493,495],{"class":54,"line":494},23,[52,496,497],{"class":92},"  ]\n",[52,499,501],{"class":54,"line":500},24,[52,502,153],{"class":92},[10,504,505,506,509,510,80],{},"Ajoutez ce fichier au ",[25,507,508],{},"tsconfig.json"," existant dans la section ",[25,511,512],{},"references",[42,514,517],{"className":83,"code":515,"filename":508,"highlights":516,"language":85,"meta":48,"style":48},"{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.server.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.shared.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.worker.json\"\n    }\n  ]\n}\n",[443],[25,518,519,523,531,538,543,553,558,562,571,575,579,588,592,596,605,609,613,624,629,633],{"__ignoreMap":48},[52,520,521],{"class":54,"line":55},[52,522,93],{"class":92},[52,524,525,528],{"class":54,"line":96},[52,526,527],{"class":66},"  \"files\"",[52,529,530],{"class":92},": [],\n",[52,532,533,536],{"class":54,"line":105},[52,534,535],{"class":66},"  \"references\"",[52,537,324],{"class":92},[52,539,540],{"class":54,"line":120},[52,541,542],{"class":92},"    {\n",[52,544,545,548,550],{"class":54,"line":133},[52,546,547],{"class":66},"      \"path\"",[52,549,111],{"class":92},[52,551,552],{"class":62},"\".\u002F.nuxt\u002Ftsconfig.app.json\"\n",[52,554,555],{"class":54,"line":144},[52,556,557],{"class":92},"    },\n",[52,559,560],{"class":54,"line":150},[52,561,542],{"class":92},[52,563,564,566,568],{"class":54,"line":209},[52,565,547],{"class":66},[52,567,111],{"class":92},[52,569,570],{"class":62},"\".\u002F.nuxt\u002Ftsconfig.server.json\"\n",[52,572,573],{"class":54,"line":215},[52,574,557],{"class":92},[52,576,577],{"class":54,"line":221},[52,578,542],{"class":92},[52,580,581,583,585],{"class":54,"line":227},[52,582,547],{"class":66},[52,584,111],{"class":92},[52,586,587],{"class":62},"\".\u002F.nuxt\u002Ftsconfig.shared.json\"\n",[52,589,590],{"class":54,"line":233},[52,591,557],{"class":92},[52,593,594],{"class":54,"line":238},[52,595,542],{"class":92},[52,597,598,600,602],{"class":54,"line":407},[52,599,547],{"class":66},[52,601,111],{"class":92},[52,603,604],{"class":62},"\".\u002F.nuxt\u002Ftsconfig.node.json\"\n",[52,606,607],{"class":54,"line":419},[52,608,557],{"class":92},[52,610,611],{"class":54,"line":431},[52,612,542],{"class":92},[52,614,617,619,621],{"class":615,"line":443},[54,616],"highlight",[52,618,547],{"class":66},[52,620,111],{"class":92},[52,622,623],{"class":62},"\".\u002Ftsconfig.worker.json\"\n",[52,625,626],{"class":54,"line":455},[52,627,628],{"class":92},"    }\n",[52,630,631],{"class":54,"line":466},[52,632,497],{"class":92},[52,634,635],{"class":54,"line":472},[52,636,153],{"class":92},[10,638,639],{},"Générez maintenant les types :",[42,641,643],{"className":44,"code":642,"filename":46,"language":47,"meta":48,"style":48},"pnpm run cf-typegen\n",[25,644,645],{"__ignoreMap":48},[52,646,647,649,652],{"class":54,"line":55},[52,648,59],{"class":58},[52,650,651],{"class":62}," run",[52,653,654],{"class":62}," cf-typegen\n",[10,656,657],{},"Cela garantit une bonne autocomplétion dans les fichiers du Worker.",[10,659,660,661,664,665,668],{},"N'oubliez pas d'ajouter le dossier ",[25,662,663],{},".wrangler"," à ",[25,666,667],{},".gitignore"," pour éviter de le commettre par erreur.",[34,670,672],{"id":671},"passage-au-worker","Passage au Worker",[10,674,675,676,679,680,683],{},"Maintenant que l'outillage est prêt, déplaçons le serveur MCP dans un Worker Cloudflare. Un Worker est un objet exporté avec une méthode ",[25,677,678],{},"fetch",". Pour notre outil d'addition sans état, ",[25,681,682],{},"WebStandardStreamableHTTPServerTransport"," fournit directement le transport Streamable HTTP grâce aux API standard du Worker, sans nécessiter de Durable Object.",[10,685,686,687,689],{},"Remplacez l'ancienne route Nitro par ce fichier ",[25,688,265],{}," complet :",[42,691,695],{"className":692,"code":693,"filename":265,"language":694,"meta":48,"style":48},"language-ts shiki shiki-themes github-light github-light github-dark","import { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FwebStandardStreamableHttp.js'\nimport { z } from 'zod'\n\nfunction createServer() {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0',\n  })\n\n  server.tool(\n    'addition',\n    'Adds two numbers',\n    {\n      a: z.number().describe('The first number'),\n      b: z.number().describe('The second number'),\n    },\n    async (params) => {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: String(params.a + params.b),\n          },\n        ],\n      }\n    },\n  )\n\n  return server\n}\n\nexport default {\n  async fetch(request: Request) {\n    if (new URL(request.url).pathname !== '\u002Fmcp') {\n      return new Response('Not found', { status: 404 })\n    }\n\n    const server = createServer()\n    const transport = new WebStandardStreamableHTTPServerTransport({\n      sessionIdGenerator: undefined,\n      enableJsonResponse: true,\n    })\n\n    await server.connect(transport)\n\n    try {\n      return await transport.handleRequest(request)\n    }\n    finally {\n      await transport.close()\n      await server.close()\n    }\n  },\n} satisfies ExportedHandler\u003CEnv>\n","ts",[25,696,697,712,724,736,742,753,773,783,793,798,802,813,820,827,831,854,872,876,897,904,909,914,924,941,946,952,958,963,969,974,983,988,993,1004,1027,1052,1076,1081,1086,1101,1118,1129,1139,1145,1150,1165,1170,1178,1195,1200,1208,1221,1232,1237,1242],{"__ignoreMap":48},[52,698,699,703,706,709],{"class":54,"line":55},[52,700,702],{"class":701},"s8jYJ","import",[52,704,705],{"class":92}," { McpServer } ",[52,707,708],{"class":701},"from",[52,710,711],{"class":62}," '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\n",[52,713,714,716,719,721],{"class":54,"line":96},[52,715,702],{"class":701},[52,717,718],{"class":92}," { WebStandardStreamableHTTPServerTransport } ",[52,720,708],{"class":701},[52,722,723],{"class":62}," '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FwebStandardStreamableHttp.js'\n",[52,725,726,728,731,733],{"class":54,"line":105},[52,727,702],{"class":701},[52,729,730],{"class":92}," { z } ",[52,732,708],{"class":701},[52,734,735],{"class":62}," 'zod'\n",[52,737,738],{"class":54,"line":120},[52,739,741],{"emptyLinePlaceholder":740},true,"\n",[52,743,744,747,750],{"class":54,"line":133},[52,745,746],{"class":701},"function",[52,748,749],{"class":58}," createServer",[52,751,752],{"class":92},"() {\n",[52,754,755,758,761,764,767,770],{"class":54,"line":144},[52,756,757],{"class":701},"  const",[52,759,760],{"class":66}," server",[52,762,763],{"class":701}," =",[52,765,766],{"class":701}," new",[52,768,769],{"class":58}," McpServer",[52,771,772],{"class":92},"({\n",[52,774,775,778,781],{"class":54,"line":150},[52,776,777],{"class":92},"    name: ",[52,779,780],{"class":62},"'ai-agent'",[52,782,117],{"class":92},[52,784,785,788,791],{"class":54,"line":209},[52,786,787],{"class":92},"    version: ",[52,789,790],{"class":62},"'1.0.0'",[52,792,117],{"class":92},[52,794,795],{"class":54,"line":215},[52,796,797],{"class":92},"  })\n",[52,799,800],{"class":54,"line":221},[52,801,741],{"emptyLinePlaceholder":740},[52,803,804,807,810],{"class":54,"line":227},[52,805,806],{"class":92},"  server.",[52,808,809],{"class":58},"tool",[52,811,812],{"class":92},"(\n",[52,814,815,818],{"class":54,"line":233},[52,816,817],{"class":62},"    'addition'",[52,819,117],{"class":92},[52,821,822,825],{"class":54,"line":238},[52,823,824],{"class":62},"    'Adds two numbers'",[52,826,117],{"class":92},[52,828,829],{"class":54,"line":407},[52,830,542],{"class":92},[52,832,833,836,839,842,845,848,851],{"class":54,"line":419},[52,834,835],{"class":92},"      a: z.",[52,837,838],{"class":58},"number",[52,840,841],{"class":92},"().",[52,843,844],{"class":58},"describe",[52,846,847],{"class":92},"(",[52,849,850],{"class":62},"'The first number'",[52,852,853],{"class":92},"),\n",[52,855,856,859,861,863,865,867,870],{"class":54,"line":431},[52,857,858],{"class":92},"      b: z.",[52,860,838],{"class":58},[52,862,841],{"class":92},[52,864,844],{"class":58},[52,866,847],{"class":92},[52,868,869],{"class":62},"'The second number'",[52,871,853],{"class":92},[52,873,874],{"class":54,"line":443},[52,875,557],{"class":92},[52,877,878,881,884,888,891,894],{"class":54,"line":455},[52,879,880],{"class":701},"    async",[52,882,883],{"class":92}," (",[52,885,887],{"class":886},"sP4rz","params",[52,889,890],{"class":92},") ",[52,892,893],{"class":701},"=>",[52,895,896],{"class":92}," {\n",[52,898,899,902],{"class":54,"line":466},[52,900,901],{"class":701},"      return",[52,903,896],{"class":92},[52,905,906],{"class":54,"line":472},[52,907,908],{"class":92},"        content: [\n",[52,910,911],{"class":54,"line":480},[52,912,913],{"class":92},"          {\n",[52,915,916,919,922],{"class":54,"line":488},[52,917,918],{"class":92},"            type: ",[52,920,921],{"class":62},"'text'",[52,923,117],{"class":92},[52,925,926,929,932,935,938],{"class":54,"line":494},[52,927,928],{"class":92},"            text: ",[52,930,931],{"class":58},"String",[52,933,934],{"class":92},"(params.a ",[52,936,937],{"class":701},"+",[52,939,940],{"class":92}," params.b),\n",[52,942,943],{"class":54,"line":500},[52,944,945],{"class":92},"          },\n",[52,947,949],{"class":54,"line":948},25,[52,950,951],{"class":92},"        ],\n",[52,953,955],{"class":54,"line":954},26,[52,956,957],{"class":92},"      }\n",[52,959,961],{"class":54,"line":960},27,[52,962,557],{"class":92},[52,964,966],{"class":54,"line":965},28,[52,967,968],{"class":92},"  )\n",[52,970,972],{"class":54,"line":971},29,[52,973,741],{"emptyLinePlaceholder":740},[52,975,977,980],{"class":54,"line":976},30,[52,978,979],{"class":701},"  return",[52,981,982],{"class":92}," server\n",[52,984,986],{"class":54,"line":985},31,[52,987,153],{"class":92},[52,989,991],{"class":54,"line":990},32,[52,992,741],{"emptyLinePlaceholder":740},[52,994,996,999,1002],{"class":54,"line":995},33,[52,997,998],{"class":701},"export",[52,1000,1001],{"class":701}," default",[52,1003,896],{"class":92},[52,1005,1007,1010,1013,1015,1018,1021,1024],{"class":54,"line":1006},34,[52,1008,1009],{"class":701},"  async",[52,1011,1012],{"class":58}," fetch",[52,1014,847],{"class":92},[52,1016,1017],{"class":886},"request",[52,1019,1020],{"class":701},":",[52,1022,1023],{"class":58}," Request",[52,1025,1026],{"class":92},") {\n",[52,1028,1030,1033,1035,1038,1041,1044,1047,1050],{"class":54,"line":1029},35,[52,1031,1032],{"class":701},"    if",[52,1034,883],{"class":92},[52,1036,1037],{"class":701},"new",[52,1039,1040],{"class":58}," URL",[52,1042,1043],{"class":92},"(request.url).pathname ",[52,1045,1046],{"class":701},"!==",[52,1048,1049],{"class":62}," '\u002Fmcp'",[52,1051,1026],{"class":92},[52,1053,1055,1057,1059,1062,1064,1067,1070,1073],{"class":54,"line":1054},36,[52,1056,901],{"class":701},[52,1058,766],{"class":701},[52,1060,1061],{"class":58}," Response",[52,1063,847],{"class":92},[52,1065,1066],{"class":62},"'Not found'",[52,1068,1069],{"class":92},", { status: ",[52,1071,1072],{"class":66},"404",[52,1074,1075],{"class":92}," })\n",[52,1077,1079],{"class":54,"line":1078},37,[52,1080,628],{"class":92},[52,1082,1084],{"class":54,"line":1083},38,[52,1085,741],{"emptyLinePlaceholder":740},[52,1087,1089,1092,1094,1096,1098],{"class":54,"line":1088},39,[52,1090,1091],{"class":701},"    const",[52,1093,760],{"class":66},[52,1095,763],{"class":701},[52,1097,749],{"class":58},[52,1099,1100],{"class":92},"()\n",[52,1102,1104,1106,1109,1111,1113,1116],{"class":54,"line":1103},40,[52,1105,1091],{"class":701},[52,1107,1108],{"class":66}," transport",[52,1110,763],{"class":701},[52,1112,766],{"class":701},[52,1114,1115],{"class":58}," WebStandardStreamableHTTPServerTransport",[52,1117,772],{"class":92},[52,1119,1121,1124,1127],{"class":54,"line":1120},41,[52,1122,1123],{"class":92},"      sessionIdGenerator: ",[52,1125,1126],{"class":66},"undefined",[52,1128,117],{"class":92},[52,1130,1132,1135,1137],{"class":54,"line":1131},42,[52,1133,1134],{"class":92},"      enableJsonResponse: ",[52,1136,368],{"class":66},[52,1138,117],{"class":92},[52,1140,1142],{"class":54,"line":1141},43,[52,1143,1144],{"class":92},"    })\n",[52,1146,1148],{"class":54,"line":1147},44,[52,1149,741],{"emptyLinePlaceholder":740},[52,1151,1153,1156,1159,1162],{"class":54,"line":1152},45,[52,1154,1155],{"class":701},"    await",[52,1157,1158],{"class":92}," server.",[52,1160,1161],{"class":58},"connect",[52,1163,1164],{"class":92},"(transport)\n",[52,1166,1168],{"class":54,"line":1167},46,[52,1169,741],{"emptyLinePlaceholder":740},[52,1171,1173,1176],{"class":54,"line":1172},47,[52,1174,1175],{"class":701},"    try",[52,1177,896],{"class":92},[52,1179,1181,1183,1186,1189,1192],{"class":54,"line":1180},48,[52,1182,901],{"class":701},[52,1184,1185],{"class":701}," await",[52,1187,1188],{"class":92}," transport.",[52,1190,1191],{"class":58},"handleRequest",[52,1193,1194],{"class":92},"(request)\n",[52,1196,1198],{"class":54,"line":1197},49,[52,1199,628],{"class":92},[52,1201,1203,1206],{"class":54,"line":1202},50,[52,1204,1205],{"class":701},"    finally",[52,1207,896],{"class":92},[52,1209,1211,1214,1216,1219],{"class":54,"line":1210},51,[52,1212,1213],{"class":701},"      await",[52,1215,1188],{"class":92},[52,1217,1218],{"class":58},"close",[52,1220,1100],{"class":92},[52,1222,1224,1226,1228,1230],{"class":54,"line":1223},52,[52,1225,1213],{"class":701},[52,1227,1158],{"class":92},[52,1229,1218],{"class":58},[52,1231,1100],{"class":92},[52,1233,1235],{"class":54,"line":1234},53,[52,1236,628],{"class":92},[52,1238,1240],{"class":54,"line":1239},54,[52,1241,469],{"class":92},[52,1243,1245,1248,1251,1254,1257,1260],{"class":54,"line":1244},55,[52,1246,1247],{"class":92},"} ",[52,1249,1250],{"class":701},"satisfies",[52,1252,1253],{"class":58}," ExportedHandler",[52,1255,1256],{"class":92},"\u003C",[52,1258,1259],{"class":58},"Env",[52,1261,1262],{"class":92},">\n",[10,1264,1265,1268,1269,1272,1273,1276,1277,1280,1281,1284],{},[25,1266,1267],{},"createServer"," crée un nouveau serveur MCP à chaque requête, et ",[25,1270,1271],{},"sessionIdGenerator: undefined"," désactive les sessions MCP. Aucun état de requête n'est ainsi partagé entre les clients. ",[25,1274,1275],{},"enableJsonResponse: true"," est adapté à cet outil en requête-réponse et permet de fermer le serveur et le transport une fois la réponse créée. La vérification de route expose le serveur MCP uniquement sur ",[25,1278,1279],{},"\u002Fmcp",". Vous pouvez maintenant supprimer ",[25,1282,1283],{},"server\u002Froutes\u002Fmcp.ts",".",[10,1286,1287],{},"Nous pouvons démarrer le serveur de développement pour tester nos changements.",[42,1289,1291],{"className":44,"code":1290,"filename":1283,"language":47,"meta":48,"style":48},"pnpm run dev:wrangler\n",[25,1292,1293],{"__ignoreMap":48},[52,1294,1295,1297,1299],{"class":54,"line":55},[52,1296,59],{"class":58},[52,1298,651],{"class":62},[52,1300,1301],{"class":62}," dev:wrangler\n",[10,1303,1304],{},"Vous pouvez tester via l'application IA ou via l'Inspector MCP.",[242,1306,1308],{"color":1307,"icon":245},"primary",[10,1309,1310,1311,1314,1315,1318,1319,1322],{},"Modifiez ",[25,1312,1313],{},"NUXT_MCP_ENDPOINT"," dans votre fichier ",[25,1316,1317],{},".env"," pour utiliser l'endpoint MCP local : ",[25,1320,1321],{},"http:\u002F\u002Flocalhost:8787\u002Fmcp",". Utilisez l'URL exacte affichée par Wrangler s'il choisit un port différent.",[34,1324,1326],{"id":1325},"déployer-sur-cloudflare","Déployer sur Cloudflare",[10,1328,1329],{},"C'est la partie la plus simple !",[10,1331,1332],{},"Exécutez :",[42,1334,1336],{"className":44,"code":1335,"filename":46,"language":47,"meta":48,"style":48},"pnpm run deploy:wrangler\n",[25,1337,1338],{"__ignoreMap":48},[52,1339,1340,1342,1344],{"class":54,"line":55},[52,1341,59],{"class":58},[52,1343,651],{"class":62},[52,1345,1346],{"class":62}," deploy:wrangler\n",[10,1348,1349,1350,1352,1353,1284],{},"Après le déploiement, Wrangler affiche l'URL du Worker. Votre endpoint MCP correspond à l'URL du Worker suivie de ",[25,1351,1279],{},", par exemple ",[25,1354,1355],{},"https:\u002F\u002Four-mcp.\u003Cyour-subdomain>.workers.dev\u002Fmcp",[10,1357,1358],{},"Pour déployer l'application IA, exécutez :",[42,1360,1362],{"className":44,"code":1361,"filename":46,"language":47,"meta":48,"style":48},"SERVER_PRESET=cloudflare_pages pnpm run build && npx wrangler --cwd dist pages deploy\n",[25,1363,1364],{"__ignoreMap":48},[52,1365,1366,1369,1372,1375,1378,1380,1383,1386,1389,1391,1394,1397,1400],{"class":54,"line":55},[52,1367,1368],{"class":92},"SERVER_PRESET",[52,1370,1371],{"class":701},"=",[52,1373,1374],{"class":62},"cloudflare_pages",[52,1376,1377],{"class":58}," pnpm",[52,1379,651],{"class":62},[52,1381,1382],{"class":62}," build",[52,1384,1385],{"class":92}," && ",[52,1387,1388],{"class":58},"npx",[52,1390,70],{"class":62},[52,1392,1393],{"class":66}," --cwd",[52,1395,1396],{"class":62}," dist",[52,1398,1399],{"class":62}," pages",[52,1401,1402],{"class":62}," deploy\n",[10,1404,1405,1406,1409,1410,1412],{},"La dernière étape consiste à configurer les variables d'environnement dans votre projet Cloudflare Pages. Ajoutez ",[25,1407,1408],{},"NUXT_OPEN_AI_API_KEY"," comme secret et ",[25,1411,1313],{}," comme texte brut, en utilisant l'URL de l'endpoint MCP du Worker déployé.",[1414,1415,1416,1421],"figure",{},[1417,1418],"img",{"alt":1419,"src":1420},"Paramètres Cloudflare Pages","\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare\u002Fpages-settings.webp",[1422,1423,1419],"figcaption",{},[10,1425,1426],{},"Votre application IA est maintenant déployée et peut utiliser le serveur MCP exécuté sur Cloudflare.",[1414,1428,1429,1430,1429,1439],{},"\n  ",[1431,1432,1433,1434,1429],"video",{"autoPlay":740,"loop":740,"muted":740,"playsInline":740},"\n    ",[1435,1436],"source",{"src":1437,"type":1438},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare\u002Four-ai-agent.mp4","video\u002Fmp4",[1422,1440,1441],{},"Notre Agent IA, déployé pour tous.",[10,1443,1444],{},"La série est terminée : nous avons construit un Agent, placé sa capacité derrière MCP, connecté le tout à une interface de chat et déployé les deux parties.",[1446,1447,1448],"style",{},"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 .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}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 .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":48,"searchDepth":96,"depth":96,"links":1450},[1451,1452,1453],{"id":36,"depth":96,"text":37},{"id":671,"depth":96,"text":672},{"id":1325,"depth":96,"text":1326},"81b0747d-3674-4639-b65a-1730ad55f922","2025-10-07","Déployez l'application IA et son serveur MCP sur Cloudflare afin que chacun puisse utiliser ses capacités en ligne, depuis n'importe quel Agent.","md",{"branch":1459},"05.deploying-our-ai-agent-to-the-world-using-cloudflare",null,{},"\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare","---\ncontentId: 81b0747d-3674-4639-b65a-1730ad55f922\npart: 5\ntitle: Déployer notre Agent IA dans le monde avec Cloudflare\ndescription: Déployez l'application IA et son serveur MCP sur Cloudflare afin que chacun puisse utiliser ses capacités en ligne, depuis n'importe quel Agent.\ngithub:\n  branch: 05.deploying-our-ai-agent-to-the-world-using-cloudflare\ndate: 2025-10-07\nseriesSlug: ai-agents-and-mcp-server-teaming-up-for-the-agentic-web\n---\n\nCette dernière partie est optionnelle : vous pouvez déployer l'application et le serveur MCP où vous le souhaitez. J'ai choisi Cloudflare, car c'est la plateforme que j'utilise quotidiennement pour déployer des projets JavaScript. Nous allons effectuer un petit refactoring pour exécuter le serveur MCP dans un Worker Cloudflare, tout en conservant l'Agent et son interface Nuxt dans une application distincte.\n\nCloudflare fournit plusieurs primitives pour [les Agents IA et les serveurs MCP](https:\u002F\u002Fdevelopers.cloudflare.com\u002Fagents\u002F). Notre outil d'addition n'a pas d'état, nous pouvons donc l'héberger dans un Worker classique. Le transport Web Standards du SDK MCP fonctionne directement avec les API `Request` et `Response` du Worker, nous n'avons donc pas besoin d'un Durable Object. Un serveur MCP avec état aurait besoin d'une gestion persistante des sessions.\n\n## Mettre en place l'outillage\n\nD'abord, installez les dépendances :\n\n```bash [terminal]\npnpm add -D wrangler @types\u002Fnode\n```\n\nEnsuite, ajoutez les scripts suivants à `package.json` :\n\n```json [package.json]\n{\n  \"scripts\": {\n    \"dev:wrangler\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc dev\",\n    \"deploy:wrangler\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc deploy\",\n    \"cf-typegen\": \"wrangler --config .\u002Fworker\u002Fwrangler.jsonc types worker\u002Fworker-configuration.d.ts\"\n  }\n}\n```\n\nNous avons aussi besoin d'un `wrangler.jsonc` pour configurer notre Worker Cloudflare. Créez `worker\u002Fwrangler.jsonc` avec le contenu suivant :\n\n```jsonc [Exemple]\n{\n  \"$schema\": \"node_modules\u002Fwrangler\u002Fconfig-schema.json\",\n  \"name\": \"our-mcp\",\n  \"main\": \"index.ts\",\n  \"compatibility_date\": \"2025-03-10\",\n  \"compatibility_flags\": [\n    \"nodejs_compat\"\n  ],\n  \"observability\": {\n    \"enabled\": true,\n    \"head_sampling_rate\": 0.1\n  }\n}\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLe fichier `wrangler.jsonc` n'est pas stocké à la racine pour éviter les conflits lorsque nous déploierons l'application Nuxt.\n::\n\nAvec ce fichier, Wrangler cherchera `index.ts` dans le répertoire `worker`, ce qui correspond à `worker\u002Findex.ts`. La configuration se trouve dans le répertoire `worker` afin de ne pas entrer en conflit avec le déploiement Cloudflare Pages de l'application Nuxt.\n\nPour terminer la mise en place, créez un fichier `tsconfig.worker.json` pour configurer TypeScript pour le Worker :\n\n```json [tsconfig.worker.json]\n{\n  \"compilerOptions\": {\n    \"target\": \"es2021\",\n    \"jsx\": \"react-jsx\",\n    \"lib\": [\n      \"es2021\"\n    ],\n    \"module\": \"es2022\",\n    \"moduleResolution\": \"bundler\",\n    \"resolveJsonModule\": true,\n    \"allowJs\": true,\n    \"checkJs\": false,\n    \"strict\": true,\n    \"noEmit\": true,\n    \"allowSyntheticDefaultImports\": true,\n    \"forceConsistentCasingInFileNames\": true,\n    \"isolatedModules\": true,\n    \"skipLibCheck\": true\n  },\n  \"include\": [\n    \"worker\u002Fworker-configuration.d.ts\",\n    \"worker\u002F**\u002F*.ts\"\n  ]\n}\n```\n\nAjoutez ce fichier au `tsconfig.json` existant dans la section `references` :\n\n```json [tsconfig.json] {17}\n{\n  \"files\": [],\n  \"references\": [\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.app.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.server.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.shared.json\"\n    },\n    {\n      \"path\": \".\u002F.nuxt\u002Ftsconfig.node.json\"\n    },\n    {\n      \"path\": \".\u002Ftsconfig.worker.json\"\n    }\n  ]\n}\n```\n\nGénérez maintenant les types :\n\n```bash [terminal]\npnpm run cf-typegen\n```\n\nCela garantit une bonne autocomplétion dans les fichiers du Worker.\n\nN'oubliez pas d'ajouter le dossier `.wrangler` à `.gitignore` pour éviter de le commettre par erreur.\n\n## Passage au Worker\n\nMaintenant que l'outillage est prêt, déplaçons le serveur MCP dans un Worker Cloudflare. Un Worker est un objet exporté avec une méthode `fetch`. Pour notre outil d'addition sans état, `WebStandardStreamableHTTPServerTransport` fournit directement le transport Streamable HTTP grâce aux API standard du Worker, sans nécessiter de Durable Object.\n\nRemplacez l'ancienne route Nitro par ce fichier `worker\u002Findex.ts` complet :\n\n```ts [worker\u002Findex.ts]\nimport { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FwebStandardStreamableHttp.js'\nimport { z } from 'zod'\n\nfunction createServer() {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0',\n  })\n\n  server.tool(\n    'addition',\n    'Adds two numbers',\n    {\n      a: z.number().describe('The first number'),\n      b: z.number().describe('The second number'),\n    },\n    async (params) => {\n      return {\n        content: [\n          {\n            type: 'text',\n            text: String(params.a + params.b),\n          },\n        ],\n      }\n    },\n  )\n\n  return server\n}\n\nexport default {\n  async fetch(request: Request) {\n    if (new URL(request.url).pathname !== '\u002Fmcp') {\n      return new Response('Not found', { status: 404 })\n    }\n\n    const server = createServer()\n    const transport = new WebStandardStreamableHTTPServerTransport({\n      sessionIdGenerator: undefined,\n      enableJsonResponse: true,\n    })\n\n    await server.connect(transport)\n\n    try {\n      return await transport.handleRequest(request)\n    }\n    finally {\n      await transport.close()\n      await server.close()\n    }\n  },\n} satisfies ExportedHandler\u003CEnv>\n```\n\n`createServer` crée un nouveau serveur MCP à chaque requête, et `sessionIdGenerator: undefined` désactive les sessions MCP. Aucun état de requête n'est ainsi partagé entre les clients. `enableJsonResponse: true` est adapté à cet outil en requête-réponse et permet de fermer le serveur et le transport une fois la réponse créée. La vérification de route expose le serveur MCP uniquement sur `\u002Fmcp`. Vous pouvez maintenant supprimer `server\u002Froutes\u002Fmcp.ts`.\n\nNous pouvons démarrer le serveur de développement pour tester nos changements.\n\n```bash [server\u002Froutes\u002Fmcp.ts]\npnpm run dev:wrangler\n```\n\nVous pouvez tester via l'application IA ou via l'Inspector MCP.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"primary\"}\nModifiez `NUXT_MCP_ENDPOINT` dans votre fichier `.env` pour utiliser l'endpoint MCP local : `http:\u002F\u002Flocalhost:8787\u002Fmcp`. Utilisez l'URL exacte affichée par Wrangler s'il choisit un port différent.\n::\n\n## Déployer sur Cloudflare\n\nC'est la partie la plus simple !\n\nExécutez :\n\n```bash [terminal]\npnpm run deploy:wrangler\n```\n\nAprès le déploiement, Wrangler affiche l'URL du Worker. Votre endpoint MCP correspond à l'URL du Worker suivie de `\u002Fmcp`, par exemple `https:\u002F\u002Four-mcp.\u003Cyour-subdomain>.workers.dev\u002Fmcp`.\n\nPour déployer l'application IA, exécutez :\n\n```bash [terminal]\nSERVER_PRESET=cloudflare_pages pnpm run build && npx wrangler --cwd dist pages deploy\n```\n\nLa dernière étape consiste à configurer les variables d'environnement dans votre projet Cloudflare Pages. Ajoutez `NUXT_OPEN_AI_API_KEY` comme secret et `NUXT_MCP_ENDPOINT` comme texte brut, en utilisant l'URL de l'endpoint MCP du Worker déployé.\n\n![Paramètres Cloudflare Pages](\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare\u002Fpages-settings.webp)\n\nVotre application IA est maintenant déployée et peut utiliser le serveur MCP exécuté sur Cloudflare.\n\n\u003Cfigure>\n  \u003Cvideo autoplay loop muted playsinline>\n    \u003Csource src=\"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare\u002Four-ai-agent.mp4\" type=\"video\u002Fmp4\">\n  \u003C\u002Fvideo>\n  \u003Cfigcaption>Notre Agent IA, déployé pour tous.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>\n\nLa série est terminée : nous avons construit un Agent, placé sa capacité derrière MCP, connecté le tout à une interface de chat et déployé les deux parties.\n",{"title":5,"description":1456},"ai-agents-and-mcp-server-teaming-up-for-the-agentic-web",{"loc":1462,"images":1467},[1468],{"loc":1420},"fr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare","Lv5J0K_6eGbPbMRXBdCtJ8eVJwD7CCPO6azRJQ3JgxY",{"overview":1472,"chapters":1581},{"id":1473,"title":1474,"body":1475,"contentId":1560,"date":1455,"description":1561,"extension":1457,"github":1562,"meetTheInstructor":1565,"meta":1566,"navigation":740,"part":1460,"path":1567,"rawbody":1568,"robots":1460,"schemaOrg":1460,"seo":1569,"seriesSlug":1465,"sitemap":1570,"stem":1571,"subtitle":1572,"topics":1573,"__hash__":1580},"series\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web.md","Agents IA et serveur MCP au service du web agentique",{"type":7,"value":1476,"toc":1557},[1477,1480,1483,1491,1494,1497,1500,1534,1537,1547,1551],[10,1478,1479],{},"Salut 👋,",[10,1481,1482],{},"Depuis des mois, j'explore l'IA et les dernières innovations. L'idée de discuter avec mon site web, littéralement de discuter avec lui via une interface semblable à celle que vous utilisez pour parler à un ami sur votre téléphone, me fascine. Cette idée m'a conduit à créer des Agents IA capables d'interagir avec mon site et de fournir aux utilisateurs des informations de qualité, à jour et adaptées au contexte.",[10,1484,1485,1486,1490],{},"Cette série ne traite pas des détails exacts de l'implémentation de mon Agent IA. J'ai déjà écrit deux articles à ce sujet. Le premier couvre ",[17,1487,1489],{"href":1488},"\u002Ffr\u002Fposts\u002Fai-agents-will-deeply-transform-our-experience-with-the-web","l'essor des Agents IA"," et leur impact potentiel sur le web. Le second aborde l'implémentation technique de mon Agent IA.",[10,1492,1493],{},"Cette série se concentre plutôt sur les concepts fondamentaux pour vous aider à démarrer votre propre Agent IA et à le connecter à un serveur MCP afin de lui donner davantage de capacités.",[10,1495,1496],{},"Nous ne construirons rien de particulièrement élaboré, car le web agentique en est encore à ses débuts. Comme je l'ai mentionné dans mon article sur l'essor des Agents IA, tout reste à bâtir. Il n'existe pas encore de schémas établis ni de méthodes définitives. Pour l'instant, la meilleure approche est de construire, expérimenter, évaluer et itérer.",[10,1498,1499],{},"Au fil de cette série, nous allons :",[1501,1502,1503,1511,1517,1523,1529],"ol",{},[1504,1505,1506,1510],"li",{},[1507,1508,1509],"strong",{},"Construire facilement un Agent IA grâce à l'AI SDK"," : avec l'AI SDK, nous créerons notre premier Agent IA et comprendrons ce qui le différencie d'une IA traditionnelle.",[1504,1512,1513,1516],{},[1507,1514,1515],{},"MCP pour fournir des capacités supplémentaires à l'Agent IA"," : avec le SDK MCP officiel, nous créerons un serveur MCP doté d'un outil simple et interagirons avec lui.",[1504,1518,1519,1522],{},[1507,1520,1521],{},"Associer les Agents IA et MCP pour accéder au monde extérieur"," : un Agent IA a besoin d'outils ; nous connecterons l'Agent au serveur MCP afin qu'il puisse interagir avec le monde extérieur.",[1504,1524,1525,1528],{},[1507,1526,1527],{},"Une application IA puissante avec Nitro et Nuxt UI"," : nous construirons une interface utilisateur pour notre Agent IA afin de faciliter l'interaction.",[1504,1530,1531,1533],{},[1507,1532,5],{}," : enfin, nous déploierons l'application IA et le serveur MCP sur Cloudflare. C'est la plateforme que j'ai choisie, mais vous pouvez les déployer où vous préférez.",[10,1535,1536],{},"À la fin, vous disposerez d'une interface de chat complète pour dialoguer avec votre Agent IA, ainsi que de tous les éléments nécessaires pour continuer à expérimenter.",[1414,1538,1429,1539,1429,1544],{},[1431,1540,1433,1541,1429],{"autoPlay":740,"loop":740,"muted":740,"playsInline":740},[1435,1542],{"src":1543,"type":1438},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fai-application.mp4",[1422,1545,1546],{},"Notre application IA finale.",[34,1548,1550],{"id":1549},"chapitres","Chapitres",[1552,1553],"series-chapters-list",{"className":1554},[1555,1556],"mx-auto","max-w-5xl",{"title":48,"searchDepth":96,"depth":96,"links":1558},[1559],{"id":1549,"depth":96,"text":1550},"fdeaf0eb-725c-4963-a535-b059c6bd980d","Construisez une application IA, comprenez le fonctionnement des Agents IA et découvrez comment un serveur MCP étend leurs capacités.",{"name":1563,"repository":1564},"AI Agents and MCP","barbapapazes\u002Fai-agent","Depuis des mois, je suis fasciné par l'IA et son potentiel. J'ai peiné à trouver les bonnes ressources pour comprendre le fonctionnement des Agents IA. Après des recherches et des expérimentations, j'ai commencé à saisir les concepts clés et je suis ravi de partager ce que j'ai appris avec vous.",{},"\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web","---\ncontentId: fdeaf0eb-725c-4963-a535-b059c6bd980d\ntitle: \"Agents IA et serveur MCP au service du web agentique\"\nsubtitle: Explorez l'avenir du web en construisant une application IA\ndescription: Construisez une application IA, comprenez le fonctionnement des Agents IA et découvrez comment un serveur MCP étend leurs capacités.\ndate: 2025-10-07\ntopics:\n  - ai-agents\n  - ai\n  - mcp\n  - agentic-web\n  - nuxt\n  - nuxt-ui\ngithub:\n  name: AI Agents and MCP\n  repository: barbapapazes\u002Fai-agent\nmeetTheInstructor: Depuis des mois, je suis fasciné par l'IA et son potentiel. J'ai peiné à trouver les bonnes ressources pour comprendre le fonctionnement des Agents IA. Après des recherches et des expérimentations, j'ai commencé à saisir les concepts clés et je suis ravi de partager ce que j'ai appris avec vous.\nseriesSlug: ai-agents-and-mcp-server-teaming-up-for-the-agentic-web\n---\n\nSalut 👋,\n\nDepuis des mois, j'explore l'IA et les dernières innovations. L'idée de discuter avec mon site web, littéralement de discuter avec lui via une interface semblable à celle que vous utilisez pour parler à un ami sur votre téléphone, me fascine. Cette idée m'a conduit à créer des Agents IA capables d'interagir avec mon site et de fournir aux utilisateurs des informations de qualité, à jour et adaptées au contexte.\n\nCette série ne traite pas des détails exacts de l'implémentation de mon Agent IA. J'ai déjà écrit deux articles à ce sujet. Le premier couvre [l'essor des Agents IA](\u002Ffr\u002Fposts\u002Fai-agents-will-deeply-transform-our-experience-with-the-web) et leur impact potentiel sur le web. Le second aborde l'implémentation technique de mon Agent IA.\n\nCette série se concentre plutôt sur les concepts fondamentaux pour vous aider à démarrer votre propre Agent IA et à le connecter à un serveur MCP afin de lui donner davantage de capacités.\n\nNous ne construirons rien de particulièrement élaboré, car le web agentique en est encore à ses débuts. Comme je l'ai mentionné dans mon article sur l'essor des Agents IA, tout reste à bâtir. Il n'existe pas encore de schémas établis ni de méthodes définitives. Pour l'instant, la meilleure approche est de construire, expérimenter, évaluer et itérer.\n\nAu fil de cette série, nous allons :\n\n1. **Construire facilement un Agent IA grâce à l'AI SDK** : avec l'AI SDK, nous créerons notre premier Agent IA et comprendrons ce qui le différencie d'une IA traditionnelle.\n2. **MCP pour fournir des capacités supplémentaires à l'Agent IA** : avec le SDK MCP officiel, nous créerons un serveur MCP doté d'un outil simple et interagirons avec lui.\n3. **Associer les Agents IA et MCP pour accéder au monde extérieur** : un Agent IA a besoin d'outils ; nous connecterons l'Agent au serveur MCP afin qu'il puisse interagir avec le monde extérieur.\n4. **Une application IA puissante avec Nitro et Nuxt UI** : nous construirons une interface utilisateur pour notre Agent IA afin de faciliter l'interaction.\n5. **Déployer notre Agent IA dans le monde avec Cloudflare** : enfin, nous déploierons l'application IA et le serveur MCP sur Cloudflare. C'est la plateforme que j'ai choisie, mais vous pouvez les déployer où vous préférez.\n\nÀ la fin, vous disposerez d'une interface de chat complète pour dialoguer avec votre Agent IA, ainsi que de tous les éléments nécessaires pour continuer à expérimenter.\n\n\u003Cfigure>\n  \u003Cvideo autoplay loop muted playsinline>\n    \u003Csource src=\"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fai-application.mp4\" type=\"video\u002Fmp4\">\n  \u003C\u002Fvideo>\n  \u003Cfigcaption>Notre application IA finale.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1474,"description":1561},{"loc":1567},"fr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web","Explorez l'avenir du web en construisant une application IA",[1574,1575,1576,1577,1578,1579],"ai-agents","ai","mcp","agentic-web","nuxt","nuxt-ui","-HwT1nh_HXY5V9dlNZCSc3lLRsAtMnRAARN_LsYbWKs",[1582,1588,1594,1601,1607],{"contentId":1583,"title":1509,"description":1584,"path":1585,"part":55,"github":1586,"topics":1460},"59a8e5d2-5fc9-4087-b62e-88592bcbebd5","Les Agents IA peuvent sembler mystérieux, mais ils ne sont pas aussi complexes qu'ils en ont l'air. Prouvons-le avec des explications et des exemples détaillés.","\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fbuilding-an-ai-agent-made-easy-thanks-to-the-ai-sdk",{"branch":1587},"01.building-an-ai-agent-made-easy-thanks-to-the-ai-sdk",{"contentId":1589,"title":1515,"description":1590,"path":1591,"part":96,"github":1592,"topics":1460},"09b092f0-098a-43ff-b859-07b7892cb3f6","Les serveurs MCP se multiplient. Les comprendre est essentiel pour exploiter pleinement le potentiel des Agents IA.","\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent",{"branch":1593},"02.mcp-to-provide-additional-capabilities-to-the-ai-agent",{"contentId":1595,"title":1596,"description":1597,"path":1598,"part":105,"github":1599,"topics":1460},"99c16147-c018-4cb9-a94f-d9dfa738bb38","Associer Agents IA et MCP pour accéder au monde extérieur","Les Agents IA avec des outils personnalisés sont puissants. Connecter un serveur MCP à un Agent débloque un autre niveau de capacités.","\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fpair-ai-agents-with-mcp-to-access-the-outside-world",{"branch":1600},"03.pairing-ai-agents-with-mcp-to-make-outside-world-accessible",{"contentId":1602,"title":1527,"description":1603,"path":1604,"part":120,"github":1605,"topics":1460},"7ba7afbc-74f6-42bf-8545-af7b0b4ed440","Avoir un Agent IA est un bon début, mais l'intégrer dans une application fait toute la différence. Nuxt UI facilite cette étape.","\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fa-powerful-ai-application-made-with-nitro-and-nuxt-ui",{"branch":1606},"04.a-powerful-ai-application-made-with-nitro-and-nuxt-ui",{"contentId":1454,"title":5,"description":1456,"path":1462,"part":133,"github":1608,"topics":1460},{"branch":1459},1795016702880]