Autenticación y cabeceras
En esta página
Demuestra quién llama
DeepWiki y otros servidores MCP públicos aceptan cualquier llamante, lo cual es coherente con su propósito. En cuanto expones tus propias herramientas, la situación cambia: sin autenticación, cualquiera que adivine la URL podrá consultar tu CRM o activar tus procesos. xAI proporciona dos parámetros para abordar esto: authorization para el token de acceso, y headers o extra_headers para todo lo demás.
El parámetro authorization
Envía un token de autenticación al servidor MCP. Concretamente, la cadena que proporcionas se coloca tal cual en la cabecera HTTP Authorization de cada solicitud enviada a ese servidor.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
El formato esperado depende enteramente del servidor de destino, ya que authorization acepta cualquier cadena: quien valida es el servidor MCP, no xAI. Tres formas cubren casi todos los casos que encontrarás.
- Token Bearer:
"Bearer sk-xxxx"— el más común, utilizado por la mayoría de las API REST - Clave de API:
"ApiKey your-key"— algunos servicios usan un prefijo personalizado - Auth básica:
"Basic base64(user:password)"— autenticación básica codificada en base64
Dado que este token viaja en cada solicitud, su manejo requiere cuidado. Nunca lo hardcodees en tu código fuente: un secreto escrito en un archivo versionado acaba tarde o temprano en un repositorio, un registro o una captura de pantalla. Usa siempre una variable de entorno. Si el servidor lo permite, prefiere un token con ámbito limitado que solo abra las herramientas que realmente necesitas; esta es la contrapartida del lado del servidor a la restricción allowed_tool_names. Y planifica una rotación regular, especialmente en producción, donde un token eterno es un token que acabará filtrándose.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers y extra_headers
El token responde a la pregunta «¿quién eres?». Muchos servidores necesitan respuestas adicionales: para qué organización, en qué entorno, con qué versión de la API. Esta información se transmite mediante el parámetro headers, o extra_headers dependiendo del 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"
}
)
El caso más frecuente son las plataformas multiinquilino, donde el mismo punto de conexión sirve a múltiples clientes y depende de una cabecera para enrutar la solicitud hacia los datos correctos. Le sigue el versionado de la API, con una cabecera como "X-API-Version": "2024-01" que fija una versión concreta y te protege de cambios en el servidor. Algunos sistemas también esperan metadatos de seguimiento —ID de sesión, ID de agente— para rastrear el origen de las llamadas, o cabeceras de limitación de tasa que determinan el plan de facturación aplicado.
El nombre del parámetro varía según la interfaz que utilices. El SDK nativo de xAI usa headers en la mayoría de los casos; la API de Respuestas con formato OpenAI puede requerir extra_headers, para evitar cualquier colisión con cabeceras que este SDK gestiona automáticamente por su cuenta. El comportamiento, sin embargo, es exactamente el mismo: las cabeceras se añaden a cada solicitud al servidor MCP. Si tus solicitudes salen sin tus cabeceras, comprueba primero este nombre de parámetro antes de buscar en otro sitio.
Una configuración completa para producción
Así es como se ensamblan estos parámetros con los de lecciones anteriores, en un caso realista de servidor interno.
from xai_sdk.tools import mcp
import os
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="internal",
server_description="Herramientas internas: CRM, documentación, 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"]
)
]
Esta configuración se conecta al servidor MCP interno mediante HTTPS, se autentica con un token Bearer almacenado en una variable de entorno, envía el ID de la organización en una cabecera y restringe el acceso a tres operaciones de solo lectura. Ten en cuenta que cada línea bloquea un aspecto diferente: el cifrado protege el transporte, el token prueba la identidad, la cabecera define el alcance de los datos y la lista de permitidos limita el daño potencial. Ninguna de estas capas sustituye a las demás.
Puntos clave
authorizationenvía el token de acceso al servidor MCP a través de la cabecera HTTP Authorization- Guarda siempre tus tokens en variables de entorno, nunca hardcodeados en el código
headers/extra_headersañaden cabeceras HTTP adicionales a cada solicitud- Las cabeceras sirven para identificación multiinquilino, versionado de API y seguimiento
- Combina autenticación y restricción de herramientas para máxima seguridad