Qwen API を使用して MCP に接続する方法 - Alibaba Cloud Model Studio

モデルコンテキストプロトコル (MCP) は、大規模言語モデルが外部のツールやデータを使用できるようにします。このトピックでは、Responses API を使用して MCP に接続する方法について説明します。

使用法

Responses API を使用する際に、 tools パラメーターに MCP サーバーの情報を追加します。

ModelScope などのプラットフォームから、MCP サービスのサーバー送信イベント (SSE) エンドポイントと認証情報を取得します。

SSE プロトコルを使用する MCP サーバーをサポートしています。

最大 10 個の MCP サーバーをサポートします。

# 依存関係をインポートし、クライアントを作成します...
mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "my-mcp-service",
    "server_description": "モデルがユースケースを理解するのに役立つ、MCPサーバーの機能に関する説明。",
    "server_url": "https://your-mcp-server-endpoint/sse",
    "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
    }
}

response = client.responses.create(
    model="qwen3.8-max",
    input="Your question...",
    tools=[mcp_tool]
)

print(response.output_text)

サポートされているモデル

Qwen-Max： Qwen3.8-Max シリーズ、Qwen3.7-Max シリーズ
Qwen-Plus： Qwen3.7-Plus シリーズ、Qwen3.6-Plus シリーズ、Qwen3.5-Plus シリーズ
Qwen-Flash： Qwen3.7-Flash シリーズ、Qwen3.6-Flash シリーズ、Qwen3.5-Flash シリーズ
Qwen3.8 オープンソースシリーズ
Qwen3.6 オープンソースシリーズ (qwen3.6-27b を除く)
Qwen3.5 オープンソースシリーズ

Responses API でのみ利用可能です。

クイックスタート

この例では、 ModelScope の Fetch Web スクレイピング MCP サービスを使用します。右側のサービス設定セクションから、サービスの SSE エンドポイントと認証情報を取得できます。

API キーを取得し、環境変数として設定してください。

server_url を MCP サービスプラットフォームの SSE エンドポイントに置き換えてください。 headers の認証情報を、そのプラットフォームから提供されたトークンに置き換えてください。

python

import os
from openai import OpenAI

client = OpenAI(
    # 環境変数がない場合は、api_key="sk-xxx" を使用します (非推奨)。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

# MCP ツール設定
# server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
# 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "fetch",
    "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
    "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse",
}

response = client.responses.create(
    model="qwen3.8-max",
    input="https://news.aibase.com/news, what is the AI news today?",
    tools=[mcp_tool]
)

print("[Model Response]")
print(response.output_text)
print(f"\n[Token Usage] Input: {response.usage.input_tokens}, Output: {response.usage.output_tokens}, Total: {response.usage.total_tokens}")

javascript

import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // 環境変数がない場合は、apiKey: "sk-xxx" を使用します (非推奨)。
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    // MCP ツール設定
    // server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
    // 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
    const mcpTool = {
        type: "mcp",
        server_protocol: "sse",
        server_label: "fetch",
        "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
        server_url: "https://mcp.api-inference.modelscope.net/xxx/sse",
    };

    const response = await openai.responses.create({
        model: "qwen3.8-max",
        input: "https://news.aibase.com/news, what is the AI news today?",
        tools: [mcpTool]
    });

    console.log("[Model Response]");
    console.log(response.output_text);
    console.log(`\n[Token Usage] Input: ${response.usage.input_tokens}, Output: ${response.usage.output_tokens}, Total: ${response.usage.total_tokens}`);
}

main();

bash

# server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
# 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
# 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.8-max",
    "input": "https://news.aibase.com/news, what is the AI news today?",
    "tools": [
        {
            "type": "mcp",
            "server_protocol": "sse",
            "server_label": "fetch",
            "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
            "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse"
        }
    ]
}'

コードを実行すると、次の応答が返されます。

[モデル応答]
Alibaba Cloud Model Studio のヘルプセンターにあるモデルコンテキストプロトコル (MCP) のドキュメントによると、サポートされているモデルは次のとおりです。

*   Qwen-Max：
    *   Qwen3.8-Max シリーズ
    *   Qwen3.7-Max シリーズ
*   Qwen-Plus：
    *   Qwen3.7-Plus シリーズ
    *   Qwen3.6-Plus シリーズ
    *   Qwen3.5-Plus シリーズ
*   Qwen-Flash：
    *   Qwen3.7-Flash シリーズ
    *   Qwen3.6-Flash シリーズ
    *   Qwen3.5-Flash シリーズ
*   Qwen3.8 オープンソースシリーズ
*   Qwen3.6 オープンソースシリーズ (qwen3.6-27b を除く)
*   Qwen3.5 オープンソースシリーズ

注：ドキュメントには、MCP は標準の Chat Completions API ではなく、Responses API (client.responses.create) 経由でのみサポートされると記載されています。

[トークン使用量] 入力： 20583、出力： 1638、合計： 22221

ストリーミング出力

