Премини към основното съдържание
Български— Изберете език
Меню

Пълна конфигурация на MCP сървър

Урок 7 от 12 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Събиране на всичко в едно
  2. Най-простият случай
  3. Вътрешен сървър само за четене
  4. Изчерпателна конфигурация
  5. Проверка преди внедряване
  6. Ключови изводи

Събиране на всичко в едно

Вече разгледахте всеки параметър поотделно. В този урок ще ги обединим в пълни конфигурации, точно както ще ги пишете на практика, като всеки път ще покажем еквивалента и в двата основни 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) приемат едни и същи параметри с различен синтаксис