Ir al contenido
mofcloud

MCP y OAuth

Última actualización:

MOF es un servidor MCP. Una vez activado, clientes de IA como Claude Desktop, Cursor y Dify pueden consultar los datos de costos que cada usuario tiene permitido ver. El acceso es de solo lectura.

Activar MCP

Administrador

  1. Abre Admin → Configuración → Acceso MCP.
  2. Activa “Permitir conexiones MCP”.
  3. Haz clic en “Comprobar conexión”. El servicio MCP debería mostrar “Conectado”.

El contenedor MCP viene con las plantillas de despliegue; no hay que instalar nada más. Si la comprobación falla, asegúrate de que el contenedor mof-mcp esté en ejecución y en la misma versión que MOF.

Configurar OAuth

Administrador · necesario para Claude Desktop

Con OAuth, los usuarios pegan una dirección en su cliente de IA e inician sesión con su cuenta de MOF. Sin él, tienen que crear un token a mano, y Claude Desktop no puede usar tokens.

  1. Sirve MOF mediante HTTPS público. Claude se conecta desde sus propios servidores, así que la dirección debe ser accesible desde internet.
  2. Añade dos variables al servicio mof y recréalo:
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. En Admin → Configuración → Acceso MCP, vuelve a hacer clic en “Comprobar conexión”. El inicio de sesión OAuth debería mostrar “Configurado”.

MOF_PUBLIC_URL es la dirección que abren los usuarios, sin ruta. El secreto necesita al menos 32 caracteres y debe ser el mismo en todos los servidores de MOF. “Configurado” solo significa que ambos están definidos; el primer inicio de sesión real desde Claude confirma que la callback pública funciona. Variables de entorno

Conectar Claude Desktop

Cada usuario

  1. En MOF, abre Configuración → Conexiones MCP y copia la URL del servidor.
  2. En Claude Desktop, abre Settings → Connectors → Add custom connector. Escribe un nombre como MOF y pega la dirección.
  3. Haz clic en Connect, inicia sesión con tu cuenta de MOF en el navegador y aprueba.
  4. Hazle una pregunta a Claude, por ejemplo “¿Cuánto gastamos el mes pasado, por nube?”
Clientes sin OAuth: usa un token

En Configuración → Conexiones MCP → Tokens manuales, escribe un nombre y haz clic en “Crear token”. Cópialo de inmediato; solo se muestra una vez y dura 90 días. Envíalo como encabezado de la solicitud:

Header
Authorization: Bearer YOUR_TOKEN

Revocar el acceso

Los usuarios revocan sus propias apps y tokens en Configuración → Conexiones MCP, en “Apps conectadas” y “Mis tokens”. Desactivar “Permitir conexiones MCP” en Admin corta todas las conexiones a la vez.