外部调用

• 集成至第三方应用：支持一键自动配置到第三方应用，快速实现外部调用。
• 集成至个人项目：通过 MCP SDK 调用，实现灵活编码和深度定制。

​

开通 MCP 服务

​

外部调用 MCP 服务

​

集成至第三方应用

​

通过 SDK 进行开发集成

1. 安装依赖。

pip install openai mcp

2. 配置百炼 API Key 到环境变量。
3. 代码示例如下：
   • Python

   Copy

   # -*- 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 怎么办？