Удостоверяване и заглавки
На тази страница
Докажете кой извършва повикването
DeepWiki и други публични MCP сървъри приемат всеки caller, което отговаря на тяхното предназначение. Щом обаче изложите собствените си инструменти, нещата се променят: без удостоверяване всеки, който познае URL адреса, може да заявява Вашата CRM система или да задейства Вашите процеси. xAI предоставя два параметъра за решаване на този проблем – authorization за токена за достъп и headers или extra_headers за всичко останало.
Параметърът authorization
Той изпраща токен за удостоверяване до MCP сървъра. Конкретно, низът, който предоставите, се поставя както е в HTTP заглавката Authorization на всяка заявка, изпратена до този сървър.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Очакваният формат зависи изцяло от целевия сървър, тъй като authorization приема всеки низ: MCP сървърът го валидира, а не xAI. Три форми покриват почти всички случаи, с които ще се сблъскате.
- Bearer токен:
"Bearer sk-xxxx"– най-често срещаният, използван от мнозинството REST API - API ключ:
"ApiKey your-key"– някои услуги използват собствен префикс - Basic auth:
"Basic base64(user:password)"– основно удостоверяване, кодирано в base64
Тъй като този токен придружава всяка заявка, боравенето с него изисква внимание. Никога не го вграждайте директно в изходния си код: тайна, записана във версиониран файл, рано или късно ще се озове в хранилище, дневник или екранна снимка. Винаги използвайте променлива на средата. Ако сървърът позволява, предпочитайте токен с ограничен обхват, който отваря само инструментите, от които действително се нуждаете – това е съответстващата мярка от страна на сървъра на ограничението allowed_tool_names. И планирайте редовна ротация, особено в производствена среда, където вечният токен е токен, който рано или късно ще изтече.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers и extra_headers
Токенът отговаря на въпроса „кой сте Вие“. Много сървъри се нуждаят от допълнителни отговори: за коя организация, в коя среда, с коя версия на API. Тази информация се предава чрез параметъра headers или extra_headers, в зависимост от SDK.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-token",
headers={
"X-Organization-Id": "org-123",
"X-Project-Id": "proj-456"
}
)
Най-честият случай са мултитенант платформи, където един и същ крайна точка обслужва множество клиенти и разчита на заглавка, за да насочи заявката към правилните данни. Следва версионирането на API, със заглавка като "X-API-Version": "2024-01", която фиксира конкретна версия и Ви предпазва от промени в сървъра. Някои системи очакват и метаданни за проследяване – ID на сесия, ID на агент – за да се проследи произходът на повикванията, или заглавки за ограничаване на честотата, които определят приложения тарифен план.
Името на параметъра варира в зависимост от интерфейса, който използвате. Нативният xAI SDK използва headers в повечето случаи; Responses API във формат на OpenAI може да изисква extra_headers, за да се избегне всякакъв конфликт със заглавки, които този SDK управлява автоматично за себе си. Поведението обаче е точно същото: заглавките се добавят към всяка заявка към MCP сървъра. Ако Вашите заявки излизат без Вашите заглавки, проверете първо името на този параметър, преди да търсите другаде.
Пълна производствена конфигурация
Ето как тези параметри се комбинират с тези от предишните уроци в реалистичен случай на вътрешен сървър.
from xai_sdk.tools import mcp
import os
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="internal",
server_description="Internal tools: CRM, documentation, tickets",
authorization=f"Bearer {os.getenv('INTERNAL_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production"
},
allowed_tool_names=["search_docs", "get_ticket", "search_contacts"]
)
]
Тази конфигурация се свързва с вътрешния MCP сървър чрез HTTPS, удостоверява се с Bearer токен, съхраняван в променлива на средата, изпраща ID на организацията в заглавка и ограничава достъпа до три операции за четене. Имайте предвид, че всеки ред заключва различен аспект: криптирането защитава транспорта, токенът доказва самоличността, заглавката дефинира обхвата на данните, а списъкът с позволени ограничава потенциалните щети. Нито един от тези слоеве не замества другите.
Ключови изводи
authorizationизпраща токена за достъп до MCP сървъра чрез HTTP заглавката Authorization- Винаги съхранявайте токените си в променливи на средата, никога вградени в кода
headers/extra_headersдобавят допълнителни HTTP заглавки към всяка заявка- Заглавките служат за идентификация при мултитенантност, версиониране на API и проследяване
- Комбинирайте удостоверяването и ограничаването на инструментите за максимална сигурност