AI 大模型推理

    • AI 大模型推理 > 使用文档 > MCP 使用说明

    MCP 使用说明

    最近更新时间: 2025-06-20 11:00:09

    前言

    本说明文档旨在帮助用户快速了解并高效使用 MCP 接入服务。MCP（模型上下文协议）接入服务是为各类大模型推理服务提供统一、安全、标准化接入与编排的中间层。关于 MCP 协议本身，请参见《什么是 MCP》文档。

    产品简介

    MCP 接入服务是七牛云 AI 推出的统一模型能力接入与编排平台。它为企业和开发者提供标准协议转换、安全密钥托管、服务聚合、统一管理等能力，帮助用户高效、安全地对接和管理各类 MCP 服务。

    适用场景

    • 需要安全托管 API Key、密钥等敏感信息，避免在终端暴露
    • 需要将不同协议、不同来源的模型能力统一接入和管理
    • 需要通过标准协议（如 OPENAI、SSE、HTTP-Streamable）对接第三方工具或自有系统
    • 需要灵活编排、聚合多种模型能力，提升服务扩展性

    接入方式总览

    MCP 支持多种标准协议接入，满足不同业务和系统集成需求：

    OPENAI 协议接入

    • 地址格式：
      https://api.qnaigc.com/v1/mcp/openai/${mcp-id}
    • 适用场景：无需本地部署，直接通过 OPENAI 协议调用 MCP 接入服务，内置 MCP client

    标准 MCP 协议接入

    • SSE 协议：
      https://api.qnaigc.com/v1/mcp/sse/${mcp-id}
    • HTTP-Streamable 协议：
      https://api.qnaigc.com/v1/mcp/http-streamable/${mcp-id}
    • 适用场景：与本地 MCP 服务更灵活的搭配使用

    多 MCP 服务聚合调用

    • 支持在 BaseUrl 中拼接多个 MCP-ID，实现一次聚合多个服务：
      https://api.qnaigc.com/v1/mcp/openai/${mcp-id-1},${mcp-id-2},${mcp-id-3}

    核心优势

    • 协议标准化：支持 OPENAI、SSE、HTTP-Streamable 等主流协议，屏蔽底层差异
    • 安全托管：API Key、密钥等敏感信息云端托管，终端无需暴露
    • 灵活聚合：支持多服务聚合调用，能力自由组合
    • 统一管理：可视化控制台统一管理所有接入服务

    主要功能

    • MCP 服务接入与协议转换
    • 安全密钥托管与权限管理
    • 支持标准协议（OPENAI、SSE、HTTP-Streamable）对接
    • 多服务聚合与编排
    • 可视化服务管理

    详细配置与使用示例

    控制台配置 MCP 接入服务

    • 登录七牛云 AI 控制台，进入 MCP 服务管理页面
    • 新建或管理已有的 MCP 服务，获取专属的 MCP-ID

    获取接入地址

    • 控制台会为每个 MCP 接入服务生成专属的接入地址，支持多种协议

    OPENAI 协议详细示例

    以 curl 为例：

    export OPENAI_BASE_URL="https://api.qnaigc.com/v1/mcp/openai/${mcp-id}"
export OPENAI_API_KEY="<七牛云 AI API KEY>"

curl "$OPENAI_BASE_URL/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "messages": [{"role": "user", "content": "请调用你支持的三个 MCP 能力，并列举全部能力"}],
        "model": "deepseek-v3-tool"
    }'

    注意事项

    • OPENAI 协议下无需本地安装任何 MCP 组件，直接调用即可
    • API Key 请妥善保管，避免泄露
    • MCP 接入服务本身不直接提供大模型能力，而是作为能力编排与接入中间层

    MCP 标准协议接入服务

    我们支持标准的 MCP 协议类型，选择对应的 MCP 协议地址配置到 MCP 客户端上即可，这里我们以 Node 的官方 SDK 中使用 HTTPStreamable 为例子：

    import { Client } from "@modelcontextprotocol/sdk/client/index"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp"

const serverUrl = '你的 MCP 服务 Url '
const apiKey = '你的七牛云 AI 推理 API Key'

const client = new Client({
  name: 'qiniu-sse-test-client',
  version: '1.0.0'
})

// 这里设置你的七牛云 api key 和 StreamableHTTP 连接地址
const transport = new StreamableHTTPClientTransport(new URL(serverUrl), {
  requestInit: { headers: { 'Authorization': `Bearer ${apiKey}` } }
})

async function main() {
  // 开始连接
  await client.connect(transport)

  // 列举 MCP 工具
  const tools = await client.listTools()

  // 查看支持的工具
  console.log(tools)
}

main()
  .then(() => { console.log('Client connected successfully') })
  .catch((error) => { console.error('Error connecting client:', error) })

    常见问题

    1. 如何获取 MCP-ID？
      • 登录控制台，在 MCP 接入服务详情页可查看和复制
    2. OPENAI 协议和标准 MCP 协议有何区别？
      • OPENAI 协议适合无需本地部署、直接云端调用场景；标准协议适合与本地服务深度集成
    3. API Key 泄露怎么办？
      • 立即在控制台重置 API Key，并排查相关调用记录
    4. MCP 接入服务能否直接提供大模型能力？
      • 不能，MCP 接入服务仅作为能力编排与接入中间层，实际模型能力由后端服务提供

    联系我们

    如有更多问题或建议，请联系七牛云 AI 技术支持。

    以上内容是否对您有帮助？
    • Close