server_url и server_label
На тази страница
Обновено на 3 ноември 2026 г. въз основа на страницата Remote MCP Tools на xAI:
server_labelдобавя префикс към извикванията на инструменти, но документацията не уточнява точния формат на префикса; нотациятаlabel__tool, използвана в този курс, е конвенция за четене – проверете действителния формат във вашите API отговори. Източник: Remote MCP Tools.
Двата параметъра, без които не можете
Всяка връзка между Grok и отдалечен MCP сървър разчита на два параметъра: server_url и server_label. Те са задължителни – без тях API отхвърля заявката, преди да опита каквото и да е. Всички други параметри, които ще срещнете по-късно, усъвършенстват тази основа; те никога не я заместват.
server_url: Точният адрес на крайната точка
Параметърът server_url съдържа пълния URL адрес на MCP сървъра, към който Grok трябва да се свърже, и този URL следва строги правила.
Първото правило е HTTPS. URL адресът трябва да започва с https://, а xAI отхвърля всяка некриптирана HTTP връзка. Причината е проста: обменът между Grok и MCP сървъра носи заявките на вашите потребители, резултатите от инструментите и понякога самия токен за удостоверяване. Позволяването на тези данни да циркулират в чист текст би било недопустимо.
# Правилно
mcp(server_url="https://mcp.deepwiki.com/mcp")
# Отхвърлено от API
mcp(server_url="http://mcp.deepwiki.com/mcp")
Второто правило се отнася до точността на пътя. URL адресът трябва да сочи директно към MCP крайната точка, а не към корена на домейна. Почти всички сървъри излагат своята крайна точка на специализиран път и конвенцията варира от един сървър до друг. Ето три валидни форми, които ще срещнете:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Третото правило следва от първите две: localhost и частните IP адреси са изключени. Сървърът трябва да бъде достъпен от инфраструктурата на xAI, на публичен домейн, с валиден SSL сертификат. Това повдига конкретен въпрос по време на разработката, тъй като MCP сървърът, който пишете, работи на вашата машина. Обичайното решение е използването на тунел – например ngrok или Cloudflare Tunnel – който излага вашата локална инстанция зад публичен HTTPS URL за продължителността на вашите тестове.
server_label: Идентичността на сървъра в разговора
server_label е кратък идентификатор, който Grok използва за добавяне на префикс към извикванията на инструменти от този сървър. Неговата роля е двойна: да направи следите четими и да премахне всякаква двусмислица, когато съществуват множество сървъри едновременно.
Документацията на xAI посочва, че етикетът добавя префикс към извикванията на инструменти от този сървър, без да уточнява точния формат на префикса. В този курс обозначаваме инструмента search_docs от сървъра deepwiki като deepwiki__search_docs заради четимостта: проверете действителния формат в API отговорите, преди да изградите логика върху него.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Извикванията на инструменти от този сървър ще имат префикс "deepwiki"
Три критерия ръководят избора на добър етикет. Той трябва да бъде кратък, тъй като се добавя към името на всяко извикване и един многословен етикет ненужно уголемява вашите логове. Трябва да бъде описателен, така че източникът на извикването да се чете с един поглед, без да се консултира конфигурацията. Трябва да бъде уникален във вашата конфигурация, в противен случай няма да можете да разграничите два сървъра. Примерите по-долу отговарят на тези три изисквания:
server_label="deepwiki" # Документация на GitHub
server_label="crm" # Система за управление на клиенти
server_label="jira" # Проследяване на билети
server_label="search" # Вътрешна търсачка
Това става много по-осезаемо, щом свържете множество сървъри към една и съща сесия. Да предположим, че вашата вътрешна документация и DeepWiki излагат инструмент, наречен search. Без различни етикети, имената на инструментите се сблъскват и Grok няма начин да разбере кой да целеви. С етикети двата инструмента получават различни префикси – тук обозначени като deepwiki__search и internal-docs__search – и объркването изчезва. Ще разгледате отново тази точка в урока, посветен на множество сървъри.
Минимална конфигурация в двата SDK
Заедно тези два параметъра са достатъчни, за да накарат един публичен MCP сървър да работи. С родния xAI SDK:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
И точният еквивалент с Responses API във формат на OpenAI:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Ключови изводи
server_urlиserver_labelса единствените два задължителни параметъра- URL адресът трябва да бъде HTTPS с валиден SSL сертификат, без localhost
- Етикетът добавя префикс към всички извиквания на инструменти от този сървър (точният формат не е документиран; този курс го бележи като
label__tool) - Избирайте етикети, които са кратки, описателни и уникални за всеки сървър
- Етикетът е съществен при работа с множество сървъри, за да се избегнат конфликти на имена