Seguridad y buenas prácticas
En esta página
Qué implica conectar un servidor
Conectar Grok a servidores MCP remotos otorga al modelo la capacidad de actuar sobre tus sistemas. Este poder conlleva riesgos, y lecciones anteriores ya presentaron los parámetros que lo controlan. Ha llegado el momento de organizarlos en una postura de seguridad coherente para su despliegue en producción.
HTTPS y autenticación: la base innegociable
La regla es sencilla: todo servidor MCP en producción debe utilizar HTTPS y exigir autenticación. xAI ya impone el primer punto y rechaza cualquier URL HTTP sin cifrar. El segundo, sin embargo, depende enteramente de ti, y es ahí donde se cuelan los errores.
Un servidor sin autenticación es accesible para cualquiera que conozca la URL. Esto significa que cualquier persona puede invocar tus herramientas internas, tus datos circulan sin control de acceso y no tienes forma de rastrear quién hizo qué cuando surge una anomalía. La URL no es un secreto: viaja por las redes, acaba en los registros y es adivinable si sigue una convención.
# Producción: SIEMPRE con autenticación
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="interne",
authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)
# SOLO desarrollo: sin autenticación
# NUNCA desplegar en producción
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
La gestión de tokens sigue cuatro disciplinas sencillas, pero debes mantenerlas en el tiempo. Almacena los tokens en variables de entorno, nunca en el código fuente. De lo contrario, tu primer git push público enviará tu token al mundo entero. Rótalos periódicamente, al menos cada 90 días. Una rotación programada convierte una posible fuga en una ventana de exposición limitada. Genéralos con los permisos mínimos necesarios, de modo que un token robado para un agente de solo lectura sea inútil para cualquiera que intente escribir. Si uno se ve comprometido, revócalo inmediatamente antes de generar uno nuevo. El orden importa: un token revocado a posteriori sigue funcionando durante todo el tiempo que tardes en buscar su sustituto.
Listas de permitidos como segunda línea de defensa
Un token válido prueba la identidad del llamador; no dice nada sobre lo que el llamador debería poder hacer. Aquí es donde entra allowed_tool_names. Aplica el principio de mínimo privilegio exponiendo solo lo estrictamente necesario al modelo.
La restricción específica depende del perfil del agente. Un chatbot público se limita a operaciones de solo lectura, sin herramientas de escritura a su alcance.
allowed_tool_names=["search_docs", "get_article", "list_categories"]
# Sin acceso a: create_article, update_article, delete_article
Un agente interno puede permitirse más acceso, incluyendo comentar un ticket, mientras mantiene fuera de su alcance las acciones irreversibles o las visibles para terceros.
allowed_tool_names=[
"search_tickets", "get_ticket", "add_comment",
# Sin acceso a: close_ticket, delete_ticket, reassign_ticket
]
Por último, una canalización automatizada solo necesita las dos herramientas que su flujo de trabajo encadena. No hay justificación para que pueda reconfigurar nada.
allowed_tool_names=["run_analysis", "get_results"]
# Sin acceso a: configure_pipeline, delete_results
El escenario contra el que te protegen estas listas es la inyección de instrucciones (prompt injection). Un documento analizado, un ticket o un correo entrante pueden contener una instrucción destinada al modelo. Sin restricción, esta instrucción puede llevarle a borrar datos mediante una herramienta delete_*, modificar un ajuste mediante update_config o emitir comunicaciones no deseadas mediante send_email. Una herramienta que nunca se ha expuesto no puede ser secuestrada. Esta es la única garantía realmente sólida.
El contexto es un recurso finito
Cada herramienta expuesta consume tokens en la ventana de contexto, ya que su nombre, descripción y esquema de parámetros deben residir allí. Un servidor que publica treinta herramientas puede consumir varios miles de tokens antes de que el usuario haga siquiera una pregunta.
Las consecuencias se manifiestan de tres formas: menos espacio para la conversación en sí, mayor tiempo de procesamiento debido al volumen a analizar y un riesgo aumentado de confusión cuando múltiples herramientas parecen similares. Tres prácticas abordan esto. En primer lugar, restringe con allowed_tool_names, que sigue siendo la palanca más directa. A continuación, segmenta por caso de uso en lugar de mantener una única configuración. Un agente de atención al cliente, un agente interno y una canalización no tienen por qué compartir el mismo catálogo. Por último, reevalúa periódicamente. Revisa tus trazas para ver qué herramientas se llaman realmente. A menudo descubrirás que varias nunca se han usado, pero cuestan contexto en cada petición.
Descripciones que mejoran la precisión
Unas descripciones cuidadosas, tanto a nivel de servidor como de herramienta, reducen mensurablemente las llamadas erróneas. El contraste siguiente ilustra la diferencia entre una descripción utilizable y una inútil.
# Buena: específica y accionable
server_description="Base de conocimientos de producto. Busca artículos de ayuda, preguntas frecuentes y guías de resolución de problemas para los productos A, B y C."
# Mala: vaga y genérica
server_description="Base de datos"
El mensaje del sistema (system prompt) es la capa final de esta configuración. Te permite expresar reglas de uso que la configuración por sí sola no puede imponer, como un orden de prioridad entre fuentes o un requisito de confirmación.
Cuando el usuario haga una pregunta técnica, busca primero en la base de conocimientos interna (kb).
Si no se encuentra la respuesta, utiliza la búsqueda web como complemento.
Nunca modifiques un ticket sin la confirmación explícita del usuario.
Ten en cuenta, sin embargo, que estas directrices orientan el comportamiento del modelo sin restringirlo. Complementan la lista de permitidos; nunca la sustituyen.
Puntos clave
- xAI impone HTTPS, pero la autenticación es responsabilidad tuya
- Almacena los tokens en variables de entorno y rótalos regularmente
- Usa
allowed_tool_namespara aplicar el principio de mínimo privilegio - Supervisa la carga de contexto: cada herramienta consume tokens
- Escribe descripciones precisas para mejorar la selección de herramientas de Grok