Пълна конфигурация на MCP сървър
На тази страница
Събиране на всичко в едно
Вече разгледахте всеки параметър поотделно. В този урок ще ги обединим в пълни конфигурации, точно както ще ги пишете на практика, като всеки път ще покажем еквивалента и в двата основни SDK. Целта не е да въвеждаме нови концепции, а да Ви предоставим шаблони, които можете да адаптирате директно.
Ето преглед на шестте параметъра с тяхното задължително или незадължително състояние.
| Параметър | Задължителен | Роля |
|---|---|---|
server_url | Да | HTTPS URL адрес на MCP сървъра |
server_label | Да | Префикс за извикване на инструментите |
server_description | Не | Насочва Grok при избора на сървър |
allowed_tool_names | Не | Ограничава достъпните инструменти |
authorization | Не | Токен за удостоверяване |
headers | Не | Допълнителни HTTP заглавки |
Най-простият случай
Два параметъра са достатъчни, когато сървърът е публичен и не изисква удостоверяване.
# xAI SDK
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"
}]
Точно това ще напишете за DeepWiki. Grok получава достъп до всички инструменти на сървъра, което тук е приемливо, тъй като става въпрос за публична услуга само за четене. Веднага щом сървърът принадлежи на Вашата организация, тази конфигурация става недостатъчна.
Вътрешен сървър само за четене
Нека направим следващата стъпка: корпоративна CRM система, към която агентът трябва да може да прави заявки, но никога да я модифицира. Добавят се три параметъра, всеки с различна цел – описанието насочва модела, токенът доказва самоличността, а списъкът с позволени инструменти забранява записването.
# xAI SDK
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="crm",
server_description="Internal CRM. Contact and company lookup only.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["search_contacts", "get_contact", "list_companies"]
)
]
# Responses API (OpenAI)
tools = [{
"type": "mcp",
"server_url": "https://api.monentreprise.com/mcp",
"server_label": "crm",
"server_description": "Internal CRM. Contact and company lookup only.",
"authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
"allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]
Сравнете двата блока: съдържанието е идентично; променя се само обвивката. Помощната функция mcp() приема именувани аргументи, докато форматът на OpenAI очаква речник с допълнителен ключ "type". Това е единствената разлика, която трябва да запомните, когато превеждате конфигурация от единия SDK в другия.
Изчерпателна конфигурация
Последна стъпка, комбинираща и шестте параметъра в реално извикване към xAI SDK.
import os
from xai_sdk import Client
from xai_sdk.tools import mcp
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://tools.monentreprise.com/v1/mcp",
server_label="outils-internes",
server_description="Internal tools platform: document management, support tickets, knowledge base. Read-only access.",
authorization=f"Bearer {os.getenv('TOOLS_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production",
"X-Request-Source": "grok-agent"
},
allowed_tool_names=[
"search_documents",
"get_document",
"search_tickets",
"get_ticket",
"search_knowledge_base"
]
)
],
include=["verbose_streaming"],
)
Обърнете внимание на вътрешната последователност на този пример. Описанието обявява достъп само за четене, а петте позволени инструменти са изцяло операции за заявка – няма противоречие между това, което моделът смята, че може да направи, и това, което конфигурацията позволява. Заглавката X-Environment, зададена на production, предотвратява записването на тестов агент в реални данни, а X-Request-Source ще направи следите от Вашия сървър полезни за действие, ако се наложи да проследите произхода на неочаквана заявка.
Проверка преди внедряване
Шест точки изискват преглед преди всяко внедряване в продукционна среда и всяка от тях съответства на капан, срещнат по-рано в този курс. URL адресът трябва да бъде HTTPS с валиден сертификат, в противен случай нищо няма да премине. Етикетът трябва да остане кратък, описателен и уникален в рамките на конфигурацията. Описанието трябва да съвпада с действително изложените инструменти, в противен случай моделът ще се опита да извика действия, обречени на провал. Позволените инструменти трябва да бъдат сведени до строгия минимум. Токенът трябва да идва от променлива на средата, а не от изходния код. И допълнителните заглавки трябва да бъдат точно това, което Вашият сървър очаква, с правилния регистър на буквите – грешка в регистра на X-Organization-Id води до тих срив, който е особено болезнен за диагностициране.
Ключови изводи
- Минималната конфигурация изисква само
server_urlиserver_label - Добавете
server_description, за да насочите Grok, особено при настройки с множество сървъри - Ограничете достъпа с
allowed_tool_namesзаради сигурност и производителност - Използвайте
authorizationиheadersза удостоверяване - И двата SDK (роден xAI и OpenAI Responses) приемат едни и същи параметри с различен синтаксис