[{"data":1,"prerenderedAt":1538},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent":3,"series-context-\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web":1403},{"id":4,"title":5,"body":6,"contentId":1386,"date":1387,"description":1388,"extension":1389,"github":1390,"meetTheInstructor":1392,"meta":1393,"navigation":189,"part":108,"path":1394,"rawbody":1395,"robots":1392,"schemaOrg":1392,"seo":1396,"seriesSlug":1397,"sitemap":1398,"stem":1401,"subtitle":1392,"topics":1392,"__hash__":1402},"series\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent.md","MCP pour fournir des capacités supplémentaires à l'Agent IA",{"type":7,"value":8,"toc":1380},"minimark",[9,21,24,35,38,67,70,75,78,115,118,134,137,144,280,283,291,294,564,579,582,585,590,593,606,611,614,629,632,636,639,650,1077,1082,1353,1360,1363,1373,1376],[10,11,12,13,20],"p",{},"Nous avons construit notre premier Agent IA avec un outil d'addition. Dans cet article, nous allons déplacer cet outil dans un ",[14,15,19],"a",{"href":16,"rel":17},"https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fgetting-started\u002Fintro",[18],"nofollow","serveur MCP",", où il pourra être découvert et utilisé grâce à un protocole standard.",[10,22,23],{},"Petit rappel sur MCP : MCP est un standard open-source qui connecte les applications IA à des systèmes externes. Un serveur MCP fournit des outils, tandis qu'un client MCP se connecte à ce serveur et appelle ses outils pour le compte de l'Agent IA. Dans cette série, notre application IA contient l'Agent et son client MCP ; le serveur MCP expose les capacités dont l'Agent a besoin. Visuellement, cela ressemble à ceci :",[25,26,27,32],"figure",{},[28,29],"img",{"alt":30,"src":31},"Application IA interagissant avec le monde réel via MCP.","\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Fmcp.webp",[33,34,30],"figcaption",{},[10,36,37],{},"Vous vous demandez peut-être pourquoi nous avons besoin d'un serveur MCP. Nous n'en avons pas strictement besoin pour ce petit outil d'addition : un outil direct est plus simple lorsqu'une capacité n'appartient qu'à une seule application étroitement couplée. MCP devient utile lorsqu'une capacité doit être partagée, déployée indépendamment ou consommée par des clients compatibles.",[39,40,41,55,61],"ol",{},[42,43,44,48,49,54],"li",{},[45,46,47],"strong",{},"Prendre en charge des clients compatibles"," : en fournissant MCP, vous permettez aux applications IA et aux outils de développement qui prennent en charge le protocole d'utiliser vos capacités. Par exemple, un ",[14,50,53],{"href":51,"rel":52},"https:\u002F\u002Fui.nuxt.com\u002Fdocs\u002Fgetting-started\u002Fai\u002Fmcp",[18],"serveur MCP pour une bibliothèque de composants"," peut rendre sa documentation et ses outils disponibles dans un éditeur de code.",[42,56,57,60],{},[45,58,59],{},"Utiliser des serveurs MCP externes"," : votre Agent peut aussi se connecter à un serveur MCP que vous n'avez pas créé afin de s'intégrer à un système existant ou à une capacité tierce.",[42,62,63,66],{},[45,64,65],{},"Découpler les capacités"," : l'Agent n'a besoin de connaître que le nom, la description, les entrées et les sorties d'un outil. Le serveur MCP possède son implémentation et peut évoluer indépendamment.",[10,68,69],{},"Dans cette série, MCP établit une frontière claire entre l'Agent et les capacités qu'il peut utiliser.",[71,72,74],"h2",{"id":73},"construire-le-serveur-mcp","Construire le serveur MCP",[10,76,77],{},"Dans notre application Nitro, nous pouvons créer une nouvelle route pour le serveur MCP.",[79,80,86],"pre",{"className":81,"code":82,"filename":83,"language":84,"meta":85,"style":85},"language-bash shiki shiki-themes github-light github-light github-dark","mkdir -p server\u002Froutes\ntouch server\u002Froutes\u002Fmcp.ts\n","terminal","bash","",[87,88,89,106],"code",{"__ignoreMap":85},[90,91,94,98,102],"span",{"class":92,"line":93},"line",1,[90,95,97],{"class":96},"snPdu","mkdir",[90,99,101],{"class":100},"sBjJW"," -p",[90,103,105],{"class":104},"sIIMD"," server\u002Froutes\n",[90,107,109,112],{"class":92,"line":108},2,[90,110,111],{"class":96},"touch",[90,113,114],{"class":104}," server\u002Froutes\u002Fmcp.ts\n",[10,116,117],{},"Ensuite, nous devons installer le SDK MCP :",[79,119,121],{"className":81,"code":120,"filename":83,"language":84,"meta":85,"style":85},"pnpm add @modelcontextprotocol\u002Fsdk@^1.29.0\n",[87,122,123],{"__ignoreMap":85},[90,124,125,128,131],{"class":92,"line":93},[90,126,127],{"class":96},"pnpm",[90,129,130],{"class":104}," add",[90,132,133],{"class":104}," @modelcontextprotocol\u002Fsdk@^1.29.0\n",[10,135,136],{},"C'est le SDK MCP officiel pour construire des Model Context Protocols en TypeScript.",[10,138,139,140,143],{},"Maintenant, nous pouvons créer notre serveur MCP dans le fichier ",[87,141,142],{},"server\u002Froutes\u002Fmcp.ts"," :",[79,145,154],{"className":146,"code":147,"filename":142,"highlights":148,"language":153,"meta":85,"style":85},"language-ts shiki shiki-themes github-light github-light github-dark","import { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { defineEventHandler } from 'h3'\n\nexport default defineEventHandler(async (event) => {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0'\n  })\n})\n",[149,150,151,152],5,6,7,8,"ts",[87,155,156,172,184,191,225,247,259,268,274],{"__ignoreMap":85},[90,157,158,162,166,169],{"class":92,"line":93},[90,159,161],{"class":160},"s8jYJ","import",[90,163,165],{"class":164},"sxrX7"," { McpServer } ",[90,167,168],{"class":160},"from",[90,170,171],{"class":104}," '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\n",[90,173,174,176,179,181],{"class":92,"line":108},[90,175,161],{"class":160},[90,177,178],{"class":164}," { defineEventHandler } ",[90,180,168],{"class":160},[90,182,183],{"class":104}," 'h3'\n",[90,185,187],{"class":92,"line":186},3,[90,188,190],{"emptyLinePlaceholder":189},true,"\n",[90,192,194,197,200,203,206,209,212,216,219,222],{"class":92,"line":193},4,[90,195,196],{"class":160},"export",[90,198,199],{"class":160}," default",[90,201,202],{"class":96}," defineEventHandler",[90,204,205],{"class":164},"(",[90,207,208],{"class":160},"async",[90,210,211],{"class":164}," (",[90,213,215],{"class":214},"sP4rz","event",[90,217,218],{"class":164},") ",[90,220,221],{"class":160},"=>",[90,223,224],{"class":164}," {\n",[90,226,229,232,235,238,241,244],{"class":227,"line":149},[92,228],"highlight",[90,230,231],{"class":160},"  const",[90,233,234],{"class":100}," server",[90,236,237],{"class":160}," =",[90,239,240],{"class":160}," new",[90,242,243],{"class":96}," McpServer",[90,245,246],{"class":164},"({\n",[90,248,250,253,256],{"class":249,"line":150},[92,228],[90,251,252],{"class":164},"    name: ",[90,254,255],{"class":104},"'ai-agent'",[90,257,258],{"class":164},",\n",[90,260,262,265],{"class":261,"line":151},[92,228],[90,263,264],{"class":164},"    version: ",[90,266,267],{"class":104},"'1.0.0'\n",[90,269,271],{"class":270,"line":152},[92,228],[90,272,273],{"class":164},"  })\n",[90,275,277],{"class":92,"line":276},9,[90,278,279],{"class":164},"})\n",[10,281,282],{},"Nous avons maintenant un objet serveur MCP, mais il ne peut pas encore recevoir de requêtes. MCP sépare le serveur, qui définit les capacités et les outils du protocole, du transport, qui achemine les requêtes et les réponses. Dans notre cas, la route Nitro hébergera un transport Streamable HTTP afin qu'un client MCP puisse atteindre le serveur via HTTP.",[284,285,288],"callout",{"color":286,"icon":287},"info","i-ph-info-duotone",[10,289,290],{},"Streamable HTTP est utile ici, car il permet à un serveur MCP hébergé à distance de communiquer à travers des requêtes et réponses HTTP classiques.",[10,292,293],{},"Heureusement, le SDK MCP fournit tout ce dont nous avons besoin pour ajouter une couche de transport HTTP.",[79,295,313],{"className":146,"code":296,"filename":297,"highlights":298,"language":153,"meta":85,"style":85},"import { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { StreamableHTTPServerTransport } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FstreamableHttp.js'\nimport { defineEventHandler, readBody } from 'h3'\n\nexport default defineEventHandler(async (event) => {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0'\n  })\n\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: undefined\n  })\n\n  event.node.res.on('close', () => {\n    transport.close()\n    server.close()\n  })\n\n  await server.connect(transport)\n\n  const body = await readBody(event)\n\n  await transport.handleRequest(event.node.req, event.node.res, body)\n})\n","Exemple",[186,299,300,301,302,303,304,305,306,307,308,309,310,311,312],11,12,13,14,15,16,17,18,19,20,21,22,23,24,[87,314,315,325,337,349,353,375,389,397,403,407,412,429,438,443,448,469,481,491,496,501,516,521,540,545,559],{"__ignoreMap":85},[90,316,317,319,321,323],{"class":92,"line":93},[90,318,161],{"class":160},[90,320,165],{"class":164},[90,322,168],{"class":160},[90,324,171],{"class":104},[90,326,327,329,332,334],{"class":92,"line":108},[90,328,161],{"class":160},[90,330,331],{"class":164}," { StreamableHTTPServerTransport } ",[90,333,168],{"class":160},[90,335,336],{"class":104}," '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FstreamableHttp.js'\n",[90,338,340,342,345,347],{"class":339,"line":186},[92,228],[90,341,161],{"class":160},[90,343,344],{"class":164}," { defineEventHandler, readBody } ",[90,346,168],{"class":160},[90,348,183],{"class":104},[90,350,351],{"class":92,"line":193},[90,352,190],{"emptyLinePlaceholder":189},[90,354,355,357,359,361,363,365,367,369,371,373],{"class":92,"line":149},[90,356,196],{"class":160},[90,358,199],{"class":160},[90,360,202],{"class":96},[90,362,205],{"class":164},[90,364,208],{"class":160},[90,366,211],{"class":164},[90,368,215],{"class":214},[90,370,218],{"class":164},[90,372,221],{"class":160},[90,374,224],{"class":164},[90,376,377,379,381,383,385,387],{"class":92,"line":150},[90,378,231],{"class":160},[90,380,234],{"class":100},[90,382,237],{"class":160},[90,384,240],{"class":160},[90,386,243],{"class":96},[90,388,246],{"class":164},[90,390,391,393,395],{"class":92,"line":151},[90,392,252],{"class":164},[90,394,255],{"class":104},[90,396,258],{"class":164},[90,398,399,401],{"class":92,"line":152},[90,400,264],{"class":164},[90,402,267],{"class":104},[90,404,405],{"class":92,"line":276},[90,406,273],{"class":164},[90,408,410],{"class":92,"line":409},10,[90,411,190],{"emptyLinePlaceholder":189},[90,413,415,417,420,422,424,427],{"class":414,"line":299},[92,228],[90,416,231],{"class":160},[90,418,419],{"class":100}," transport",[90,421,237],{"class":160},[90,423,240],{"class":160},[90,425,426],{"class":96}," StreamableHTTPServerTransport",[90,428,246],{"class":164},[90,430,432,435],{"class":431,"line":300},[92,228],[90,433,434],{"class":164},"    sessionIdGenerator: ",[90,436,437],{"class":100},"undefined\n",[90,439,441],{"class":440,"line":301},[92,228],[90,442,273],{"class":164},[90,444,446],{"class":445,"line":302},[92,228],[90,447,190],{"emptyLinePlaceholder":189},[90,449,451,454,457,459,462,465,467],{"class":450,"line":303},[92,228],[90,452,453],{"class":164},"  event.node.res.",[90,455,456],{"class":96},"on",[90,458,205],{"class":164},[90,460,461],{"class":104},"'close'",[90,463,464],{"class":164},", () ",[90,466,221],{"class":160},[90,468,224],{"class":164},[90,470,472,475,478],{"class":471,"line":304},[92,228],[90,473,474],{"class":164},"    transport.",[90,476,477],{"class":96},"close",[90,479,480],{"class":164},"()\n",[90,482,484,487,489],{"class":483,"line":305},[92,228],[90,485,486],{"class":164},"    server.",[90,488,477],{"class":96},[90,490,480],{"class":164},[90,492,494],{"class":493,"line":306},[92,228],[90,495,273],{"class":164},[90,497,499],{"class":498,"line":307},[92,228],[90,500,190],{"emptyLinePlaceholder":189},[90,502,504,507,510,513],{"class":503,"line":308},[92,228],[90,505,506],{"class":160},"  await",[90,508,509],{"class":164}," server.",[90,511,512],{"class":96},"connect",[90,514,515],{"class":164},"(transport)\n",[90,517,519],{"class":518,"line":309},[92,228],[90,520,190],{"emptyLinePlaceholder":189},[90,522,524,526,529,531,534,537],{"class":523,"line":310},[92,228],[90,525,231],{"class":160},[90,527,528],{"class":100}," body",[90,530,237],{"class":160},[90,532,533],{"class":160}," await",[90,535,536],{"class":96}," readBody",[90,538,539],{"class":164},"(event)\n",[90,541,543],{"class":542,"line":311},[92,228],[90,544,190],{"emptyLinePlaceholder":189},[90,546,548,550,553,556],{"class":547,"line":312},[92,228],[90,549,506],{"class":160},[90,551,552],{"class":164}," transport.",[90,554,555],{"class":96},"handleRequest",[90,557,558],{"class":164},"(event.node.req, event.node.res, body)\n",[90,560,562],{"class":92,"line":561},25,[90,563,279],{"class":164},[10,565,566,567,570,571,574,575,578],{},"Avec ",[87,568,569],{},"server.connect(transport)",", nous attachons le serveur au transport HTTP. Avec ",[87,572,573],{},"transport.handleRequest(event.node.req, event.node.res, body)",", nous transmettons la requête entrante à ce transport, qui renvoie ensuite la réponse au client. Cet exemple crée un transport sans état pour chaque requête, donc ",[87,576,577],{},"sessionIdGenerator: undefined"," désactive les identifiants de session. Lorsque la réponse se termine ou est interrompue prématurément, nous fermons le transport et le serveur pour libérer leurs ressources.",[10,580,581],{},"Le corps de la requête est important car les outils peuvent avoir des paramètres d'entrée.",[10,583,584],{},"Avec cette configuration, nous pouvons maintenant essayer le MCP.",[586,587,589],"h3",{"id":588},"essayer-le-mcp","Essayer le MCP",[10,591,592],{},"Pour essayer le MCP, nous pouvons utiliser l'Inspector MCP officiel :",[79,594,596],{"className":81,"code":595,"filename":83,"language":84,"meta":85,"style":85},"npx @modelcontextprotocol\u002Finspector@latest\n",[87,597,598],{"__ignoreMap":85},[90,599,600,603],{"class":92,"line":93},[90,601,602],{"class":96},"npx",[90,604,605],{"class":104}," @modelcontextprotocol\u002Finspector@latest\n",[284,607,608],{"color":286,"icon":287},[10,609,610],{},"Utilisez l'Inspector pour vérifier un serveur MCP avant de le connecter à une application IA. Un modèle peut décider de ne pas appeler un outil donné, tandis que l'Inspector permet de tester directement le protocole et les outils.",[10,612,613],{},"Ensuite, nous pouvons saisir l'URL du MCP et ping le serveur pour vérifier qu'il fonctionne.",[25,615,616,617,616,626],{},"\n  ",[618,619,620,621,616],"video",{"autoPlay":189,"loop":189,"muted":189,"playsInline":189},"\n    ",[622,623],"source",{"src":624,"type":625},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Fpinging-server.mp4","video\u002Fmp4",[33,627,628],{},"Ping du serveur MCP.",[10,630,631],{},"Le serveur est maintenant accessible via son transport HTTP.",[586,633,635],{"id":634},"ajouter-un-outil","Ajouter un outil",[10,637,638],{},"Maintenant que nous avons un serveur MCP opérationnel, nous pouvons déplacer notre outil d'addition de l'Agent IA vers le serveur MCP.",[10,640,641,642,645,646,649],{},"Dans le fichier ",[87,643,644],{},"server\u002Fapi\u002Fchat.ts",", retirez ",[87,647,648],{},"tool"," de l'import de l'AI SDK, supprimez l'import Zod et effacez l'enregistrement de l'outil d'addition :",[79,651,654],{"className":652,"code":653,"filename":644,"language":153,"meta":85,"style":85},"language-ts shiki shiki-themes github-light github-light github-dark has-diff","import { createOpenAI } from '@ai-sdk\u002Fopenai'\nimport { convertToModelMessages, stepCountIs, streamText } from 'ai'\nimport { defineEventHandler, defineLazyEventHandler, readBody } from 'h3'\nimport { useRuntimeConfig } from 'nitropack\u002Fruntime'\nimport { z } from 'zod' \u002F\u002F [!code --]\n\nexport default defineLazyEventHandler(() => {\n  const runtimeConfig = useRuntimeConfig()\n\n  const model = createOpenAI({\n    apiKey: runtimeConfig.openAiApiKey,\n  })\n\n  return defineEventHandler(async (event) => {\n    const { messages } = await readBody(event)\n\n    return streamText({\n      model: model('gpt-5-nano'),\n      system: `You are a helpful assistant. You can use the tool to add two numbers together.`,\n      tools: { \u002F\u002F [!code --]\n        addition: tool({ \u002F\u002F [!code --]\n          description: 'Adds two numbers', \u002F\u002F [!code --]\n          inputSchema: z.object({ \u002F\u002F [!code --]\n            a: z.number().describe('The first number'), \u002F\u002F [!code --]\n            b: z.number().describe('The second number'), \u002F\u002F [!code --]\n          }), \u002F\u002F [!code --]\n          execute: ({ a, b }) => ({ \u002F\u002F [!code --]\n            a, \u002F\u002F [!code --]\n            b, \u002F\u002F [!code --]\n            result: a + b \u002F\u002F [!code --]\n          }), \u002F\u002F [!code --]\n        }), \u002F\u002F [!code --]\n      }, \u002F\u002F [!code --]\n      stopWhen: stepCountIs(2),\n      messages: convertToModelMessages(messages),\n    }).toUIMessageStreamResponse()\n  })\n})\n",[87,655,656,668,680,691,703,718,722,738,752,756,770,775,779,783,804,827,831,841,857,867,873,884,896,907,930,949,956,981,988,995,1008,1014,1021,1028,1044,1056,1067,1072],{"__ignoreMap":85},[90,657,658,660,663,665],{"class":92,"line":93},[90,659,161],{"class":160},[90,661,662],{"class":164}," { createOpenAI } ",[90,664,168],{"class":160},[90,666,667],{"class":104}," '@ai-sdk\u002Fopenai'\n",[90,669,670,672,675,677],{"class":92,"line":108},[90,671,161],{"class":160},[90,673,674],{"class":164}," { convertToModelMessages, stepCountIs, streamText } ",[90,676,168],{"class":160},[90,678,679],{"class":104}," 'ai'\n",[90,681,682,684,687,689],{"class":92,"line":186},[90,683,161],{"class":160},[90,685,686],{"class":164}," { defineEventHandler, defineLazyEventHandler, readBody } ",[90,688,168],{"class":160},[90,690,183],{"class":104},[90,692,693,695,698,700],{"class":92,"line":193},[90,694,161],{"class":160},[90,696,697],{"class":164}," { useRuntimeConfig } ",[90,699,168],{"class":160},[90,701,702],{"class":104}," 'nitropack\u002Fruntime'\n",[90,704,708,710,713,715],{"class":705,"line":149},[92,706,707],"diff","remove",[90,709,161],{"class":160},[90,711,712],{"class":164}," { z } ",[90,714,168],{"class":160},[90,716,717],{"class":104}," 'zod'",[90,719,720],{"class":92,"line":150},[90,721,190],{"emptyLinePlaceholder":189},[90,723,724,726,728,731,734,736],{"class":92,"line":151},[90,725,196],{"class":160},[90,727,199],{"class":160},[90,729,730],{"class":96}," defineLazyEventHandler",[90,732,733],{"class":164},"(() ",[90,735,221],{"class":160},[90,737,224],{"class":164},[90,739,740,742,745,747,750],{"class":92,"line":152},[90,741,231],{"class":160},[90,743,744],{"class":100}," runtimeConfig",[90,746,237],{"class":160},[90,748,749],{"class":96}," useRuntimeConfig",[90,751,480],{"class":164},[90,753,754],{"class":92,"line":276},[90,755,190],{"emptyLinePlaceholder":189},[90,757,758,760,763,765,768],{"class":92,"line":409},[90,759,231],{"class":160},[90,761,762],{"class":100}," model",[90,764,237],{"class":160},[90,766,767],{"class":96}," createOpenAI",[90,769,246],{"class":164},[90,771,772],{"class":92,"line":299},[90,773,774],{"class":164},"    apiKey: runtimeConfig.openAiApiKey,\n",[90,776,777],{"class":92,"line":300},[90,778,273],{"class":164},[90,780,781],{"class":92,"line":301},[90,782,190],{"emptyLinePlaceholder":189},[90,784,785,788,790,792,794,796,798,800,802],{"class":92,"line":302},[90,786,787],{"class":160},"  return",[90,789,202],{"class":96},[90,791,205],{"class":164},[90,793,208],{"class":160},[90,795,211],{"class":164},[90,797,215],{"class":214},[90,799,218],{"class":164},[90,801,221],{"class":160},[90,803,224],{"class":164},[90,805,806,809,812,815,818,821,823,825],{"class":92,"line":303},[90,807,808],{"class":160},"    const",[90,810,811],{"class":164}," { ",[90,813,814],{"class":100},"messages",[90,816,817],{"class":164}," } ",[90,819,820],{"class":160},"=",[90,822,533],{"class":160},[90,824,536],{"class":96},[90,826,539],{"class":164},[90,828,829],{"class":92,"line":304},[90,830,190],{"emptyLinePlaceholder":189},[90,832,833,836,839],{"class":92,"line":305},[90,834,835],{"class":160},"    return",[90,837,838],{"class":96}," streamText",[90,840,246],{"class":164},[90,842,843,846,849,851,854],{"class":92,"line":306},[90,844,845],{"class":164},"      model: ",[90,847,848],{"class":96},"model",[90,850,205],{"class":164},[90,852,853],{"class":104},"'gpt-5-nano'",[90,855,856],{"class":164},"),\n",[90,858,859,862,865],{"class":92,"line":307},[90,860,861],{"class":164},"      system: ",[90,863,864],{"class":104},"`You are a helpful assistant. You can use the tool to add two numbers together.`",[90,866,258],{"class":164},[90,868,870],{"class":869,"line":308},[92,706,707],[90,871,872],{"class":164},"      tools: { ",[90,874,876,879,881],{"class":875,"line":309},[92,706,707],[90,877,878],{"class":164},"        addition: ",[90,880,648],{"class":96},[90,882,883],{"class":164},"({ ",[90,885,887,890,893],{"class":886,"line":310},[92,706,707],[90,888,889],{"class":164},"          description: ",[90,891,892],{"class":104},"'Adds two numbers'",[90,894,895],{"class":164},", ",[90,897,899,902,905],{"class":898,"line":311},[92,706,707],[90,900,901],{"class":164},"          inputSchema: z.",[90,903,904],{"class":96},"object",[90,906,883],{"class":164},[90,908,910,913,916,919,922,924,927],{"class":909,"line":312},[92,706,707],[90,911,912],{"class":164},"            a: z.",[90,914,915],{"class":96},"number",[90,917,918],{"class":164},"().",[90,920,921],{"class":96},"describe",[90,923,205],{"class":164},[90,925,926],{"class":104},"'The first number'",[90,928,929],{"class":164},"), ",[90,931,933,936,938,940,942,944,947],{"class":932,"line":561},[92,706,707],[90,934,935],{"class":164},"            b: z.",[90,937,915],{"class":96},[90,939,918],{"class":164},[90,941,921],{"class":96},[90,943,205],{"class":164},[90,945,946],{"class":104},"'The second number'",[90,948,929],{"class":164},[90,950,953],{"class":951,"line":952},[92,706,707],26,[90,954,955],{"class":164},"          }), ",[90,957,960,963,966,968,970,973,976,978],{"class":958,"line":959},[92,706,707],27,[90,961,962],{"class":96},"          execute",[90,964,965],{"class":164},": ({ ",[90,967,14],{"class":214},[90,969,895],{"class":164},[90,971,972],{"class":214},"b",[90,974,975],{"class":164}," }) ",[90,977,221],{"class":160},[90,979,980],{"class":164}," ({ ",[90,982,985],{"class":983,"line":984},[92,706,707],28,[90,986,987],{"class":164},"            a, ",[90,989,992],{"class":990,"line":991},[92,706,707],29,[90,993,994],{"class":164},"            b, ",[90,996,999,1002,1005],{"class":997,"line":998},[92,706,707],30,[90,1000,1001],{"class":164},"            result: a ",[90,1003,1004],{"class":160},"+",[90,1006,1007],{"class":164}," b ",[90,1009,1012],{"class":1010,"line":1011},[92,706,707],31,[90,1013,955],{"class":164},[90,1015,1018],{"class":1016,"line":1017},[92,706,707],32,[90,1019,1020],{"class":164},"        }), ",[90,1022,1025],{"class":1023,"line":1024},[92,706,707],33,[90,1026,1027],{"class":164},"      }, ",[90,1029,1031,1034,1037,1039,1042],{"class":92,"line":1030},34,[90,1032,1033],{"class":164},"      stopWhen: ",[90,1035,1036],{"class":96},"stepCountIs",[90,1038,205],{"class":164},[90,1040,1041],{"class":100},"2",[90,1043,856],{"class":164},[90,1045,1047,1050,1053],{"class":92,"line":1046},35,[90,1048,1049],{"class":164},"      messages: ",[90,1051,1052],{"class":96},"convertToModelMessages",[90,1054,1055],{"class":164},"(messages),\n",[90,1057,1059,1062,1065],{"class":92,"line":1058},36,[90,1060,1061],{"class":164},"    }).",[90,1063,1064],{"class":96},"toUIMessageStreamResponse",[90,1066,480],{"class":164},[90,1068,1070],{"class":92,"line":1069},37,[90,1071,273],{"class":164},[90,1073,1075],{"class":92,"line":1074},38,[90,1076,279],{"class":164},[10,1078,641,1079,1081],{},[87,1080,142],{},", enregistrez l'outil d'addition auprès du serveur MCP.",[79,1083,1086],{"className":146,"code":1084,"filename":142,"highlights":1085,"language":153,"meta":85,"style":85},"import { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { defineEventHandler } from 'h3'\nimport { z } from 'zod'\n\nexport default defineEventHandler(async (event) => {\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          { type: 'text', text: String(params.a + params.b) }\n        ]\n      }\n    }\n  )\n\n  \u002F\u002F ...\n})\n",[186,299,300,301,302,303,304,305,306,307,308,309,310,311,312,561,952,959,984],[87,1087,1088,1098,1108,1120,1124,1146,1160,1168,1174,1178,1182,1193,1201,1209,1215,1233,1252,1258,1275,1283,1289,1312,1318,1324,1330,1336,1341,1348],{"__ignoreMap":85},[90,1089,1090,1092,1094,1096],{"class":92,"line":93},[90,1091,161],{"class":160},[90,1093,165],{"class":164},[90,1095,168],{"class":160},[90,1097,171],{"class":104},[90,1099,1100,1102,1104,1106],{"class":92,"line":108},[90,1101,161],{"class":160},[90,1103,178],{"class":164},[90,1105,168],{"class":160},[90,1107,183],{"class":104},[90,1109,1111,1113,1115,1117],{"class":1110,"line":186},[92,228],[90,1112,161],{"class":160},[90,1114,712],{"class":164},[90,1116,168],{"class":160},[90,1118,1119],{"class":104}," 'zod'\n",[90,1121,1122],{"class":92,"line":193},[90,1123,190],{"emptyLinePlaceholder":189},[90,1125,1126,1128,1130,1132,1134,1136,1138,1140,1142,1144],{"class":92,"line":149},[90,1127,196],{"class":160},[90,1129,199],{"class":160},[90,1131,202],{"class":96},[90,1133,205],{"class":164},[90,1135,208],{"class":160},[90,1137,211],{"class":164},[90,1139,215],{"class":214},[90,1141,218],{"class":164},[90,1143,221],{"class":160},[90,1145,224],{"class":164},[90,1147,1148,1150,1152,1154,1156,1158],{"class":92,"line":150},[90,1149,231],{"class":160},[90,1151,234],{"class":100},[90,1153,237],{"class":160},[90,1155,240],{"class":160},[90,1157,243],{"class":96},[90,1159,246],{"class":164},[90,1161,1162,1164,1166],{"class":92,"line":151},[90,1163,252],{"class":164},[90,1165,255],{"class":104},[90,1167,258],{"class":164},[90,1169,1170,1172],{"class":92,"line":152},[90,1171,264],{"class":164},[90,1173,267],{"class":104},[90,1175,1176],{"class":92,"line":276},[90,1177,273],{"class":164},[90,1179,1180],{"class":92,"line":409},[90,1181,190],{"emptyLinePlaceholder":189},[90,1183,1185,1188,1190],{"class":1184,"line":299},[92,228],[90,1186,1187],{"class":164},"  server.",[90,1189,648],{"class":96},[90,1191,1192],{"class":164},"(\n",[90,1194,1196,1199],{"class":1195,"line":300},[92,228],[90,1197,1198],{"class":104},"    'addition'",[90,1200,258],{"class":164},[90,1202,1204,1207],{"class":1203,"line":301},[92,228],[90,1205,1206],{"class":104},"    'Adds two numbers'",[90,1208,258],{"class":164},[90,1210,1212],{"class":1211,"line":302},[92,228],[90,1213,1214],{"class":164},"    {\n",[90,1216,1218,1221,1223,1225,1227,1229,1231],{"class":1217,"line":303},[92,228],[90,1219,1220],{"class":164},"      a: z.",[90,1222,915],{"class":96},[90,1224,918],{"class":164},[90,1226,921],{"class":96},[90,1228,205],{"class":164},[90,1230,926],{"class":104},[90,1232,856],{"class":164},[90,1234,1236,1239,1241,1243,1245,1247,1249],{"class":1235,"line":304},[92,228],[90,1237,1238],{"class":164},"      b: z.",[90,1240,915],{"class":96},[90,1242,918],{"class":164},[90,1244,921],{"class":96},[90,1246,205],{"class":164},[90,1248,946],{"class":104},[90,1250,1251],{"class":164},")\n",[90,1253,1255],{"class":1254,"line":305},[92,228],[90,1256,1257],{"class":164},"    },\n",[90,1259,1261,1264,1266,1269,1271,1273],{"class":1260,"line":306},[92,228],[90,1262,1263],{"class":160},"    async",[90,1265,211],{"class":164},[90,1267,1268],{"class":214},"params",[90,1270,218],{"class":164},[90,1272,221],{"class":160},[90,1274,224],{"class":164},[90,1276,1278,1281],{"class":1277,"line":307},[92,228],[90,1279,1280],{"class":160},"      return",[90,1282,224],{"class":164},[90,1284,1286],{"class":1285,"line":308},[92,228],[90,1287,1288],{"class":164},"        content: [\n",[90,1290,1292,1295,1298,1301,1304,1307,1309],{"class":1291,"line":309},[92,228],[90,1293,1294],{"class":164},"          { type: ",[90,1296,1297],{"class":104},"'text'",[90,1299,1300],{"class":164},", text: ",[90,1302,1303],{"class":96},"String",[90,1305,1306],{"class":164},"(params.a ",[90,1308,1004],{"class":160},[90,1310,1311],{"class":164}," params.b) }\n",[90,1313,1315],{"class":1314,"line":310},[92,228],[90,1316,1317],{"class":164},"        ]\n",[90,1319,1321],{"class":1320,"line":311},[92,228],[90,1322,1323],{"class":164},"      }\n",[90,1325,1327],{"class":1326,"line":312},[92,228],[90,1328,1329],{"class":164},"    }\n",[90,1331,1333],{"class":1332,"line":561},[92,228],[90,1334,1335],{"class":164},"  )\n",[90,1337,1339],{"class":1338,"line":952},[92,228],[90,1340,190],{"emptyLinePlaceholder":189},[90,1342,1344],{"class":1343,"line":959},[92,228],[90,1345,1347],{"class":1346},"sCsY4","  \u002F\u002F ...\n",[90,1349,1351],{"class":1350,"line":984},[92,228],[90,1352,279],{"class":164},[10,1354,1355,1356,1359],{},"L'enregistrement de l'outil est volontairement proche de celui de l'outil direct utilisé dans la première partie. Son implémentation et son schéma d'entrée ont été déplacés vers le serveur MCP, tandis que sa sortie suit maintenant le format standardisé ",[87,1357,1358],{},"content"," de MCP. L'Agent n'est pas encore connecté à ce serveur ; nous le ferons dans l'article suivant.",[10,1361,1362],{},"Nous pouvons maintenant utiliser manuellement notre outil d'addition :",[25,1364,616,1365,616,1370],{},[618,1366,620,1367,616],{"autoPlay":189,"loop":189,"muted":189,"playsInline":189},[622,1368],{"src":1369,"type":625},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Flisting-and-using-the-addition-tool.mp4",[33,1371,1372],{},"Lister et utiliser l'outil d'addition.",[10,1374,1375],{},"Nous avons maintenant un serveur MCP fonctionnel qui expose l'outil d'addition. Dans l'article suivant, nous donnerons à notre Agent IA un client MCP afin qu'il puisse découvrir et utiliser cet outil.",[1377,1378,1379],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}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 .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 pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":85,"searchDepth":108,"depth":108,"links":1381},[1382],{"id":73,"depth":108,"text":74,"children":1383},[1384,1385],{"id":588,"depth":186,"text":589},{"id":634,"depth":186,"text":635},"09b092f0-098a-43ff-b859-07b7892cb3f6","2025-10-07","Les serveurs MCP se multiplient. Les comprendre est essentiel pour exploiter pleinement le potentiel des Agents IA.","md",{"branch":1391},"02.mcp-to-provide-additional-capabilities-to-the-ai-agent",null,{},"\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent","---\ncontentId: 09b092f0-098a-43ff-b859-07b7892cb3f6\npart: 2\ntitle: MCP pour fournir des capacités supplémentaires à l'Agent IA\ndescription: Les serveurs MCP se multiplient. Les comprendre est essentiel pour exploiter pleinement le potentiel des Agents IA.\ngithub:\n  branch: 02.mcp-to-provide-additional-capabilities-to-the-ai-agent\ndate: 2025-10-07\nseriesSlug: ai-agents-and-mcp-server-teaming-up-for-the-agentic-web\n---\n\nNous avons construit notre premier Agent IA avec un outil d'addition. Dans cet article, nous allons déplacer cet outil dans un [serveur MCP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fgetting-started\u002Fintro), où il pourra être découvert et utilisé grâce à un protocole standard.\n\nPetit rappel sur MCP : MCP est un standard open-source qui connecte les applications IA à des systèmes externes. Un serveur MCP fournit des outils, tandis qu'un client MCP se connecte à ce serveur et appelle ses outils pour le compte de l'Agent IA. Dans cette série, notre application IA contient l'Agent et son client MCP ; le serveur MCP expose les capacités dont l'Agent a besoin. Visuellement, cela ressemble à ceci :\n\n![Application IA interagissant avec le monde réel via MCP.](\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Fmcp.webp)\n\nVous vous demandez peut-être pourquoi nous avons besoin d'un serveur MCP. Nous n'en avons pas strictement besoin pour ce petit outil d'addition : un outil direct est plus simple lorsqu'une capacité n'appartient qu'à une seule application étroitement couplée. MCP devient utile lorsqu'une capacité doit être partagée, déployée indépendamment ou consommée par des clients compatibles.\n\n1. **Prendre en charge des clients compatibles** : en fournissant MCP, vous permettez aux applications IA et aux outils de développement qui prennent en charge le protocole d'utiliser vos capacités. Par exemple, un [serveur MCP pour une bibliothèque de composants](https:\u002F\u002Fui.nuxt.com\u002Fdocs\u002Fgetting-started\u002Fai\u002Fmcp) peut rendre sa documentation et ses outils disponibles dans un éditeur de code.\n2. **Utiliser des serveurs MCP externes** : votre Agent peut aussi se connecter à un serveur MCP que vous n'avez pas créé afin de s'intégrer à un système existant ou à une capacité tierce.\n3. **Découpler les capacités** : l'Agent n'a besoin de connaître que le nom, la description, les entrées et les sorties d'un outil. Le serveur MCP possède son implémentation et peut évoluer indépendamment.\n\nDans cette série, MCP établit une frontière claire entre l'Agent et les capacités qu'il peut utiliser.\n\n## Construire le serveur MCP\n\nDans notre application Nitro, nous pouvons créer une nouvelle route pour le serveur MCP.\n\n```bash [terminal]\nmkdir -p server\u002Froutes\ntouch server\u002Froutes\u002Fmcp.ts\n```\n\nEnsuite, nous devons installer le SDK MCP :\n\n```bash [terminal]\npnpm add @modelcontextprotocol\u002Fsdk@^1.29.0\n```\n\nC'est le SDK MCP officiel pour construire des Model Context Protocols en TypeScript.\n\nMaintenant, nous pouvons créer notre serveur MCP dans le fichier `server\u002Froutes\u002Fmcp.ts` :\n\n```ts [server\u002Froutes\u002Fmcp.ts] {5-8}\nimport { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { defineEventHandler } from 'h3'\n\nexport default defineEventHandler(async (event) => {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0'\n  })\n})\n```\n\nNous avons maintenant un objet serveur MCP, mais il ne peut pas encore recevoir de requêtes. MCP sépare le serveur, qui définit les capacités et les outils du protocole, du transport, qui achemine les requêtes et les réponses. Dans notre cas, la route Nitro hébergera un transport Streamable HTTP afin qu'un client MCP puisse atteindre le serveur via HTTP.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nStreamable HTTP est utile ici, car il permet à un serveur MCP hébergé à distance de communiquer à travers des requêtes et réponses HTTP classiques.\n::\n\nHeureusement, le SDK MCP fournit tout ce dont nous avons besoin pour ajouter une couche de transport HTTP.\n\n```ts [Exemple] {3,11-24}\nimport { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { StreamableHTTPServerTransport } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002FstreamableHttp.js'\nimport { defineEventHandler, readBody } from 'h3'\n\nexport default defineEventHandler(async (event) => {\n  const server = new McpServer({\n    name: 'ai-agent',\n    version: '1.0.0'\n  })\n\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: undefined\n  })\n\n  event.node.res.on('close', () => {\n    transport.close()\n    server.close()\n  })\n\n  await server.connect(transport)\n\n  const body = await readBody(event)\n\n  await transport.handleRequest(event.node.req, event.node.res, body)\n})\n```\n\nAvec `server.connect(transport)`, nous attachons le serveur au transport HTTP. Avec `transport.handleRequest(event.node.req, event.node.res, body)`, nous transmettons la requête entrante à ce transport, qui renvoie ensuite la réponse au client. Cet exemple crée un transport sans état pour chaque requête, donc `sessionIdGenerator: undefined` désactive les identifiants de session. Lorsque la réponse se termine ou est interrompue prématurément, nous fermons le transport et le serveur pour libérer leurs ressources.\n\nLe corps de la requête est important car les outils peuvent avoir des paramètres d'entrée.\n\nAvec cette configuration, nous pouvons maintenant essayer le MCP.\n\n### Essayer le MCP\n\nPour essayer le MCP, nous pouvons utiliser l'Inspector MCP officiel :\n\n```bash [terminal]\nnpx @modelcontextprotocol\u002Finspector@latest\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nUtilisez l'Inspector pour vérifier un serveur MCP avant de le connecter à une application IA. Un modèle peut décider de ne pas appeler un outil donné, tandis que l'Inspector permet de tester directement le protocole et les outils.\n::\n\nEnsuite, nous pouvons saisir l'URL du MCP et ping le serveur pour vérifier qu'il fonctionne.\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\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Fpinging-server.mp4\" type=\"video\u002Fmp4\">\n  \u003C\u002Fvideo>\n  \u003Cfigcaption>Ping du serveur MCP.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>\n\nLe serveur est maintenant accessible via son transport HTTP.\n\n### Ajouter un outil\n\nMaintenant que nous avons un serveur MCP opérationnel, nous pouvons déplacer notre outil d'addition de l'Agent IA vers le serveur MCP.\n\nDans le fichier `server\u002Fapi\u002Fchat.ts`, retirez `tool` de l'import de l'AI SDK, supprimez l'import Zod et effacez l'enregistrement de l'outil d'addition :\n\n```ts [server\u002Fapi\u002Fchat.ts]\nimport { createOpenAI } from '@ai-sdk\u002Fopenai'\nimport { convertToModelMessages, stepCountIs, streamText } from 'ai'\nimport { defineEventHandler, defineLazyEventHandler, readBody } from 'h3'\nimport { useRuntimeConfig } from 'nitropack\u002Fruntime'\nimport { z } from 'zod' \u002F\u002F [!code --]\n\nexport default defineLazyEventHandler(() => {\n  const runtimeConfig = useRuntimeConfig()\n\n  const model = createOpenAI({\n    apiKey: runtimeConfig.openAiApiKey,\n  })\n\n  return defineEventHandler(async (event) => {\n    const { messages } = await readBody(event)\n\n    return streamText({\n      model: model('gpt-5-nano'),\n      system: `You are a helpful assistant. You can use the tool to add two numbers together.`,\n      tools: { \u002F\u002F [!code --]\n        addition: tool({ \u002F\u002F [!code --]\n          description: 'Adds two numbers', \u002F\u002F [!code --]\n          inputSchema: z.object({ \u002F\u002F [!code --]\n            a: z.number().describe('The first number'), \u002F\u002F [!code --]\n            b: z.number().describe('The second number'), \u002F\u002F [!code --]\n          }), \u002F\u002F [!code --]\n          execute: ({ a, b }) => ({ \u002F\u002F [!code --]\n            a, \u002F\u002F [!code --]\n            b, \u002F\u002F [!code --]\n            result: a + b \u002F\u002F [!code --]\n          }), \u002F\u002F [!code --]\n        }), \u002F\u002F [!code --]\n      }, \u002F\u002F [!code --]\n      stopWhen: stepCountIs(2),\n      messages: convertToModelMessages(messages),\n    }).toUIMessageStreamResponse()\n  })\n})\n```\n\nDans le fichier `server\u002Froutes\u002Fmcp.ts`, enregistrez l'outil d'addition auprès du serveur MCP.\n\n```ts [server\u002Froutes\u002Fmcp.ts] {3,11-28}\nimport { McpServer } from '@modelcontextprotocol\u002Fsdk\u002Fserver\u002Fmcp.js'\nimport { defineEventHandler } from 'h3'\nimport { z } from 'zod'\n\nexport default defineEventHandler(async (event) => {\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          { type: 'text', text: String(params.a + params.b) }\n        ]\n      }\n    }\n  )\n\n  \u002F\u002F ...\n})\n```\n\nL'enregistrement de l'outil est volontairement proche de celui de l'outil direct utilisé dans la première partie. Son implémentation et son schéma d'entrée ont été déplacés vers le serveur MCP, tandis que sa sortie suit maintenant le format standardisé `content` de MCP. L'Agent n'est pas encore connecté à ce serveur ; nous le ferons dans l'article suivant.\n\nNous pouvons maintenant utiliser manuellement notre outil d'addition :\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\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent\u002Flisting-and-using-the-addition-tool.mp4\" type=\"video\u002Fmp4\">\n  \u003C\u002Fvideo>\n  \u003Cfigcaption>Lister et utiliser l'outil d'addition.\u003C\u002Ffigcaption>\n\u003C\u002Ffigure>\n\nNous avons maintenant un serveur MCP fonctionnel qui expose l'outil d'addition. Dans l'article suivant, nous donnerons à notre Agent IA un client MCP afin qu'il puisse découvrir et utiliser cet outil.\n",{"title":5,"description":1388},"ai-agents-and-mcp-server-teaming-up-for-the-agentic-web",{"loc":1394,"images":1399},[1400],{"loc":31},"fr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fmcp-to-provide-additional-capabilities-to-the-ai-agent","BLlp1b62I1O83dTRmlZFls-ZDbLclxbtWERfJugEe2I",{"overview":1404,"chapters":1510},{"id":1405,"title":1406,"body":1407,"contentId":1489,"date":1387,"description":1490,"extension":1389,"github":1491,"meetTheInstructor":1494,"meta":1495,"navigation":189,"part":1392,"path":1496,"rawbody":1497,"robots":1392,"schemaOrg":1392,"seo":1498,"seriesSlug":1397,"sitemap":1499,"stem":1500,"subtitle":1501,"topics":1502,"__hash__":1509},"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":1408,"toc":1486},[1409,1412,1415,1423,1426,1429,1432,1463,1466,1476,1480],[10,1410,1411],{},"Salut 👋,",[10,1413,1414],{},"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,1416,1417,1418,1422],{},"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 ",[14,1419,1421],{"href":1420},"\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,1424,1425],{},"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,1427,1428],{},"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,1430,1431],{},"Au fil de cette série, nous allons :",[39,1433,1434,1440,1445,1451,1457],{},[42,1435,1436,1439],{},[45,1437,1438],{},"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.",[42,1441,1442,1444],{},[45,1443,5],{}," : avec le SDK MCP officiel, nous créerons un serveur MCP doté d'un outil simple et interagirons avec lui.",[42,1446,1447,1450],{},[45,1448,1449],{},"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.",[42,1452,1453,1456],{},[45,1454,1455],{},"Une application IA puissante avec Nitro et Nuxt UI"," : nous construirons une interface utilisateur pour notre Agent IA afin de faciliter l'interaction.",[42,1458,1459,1462],{},[45,1460,1461],{},"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.",[10,1464,1465],{},"À 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.",[25,1467,616,1468,616,1473],{},[618,1469,620,1470,616],{"autoPlay":189,"loop":189,"muted":189,"playsInline":189},[622,1471],{"src":1472,"type":625},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fai-application.mp4",[33,1474,1475],{},"Notre application IA finale.",[71,1477,1479],{"id":1478},"chapitres","Chapitres",[1481,1482],"series-chapters-list",{"className":1483},[1484,1485],"mx-auto","max-w-5xl",{"title":85,"searchDepth":108,"depth":108,"links":1487},[1488],{"id":1478,"depth":108,"text":1479},"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":1492,"repository":1493},"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":1406,"description":1490},{"loc":1496},"fr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web","Explorez l'avenir du web en construisant une application IA",[1503,1504,1505,1506,1507,1508],"ai-agents","ai","mcp","agentic-web","nuxt","nuxt-ui","-HwT1nh_HXY5V9dlNZCSc3lLRsAtMnRAARN_LsYbWKs",[1511,1517,1519,1526,1532],{"contentId":1512,"title":1438,"description":1513,"path":1514,"part":93,"github":1515,"topics":1392},"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":1516},"01.building-an-ai-agent-made-easy-thanks-to-the-ai-sdk",{"contentId":1386,"title":5,"description":1388,"path":1394,"part":108,"github":1518,"topics":1392},{"branch":1391},{"contentId":1520,"title":1521,"description":1522,"path":1523,"part":186,"github":1524,"topics":1392},"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":1525},"03.pairing-ai-agents-with-mcp-to-make-outside-world-accessible",{"contentId":1527,"title":1455,"description":1528,"path":1529,"part":193,"github":1530,"topics":1392},"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":1531},"04.a-powerful-ai-application-made-with-nitro-and-nuxt-ui",{"contentId":1533,"title":1461,"description":1534,"path":1535,"part":149,"github":1536,"topics":1392},"81b0747d-3674-4639-b65a-1730ad55f922","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.","\u002Ffr\u002Fseries\u002Fai-agents-and-mcp-server-teaming-up-for-the-agentic-web\u002Fdeploying-our-ai-agent-to-the-world-using-cloudflare",{"branch":1537},"05.deploying-our-ai-agent-to-the-world-using-cloudflare",1795016702072]