[{"data":1,"prerenderedAt":596},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"/docs/mcp/connection":73,"/docs/mcp/connection-surround":591},[4],{"title":5,"path":6,"stem":7,"children":8,"page":26},"Docs","/docs","docs",[9,27,56,65],{"title":10,"path":11,"stem":12,"children":13,"page":26},"入门","/docs/start","docs/1.start",[14,18,22],{"title":15,"path":16,"stem":17},"快速开始","/docs/start/quick-start","docs/1.start/1.quick-start",{"title":19,"path":20,"stem":21},"选型指南","/docs/start/guide","docs/1.start/2.guide",{"title":23,"path":24,"stem":25},"术语表","/docs/start/glossary","docs/1.start/3.glossary",false,{"title":28,"path":29,"stem":30,"children":31,"page":26},"开放 API","/docs/api","docs/2.api",[32,36,40,44,48,52],{"title":33,"path":34,"stem":35},"V1 API 通用约定","/docs/api/conventions","docs/2.api/1.conventions",{"title":37,"path":38,"stem":39},"模型 API","/docs/api/models","docs/2.api/2.models",{"title":41,"path":42,"stem":43},"文本 API","/docs/api/text","docs/2.api/3.text",{"title":45,"path":46,"stem":47},"图像 API","/docs/api/images","docs/2.api/4.images",{"title":49,"path":50,"stem":51},"视频 API","/docs/api/videos","docs/2.api/5.videos",{"title":53,"path":54,"stem":55},"音频 API","/docs/api/audio","docs/2.api/6.audio",{"title":57,"path":58,"stem":59,"children":60,"page":26},"MCP 服务","/docs/mcp","docs/3.mcp",[61],{"title":62,"path":63,"stem":64},"MCP 连接与配置","/docs/mcp/connection","docs/3.mcp/1.connection",{"title":66,"path":67,"stem":68,"children":69,"page":26},"Skills","/docs/skills","docs/4.skills",[70],{"title":66,"path":71,"stem":72},"/docs/skills/skills-intro","docs/4.skills/1.skills-intro",{"id":74,"title":62,"body":75,"description":585,"extension":586,"meta":587,"navigation":588,"path":63,"seo":589,"stem":64,"__hash__":590},"docs/docs/3.mcp/1.connection.md",{"type":76,"value":77,"toc":576},"minimark",[78,82,85,89,111,113,116,119,258,315,321,323,326,329,373,376,378,381,406,417,419,422,425,450,453,466,468,471,560,562,565,572],[79,80,81],"p",{},"本文说明 云擎数智 MCP 服务的连接与配置。",[83,84],"hr",{},[86,87,88],"h2",{"id":88},"前置条件",[90,91,92,101,108],"ol",{},[93,94,95,96,100],"li",{},"拥有有效的 API Key（",[97,98,99],"code",{},"sk-xxx","）",[93,102,103,104,107],{},"网关已部署并暴露 ",[97,105,106],{},"/mcp"," 端点",[93,109,110],{},"客户端支持 MCP Streamable HTTP",[83,112],{},[86,114,115],{"id":115},"客户端配置",[79,117,118],{},"在 MCP 配置中添加：",[120,121,126],"pre",{"className":122,"code":123,"language":124,"meta":125,"style":125},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"yunsell\": {\n      \"url\": \"https://www.yunsell.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk-xxx\"\n      }\n    }\n  }\n}\n","json","",[97,127,128,137,156,172,198,212,234,240,246,252],{"__ignoreMap":125},[129,130,133],"span",{"class":131,"line":132},"line",1,[129,134,136],{"class":135},"sMK4o","{\n",[129,138,140,143,147,150,153],{"class":131,"line":139},2,[129,141,142],{"class":135},"  \"",[129,144,146],{"class":145},"spNyl","mcpServers",[129,148,149],{"class":135},"\"",[129,151,152],{"class":135},":",[129,154,155],{"class":135}," {\n",[129,157,159,162,166,168,170],{"class":131,"line":158},3,[129,160,161],{"class":135},"    \"",[129,163,165],{"class":164},"sBMFI","yunsell",[129,167,149],{"class":135},[129,169,152],{"class":135},[129,171,155],{"class":135},[129,173,175,178,182,184,186,189,193,195],{"class":131,"line":174},4,[129,176,177],{"class":135},"      \"",[129,179,181],{"class":180},"sbssI","url",[129,183,149],{"class":135},[129,185,152],{"class":135},[129,187,188],{"class":135}," \"",[129,190,192],{"class":191},"sfazB","https://www.yunsell.com/mcp",[129,194,149],{"class":135},[129,196,197],{"class":135},",\n",[129,199,201,203,206,208,210],{"class":131,"line":200},5,[129,202,177],{"class":135},[129,204,205],{"class":180},"headers",[129,207,149],{"class":135},[129,209,152],{"class":135},[129,211,155],{"class":135},[129,213,215,218,222,224,226,228,231],{"class":131,"line":214},6,[129,216,217],{"class":135},"        \"",[129,219,221],{"class":220},"swJcz","Authorization",[129,223,149],{"class":135},[129,225,152],{"class":135},[129,227,188],{"class":135},[129,229,230],{"class":191},"Bearer sk-xxx",[129,232,233],{"class":135},"\"\n",[129,235,237],{"class":131,"line":236},7,[129,238,239],{"class":135},"      }\n",[129,241,243],{"class":131,"line":242},8,[129,244,245],{"class":135},"    }\n",[129,247,249],{"class":131,"line":248},9,[129,250,251],{"class":135},"  }\n",[129,253,255],{"class":131,"line":254},10,[129,256,257],{"class":135},"}\n",[259,260,261,274],"table",{},[262,263,264],"thead",{},[265,266,267,271],"tr",{},[268,269,270],"th",{},"字段",[268,272,273],{},"说明",[275,276,277,290,302],"tbody",{},[265,278,279,285],{},[280,281,282],"td",{},[97,283,284],{},"mcpServers.yunsell",[280,286,287,288],{},"服务键名，建议使用 ",[97,289,165],{},[265,291,292,296],{},[280,293,294],{},[97,295,181],{},[280,297,298,299,301],{},"网关地址 + ",[97,300,106],{},"，须与 API Base URL 同源",[265,303,304,309],{},[280,305,306],{},[97,307,308],{},"headers.Authorization",[280,310,311,314],{},[97,312,313],{},"Bearer"," + 你的 API Key",[79,316,317,318,320],{},"将 ",[97,319,99],{}," 替换为你的 API Key。",[83,322],{},[86,324,325],{"id":325},"会话管理",[79,327,328],{},"MCP Streamable HTTP 使用会话机制：",[259,330,331,340],{},[262,332,333],{},[265,334,335,338],{},[268,336,337],{},"项",[268,339,273],{},[275,341,342,353,363],{},[265,343,344,347],{},[280,345,346],{},"首次请求",[280,348,349,350],{},"服务端在响应头返回 ",[97,351,352],{},"Mcp-Session-Id",[265,354,355,358],{},[280,356,357],{},"后续请求",[280,359,360,361],{},"客户端须在请求头携带同一 ",[97,362,352],{},[265,364,365,368],{},[280,366,367],{},"结束会话",[280,369,370],{},[97,371,372],{},"DELETE /mcp",[79,374,375],{},"客户端 SDK 通常会自动管理会话。",[83,377],{},[86,379,380],{"id":380},"鉴权说明",[382,383,384,393,396],"ul",{},[93,385,386,387,392],{},"鉴权方式与 ",[388,389,391],"a",{"href":390},"../api/conventions#%E9%89%B4%E6%9D%83","V1 API"," 完全一致",[93,394,395],{},"共享同一 API Key 的计费、限额、模型限制",[93,397,398,399,402,403,100],{},"管理员可在 Key 后追加 ",[97,400,401],{},"-{channelId}"," 指定渠道（如 ",[97,404,405],{},"sk-xxx-6",[79,407,408,409,412,413,416],{},"鉴权失败返回 HTTP ",[97,410,411],{},"401"," / ",[97,414,415],{},"403","。",[83,418],{},[86,420,421],{"id":421},"验证连接",[79,423,424],{},"配置完成后，通过 MCP 协议验证：",[90,426,427,442],{},[93,428,429,430,433,434,437,438,441],{},"调用 ",[97,431,432],{},"tools/list","，确认返回 ",[97,435,436],{},"list_models","、",[97,439,440],{},"generate_image"," 等 Tool",[93,443,429,444,446,447],{},[97,445,436],{},"，确认返回模型含 ",[97,448,449],{},"supported_endpoint_types",[79,451,452],{},"若 Tool 列表为空或缺少预期 Tool，检查：",[382,454,455,458,461],{},[93,456,457],{},"API Key 是否有效、余额是否充足",[93,459,460],{},"Token 是否限制了可用模型",[93,462,463,464],{},"模型是否支持对应 ",[97,465,449],{},[83,467],{},[86,469,470],{"id":470},"故障排查",[259,472,473,486],{},[262,474,475],{},[265,476,477,480,483],{},[268,478,479],{},"现象",[268,481,482],{},"可能原因",[268,484,485],{},"处理",[275,487,488,502,513,528,543],{},[265,489,490,493,496],{},[280,491,492],{},"连接失败",[280,494,495],{},"URL 错误或网关未启动",[280,497,498,499,501],{},"检查 Base URL 与 ",[97,500,106],{}," 可达性",[265,503,504,507,510],{},[280,505,506],{},"401 / 403",[280,508,509],{},"Key 无效或 IP 不在白名单",[280,511,512],{},"检查令牌设置",[265,514,515,518,521],{},[280,516,517],{},"Tool 列表缺少图像/视频",[280,519,520],{},"无对应模型权限",[280,522,429,523,525,526],{},[97,524,436],{}," 确认 ",[97,527,449],{},[265,529,530,533,536],{},[280,531,532],{},"视频一直 queued",[280,534,535],{},"上游排队",[280,537,538,539,542],{},"按 ",[97,540,541],{},"next_poll_after_sec"," 间隔轮询，避免频繁请求",[265,544,545,548,551],{},[280,546,547],{},"TTS 返回错误",[280,549,550],{},"voice 无效",[280,552,553,554,557,558],{},"先调用 ",[97,555,556],{},"list_audio_voices"," 获取正确 ",[97,559,97],{},[83,561],{},[86,563,564],{"id":564},"相关文档",[382,566,567],{},[93,568,569],{},[388,570,15],{"href":571},"../start/quick-start",[573,574,575],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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);}",{"title":125,"searchDepth":139,"depth":139,"links":577},[578,579,580,581,582,583,584],{"id":88,"depth":139,"text":88},{"id":115,"depth":139,"text":115},{"id":325,"depth":139,"text":325},{"id":380,"depth":139,"text":380},{"id":421,"depth":139,"text":421},{"id":470,"depth":139,"text":470},{"id":564,"depth":139,"text":564},"云擎数智 MCP 服务的连接方式与客户端配置","md",{},true,{"title":62,"description":585},"bAThhjhpnULM9DfJt1cYcZ0LfrVM7b14d7mS0Jh1mmw",[592,594],{"title":53,"path":54,"stem":55,"description":593,"children":-1},"文本转语音（TTS）与音色列表查询",{"title":66,"path":71,"stem":72,"description":595,"children":-1},"安装 yunsell-ai-skills 技能包，在 Agent 对话中调用多模态生成能力",1787808399477]