Grok Management MCP
Servidor MCP para la API de gestión de xAI — claves API, ACLs, registros de auditoría y facturación
Documentación
mcp-server-grok-management
Servidor MCP para la API de gestión de xAI (management-api.x.ai) — claves de API de equipo y facturación, a través de stdio. Binario puro en Rust.
La autenticación usa una clave de gestión (no una clave de API de inferencia) de console.x.ai → Configuración → Claves de gestión.
Para preguntas diarias sobre gastos, comience con billing_overview.
Herramientas (23)
Facturación (principal)
| Herramienta | Acceso | Notas |
|---|---|---|
billing_overview | lectura | Panel: gasto del período, margen, límites, prepago, PMs, contacto |
get_invoice_preview | lectura | Gasto de postpago de este mes + desglose por producto |
get_spending_limits | lectura | Límites suaves/duros en USD |
set_spending_limit | escritura | Límite suave en centavos; confirm="YES-WRITE" |
get_prepaid_balance | lectura | Libro mayor de créditos |
top_up | escritura | Cobrar PM predeterminado; confirm="TOP-UP" |
list_payment_methods | lectura | Tarjetas / Stripe Link (agregar tarjetas en la consola) |
set_default_payment_method | escritura | confirm="YES-WRITE" |
get_billing_info | lectura | Nombre / correo electrónico / dirección |
set_billing_info | escritura | confirm="YES-WRITE" |
list_invoices | lectura | Filtros opcionales de año/mes/desde/facturas |
get_invoice | lectura | Una factura + elementos de línea |
get_usage | lectura | Analítica (suma en USD, agrupar por, zona horaria) |
Claves de API
validate_key, list_api_keys, create_api_key, update_api_key,
delete_api_key (DELETE), rotate_api_key (ROTATE), check_propagation,
list_models, list_endpoints
Auditoría
list_audit_events
Puertas de seguridad
| Herramienta | confirm requerido |
|---|---|
delete_api_key | "DELETE" |
rotate_api_key | "ROTATE" |
set_spending_limit | "YES-WRITE" |
set_billing_info | "YES-WRITE" |
set_default_payment_method | "YES-WRITE" |
top_up | "TOP-UP" (cobra a la tarjeta) |
Los campos de dinero son centavos USD (ej. 10000 = $100.00).
Las herramientas de escritura de facturación necesitan BillingWrite (o acceso completo) en la clave de gestión.
validate_key informa si BillingWrite está listado en las ACL de la clave.
Configuración
~/.config/mcp-server-grok-management/config.toml (chmod 600):
management_key = "xai-..." # console.x.ai → Settings → Management Keys
# team_id = "uuid" # optional — auto from validate
# base_url = "https://management-api.x.ai"
Compilación
cargo build --release # target/release/mcp-server-grok-management
cargo test
./tests/test-stdio.sh
Arquitectura
Sin módulos dios: api/ (HTTP por dominio), format/ (texto puro), params/ (esquemas),
tools/ (manejadores MCP compuestos con router_keys + router_billing + router_audit).
Ver CLAUDE.md.
Clientes MCP
Ya conectado para Grok (~/.grok/config.toml) y Claude Code
(claude mcp add -s user …). Reinicie la sesión del cliente si las herramientas no aparecen.
Notas de alcance
- Crear claves de gestión es solo desde la consola.
- Agregar métodos de pago es solo desde la consola; este servidor los lista y puede establecer el predeterminado.
- Los recursos de Colecciones / Computer Use / Conversaciones / Archivos no están en la superficie REST pública de Gestión (solo aparecen como etiquetas de ACL de clave de gestión).