Pular para o conteúdo
mofcloud

MCP e OAuth

Última atualização:

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

  1. Abra Admin → Configurações → Acesso MCP.
  2. Ative “Permitir conexões MCP”.
  3. 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.

  1. 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.
  2. Adicione duas variáveis ao serviço mof e recrie-o:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. 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

  1. No MOF, abra Configurações → Conexões MCP e copie a URL do servidor.
  2. No Claude Desktop, abra Settings → Connectors → Add custom connector. Informe um nome como MOF e cole o endereço.
  3. Clique em Connect, entre com sua conta do MOF no navegador e aprove.
  4. 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:

Header
Authorization: Bearer YOUR_TOKEN

Revogar 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.