MCP ツールの呼び出しには、外部サービスとの複数のインタラクションが含まれる場合があります。リアルタイムの中間結果を得るには、ストリーミングを有効にしてください。

python

import os
from openai import OpenAI

client = OpenAI(
    # 環境変数がない場合は、api_key="sk-xxx" を使用します (非推奨)。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

# server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
# 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
mcp_tool = {
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "fetch",
    "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
    "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse",
}

stream = client.responses.create(
    model="qwen3.8-max",
    input="https://news.aibase.com/news, what is the AI news today?",
    tools=[mcp_tool],
    stream=True
)

for event in stream:
    # モデルの応答が開始されます
    if event.type == "response.content_part.added":
        print("[Model Response]")
    # テキスト出力のストリーミング
    elif event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    # 応答が完了し、使用量を出力します
    elif event.type == "response.completed":
        usage = event.response.usage
        print(f"\n\n[Token Usage] Input: {usage.input_tokens}, Output: {usage.output_tokens}, Total: {usage.total_tokens}")

javascript

import OpenAI from "openai";
import process from 'process';

const openai = new OpenAI({
    // 環境変数がない場合は、apiKey: "sk-xxx" を使用します (非推奨)。
    apiKey: process.env.DASHSCOPE_API_KEY,
    // 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
});

async function main() {
    // server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
    // 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
    const mcpTool = {
        type: "mcp",
        server_protocol: "sse",
        "server_label": "fetch",
        "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
        "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse",
    };

    const stream = await openai.responses.create({
        model: "qwen3.8-max",
        input: "https://news.aibase.com/news, what is the AI news today?",
        tools: [mcpTool],
        stream: true
    });

    for await (const event of stream) {
        // モデルの応答が開始されます
        if (event.type === "response.content_part.added") {
            console.log("[Model Response]");
        }
        // テキスト出力のストリーミング
        else if (event.type === "response.output_text.delta") {
            process.stdout.write(event.delta);
        }
        // 応答が完了し、使用量を出力します
        else if (event.type === "response.completed") {
            const usage = event.response.usage;
            console.log(`\n\n[Token Usage] Input: ${usage.input_tokens}, Output: ${usage.output_tokens}, Total: ${usage.total_tokens}`);
        }
    }
}

main();

bash

# server_url を ModelScope などのプラットフォームから取得した SSE エンドポイントに置き換えてください。
# 認証が必要な場合は、対応するプラットフォームのトークンをヘッダーに追加してください。
# 次の URL はシンガポールリージョン用です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/responses \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.8-max",
    "input": "https://news.aibase.com/news, what is the AI news today?",
    "tools": [
        {
            "type": "mcp",
            "server_protocol": "sse",
            "server_label": "fetch",
            "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
            "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse"
        }
    ],
    "stream": true
}'

コードを実行すると、次の応答が返されます。

[モデル応答]
Alibaba Cloud Model Studio の MCP ドキュメントページによると、サポートされているモデルは次のとおりです。

*   Qwen-Max シリーズ： Qwen3.8-Max シリーズ、Qwen3.7-Max シリーズ
*   Qwen-Plus シリーズ： Qwen3.7-Plus シリーズ、Qwen3.6-Plus シリーズ、Qwen3.5-Plus シリーズ
*   Qwen-Flash シリーズ： Qwen3.7-Flash シリーズ、Qwen3.6-Flash シリーズ、Qwen3.5-Flash シリーズ
*   Qwen3.8 オープンソースシリーズ
*   Qwen3.6 オープンソースシリーズ (qwen3.6-27b を除く)
*   Qwen3.5 オープンソースシリーズ

注：これらのモデルは、Responses API 経由でのみ MCP 機能をサポートします。

[トークン使用量] 入力： 20472、出力： 945、合計： 21417

パラメーター

mcp ツールは、次のパラメーターをサポートしています。

パラメーター	必須	説明
`type`	はい	`"mcp"` に設定します。
`server_protocol`	はい	MCP サーバーとの通信プロトコル。現在、 `"sse"` のみがサポートされています。
`server_label`	はい	MCP サーバーのラベル名。サービスを識別するために使用されます。
`server_description`	いいえ	MCP サーバーの機能に関する説明。モデルがサービスの機能とシナリオを理解するのに役立ちます。モデル呼び出しの精度を向上させるため、このパラメーターを設定することを推奨します。
`server_url`	はい	MCP サーバーのエンドポイント URL。
`headers`	いいえ	MCP サーバーに接続する際に含めるリクエストヘッダー。 `Authorization` などの認証情報を含みます。

例：

{
    "type": "mcp",
    "server_protocol": "sse",
    "server_label": "fetch",
    "server_description": "Web スクレイピング機能を提供する Fetch MCP サーバー。指定された URL のコンテンツをスクレイピングし、テキストとして返すことができます。",
    "server_url": "https://mcp.api-inference.modelscope.net/xxx/sse"
}

課金

課金には以下が含まれます。

モデル推論料金： モデルのトークン使用量に基づいて課金されます。
MCP サーバー料金： 各 MCP サーバーの課金ルールに従います。