外部调用

集成至第三方应用

阿里云百炼支持配置 MCP 服务至 Cherry Studio 和 Cursor，支持自动配置和手动配置。以 Amap Maps 服务为例。

通过 SDK 进行开发集成

通过 MCP SDK 调用阿里云百炼 MCP 服务，编码更加灵活。

以下示例使用 OpenAI SDK 与 MCP SDK 调用百炼联网搜索（WebSearch）MCP 服务，实现联网搜索。

1. 安装依赖。

   pip install openai mcp

2. 配置百炼 API Key 到环境变量 。

3. 代码示例如下：

   Python

   # -*- coding: utf-8 -*-
   # 使用 OpenAI SDK + MCP SDK 调用百炼联网搜索（WebSearch）MCP 服务
   import os
   import asyncio
   import json
   from openai import OpenAI
   from mcp.client.streamable_http import streamablehttp_client
   from mcp import ClientSession
   
   async def main():
       api_key = os.getenv("DASHSCOPE_API_KEY")
       if not api_key:
           print("错误：请设置环境变量 DASHSCOPE_API_KEY")
           return
       mcp_url = "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp"
       headers = {"Authorization": f"Bearer {api_key}"}
       # 1. 连接 MCP Server，获取可用工具列表
       async with streamablehttp_client(mcp_url, headers=headers) as (read, write, _):
           async with ClientSession(read, write) as session:
               await session.initialize()
               tools_result = await session.list_tools()
               # 转换为 OpenAI function calling 格式
               openai_tools = []
               for tool in tools_result.tools:
                   openai_tools.append({
                       "type": "function",
                       "function": {
                           "name": tool.name,
                           "description": tool.description or "",
                           "parameters": tool.inputSchema or {"type": "object", "properties": {}},
                       },
                   })
               # 2. 调用 DashScope（OpenAI 兼容接口）
               client = OpenAI(
                   api_key=api_key,
                   base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
               )
               messages = [{"role": "user", "content": "搜索一下阿里云百炼MCP的最新进展"}]
               print("正在联网搜索...")
               print("=" * 50)
               # 3. 多轮工具调用循环
               while True:
                   response = client.chat.completions.create(
                       model="qwen-max",
                       messages=messages,
                       tools=openai_tools or None,
                   )
                   choice = response.choices[0]
                   msg = choice.message
                   if not msg.tool_calls:
                       print(msg.content)
                       break
                   messages.append(msg)
                   for tc in msg.tool_calls:
                       args = json.loads(tc.function.arguments)
                       result = await session.call_tool(tc.function.name, args)
                       tool_content = ""
                       for block in result.content:
                           if hasattr(block, "text"):
                               tool_content += block.text
                       messages.append({
                           "role": "tool",
                           "tool_call_id": tc.id,
                           "content": tool_content,
                       })
   
   if __name__ == "__main__":
       asyncio.run(main())

4. 运行代码，结果如下：

   正在联网搜索...
   ==================================================
   阿里云百炼 MCP（Model Context Protocol）是一项新推出的服务，允许用户在百炼平台上统一接入和管理 MCP 服务。最新进展包括：
   1. 支持通过 MCP 广场一键开通多种 MCP 服务（如 Amap Maps、联网搜索等）。
   2. 提供 Streamable HTTP 协议，支持外部应用通过标准 HTTP 调用。
   3. 已与 Cherry Studio、Cursor 等主流工具集成，支持自动配置。
   4. 开发者可通过 MCP SDK 灵活编码集成至自有项目。

无法连接 MCP 服务怎么办？

1. 未开通或者未升级 MCP 服务：请确认已在百炼 MCP 广场开通或升级 MCP 服务，详情参见开通 MCP 服务。

2. API Key 错误：请确认使用了有效的百炼通用 API Key。

3. 额度用尽：部分 MCP （如联网搜索）存在每月额度限制，额度用尽后自动停止。

其他报错及常见问题请参考常见问题。

模型正常对话且 MCP 无报错，但无法成功地调用 MCP 怎么办？

大模型需要明确的指令才能准确地调用 MCP 服务。请在提示词中明确工具名称和工具能力。示例：调用阿里云百炼 Amap Maps MCP 服务，规划从杭州到上海的自驾路线。