Grok Management MCP
Servidor MCP para a API de Gerenciamento xAI — chaves de API, ACLs, logs de auditoria e faturamento
Documentação
mcp-server-grok-management
Servidor MCP para a API de Gerenciamento xAI (management-api.x.ai) — chaves de API da equipe e cobrança, via stdio. Binário Rust puro.
A autenticação usa uma chave de gerenciamento (não uma chave de API de inferência) de console.x.ai → Configurações → Chaves de Gerenciamento.
Para perguntas do dia a dia sobre gastos, comece com billing_overview.
Ferramentas (23)
Cobrança (principal)
| Ferramenta | Acesso | Observações |
|---|---|---|
billing_overview | leitura | Painel: gasto do período, margem, limites, pré-pago, PMs, contato |
get_invoice_preview | leitura | Gasto pós-pago deste mês + detalhamento por produto |
get_spending_limits | leitura | Limites flexíveis/rígidos em USD |
set_spending_limit | escrita | Limite flexível em centavos; confirm="YES-WRITE" |
get_prepaid_balance | leitura | Registro de créditos |
top_up | escrita | Cobrar PM padrão; confirm="TOP-UP" |
list_payment_methods | leitura | Cartões / Stripe Link (adicionar cartões no console) |
set_default_payment_method | escrita | confirm="YES-WRITE" |
get_billing_info | leitura | Nome / e-mail / endereço |
set_billing_info | escrita | confirm="YES-WRITE" |
list_invoices | leitura | Filtros opcionais por ano/mês/desde/IDs de fatura |
get_invoice | leitura | Uma fatura + itens de linha |
get_usage | leitura | Análises (soma em usd, group_by, fuso horário) |
Chaves 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
Auditoria
list_audit_events
Portões de segurança
| Ferramenta | Obrigatório confirm |
|---|---|
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 cartão) |
Campos de dinheiro são centavos de USD (por exemplo, 10000 = $100.00).
Ferramentas de cobrança de escrita precisam de BillingWrite (ou acesso total) na chave de gerenciamento. validate_key informa se BillingWrite está listado nas ACLs da chave.
Configuração
~/.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"
Compilação
cargo build --release # target/release/mcp-server-grok-management
cargo test
./tests/test-stdio.sh
Arquitetura
Sem módulos gigantes: api/ (HTTP por domínio), format/ (texto puro), params/ (esquemas), tools/ (handlers MCP compostos com router_keys + router_billing + router_audit). Veja CLAUDE.md.
Clientes MCP
Já integrado para Grok (~/.grok/config.toml) e Claude Code (claude mcp add -s user …). Reinicie a sessão do cliente se as ferramentas não aparecerem.
Notas de escopo
- Criar chaves de gerenciamento em si é apenas no console.
- Adicionar métodos de pagamento é apenas no console; este servidor os lista e pode definir o padrão.
- Recursos de Collections / Computer Use / Conversations / Files não estão na superfície REST pública de Gerenciamento (aparecem apenas como rótulos de ACL da chave de gerenciamento).