O MOF é um servidor MCP. Depois de ativado, clientes de IA como Claude Desktop, Cursor e Dify podem consultar os dados de custo que cada usuário tem permissão para ver. O acesso é somente leitura.
Ativar o MCP
Administrador
- Abra Admin → Configurações → Acesso MCP.
- Ative “Permitir conexões MCP”.
- Clique em “Verificar conexão”. O serviço MCP deve mostrar “Conectado”.
O contêiner MCP já vem nos modelos de implantação; não há mais nada para instalar. Se a verificação falhar, confira se o contêiner mof-mcp está em execução e na mesma versão do MOF.
Configurar o OAuth
Administrador · necessário para o Claude Desktop
Com OAuth, os usuários colam um endereço no cliente de IA e entram com a conta do MOF. Sem ele, precisam criar um token manualmente, e o Claude Desktop não consegue usar tokens.
- Sirva o MOF via HTTPS público. O Claude se conecta a partir dos próprios servidores, então o endereço precisa ser acessível pela internet.
- Adicione duas variáveis ao serviço mof e recrie-o:
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"- Em Admin → Configurações → Acesso MCP, clique em “Verificar conexão” novamente. O login OAuth deve mostrar “Configurado”.
MOF_PUBLIC_URL é o endereço que os usuários abrem, sem caminho. O segredo precisa ter pelo menos 32 caracteres e deve ser o mesmo em todos os servidores do MOF. “Configurado” significa apenas que ambos estão definidos; o primeiro login real a partir do Claude confirma que a callback pública funciona. Variáveis de ambiente
Conectar o Claude Desktop
Todos os usuários
- No MOF, abra Configurações → Conexões MCP e copie a URL do servidor.
- No Claude Desktop, abra Settings → Connectors → Add custom connector. Informe um nome como MOF e cole o endereço.
- Clique em Connect, entre com sua conta do MOF no navegador e aprove.
- Faça uma pergunta ao Claude, por exemplo “Quanto gastamos no mês passado, por nuvem?”
Clientes sem OAuth: use um token
Em Configurações → Conexões MCP → Tokens manuais, informe um nome e clique em “Criar token”. Copie-o imediatamente; ele é exibido apenas uma vez e vale por 90 dias. Envie-o como cabeçalho da requisição:
Authorization: Bearer YOUR_TOKENRevogar acesso
Os usuários revogam os próprios apps e tokens em Configurações → Conexões MCP, em “Apps conectados” e “Meus tokens”. Desativar “Permitir conexões MCP” no Admin encerra todas as conexões de uma vez.