Servidor MCP

Conecta herramientas de IA como Claude o Cursor a tu organización usando el protocolo MCP con OAuth 2.0.

El servidor MCP de SouthGames implementa el Model Context Protocol — el estándar abierto de Anthropic para conectar herramientas de IA a fuentes de datos externas.

Con esta integración, puedes conectar Claude.ai (web), Claude Desktop, Cursor, o cualquier cliente MCP directamente a tu organización y hacer preguntas como:

"¿Cuáles son mis campañas activas y cuántas jugadas tienen?"
"Muéstrame los clientes con más XP"
"¿Cómo está el engagement de los últimos 30 días?"
"¿Qué journeys tiene activados mi organización?"

Autenticación — OAuth 2.0

El servidor usa OAuth 2.0 con PKCE (el estándar recomendado para MCP remoto). La primera vez que conectes, tu cliente MCP te redirigirá a SouthGames para autenticarte con tu cuenta. No necesitas copiar API keys.

URL del servidor:   https://southgames.ai/api/mcp
Flujo:              Authorization Code + PKCE (S256)
Discovery:          https://southgames.ai/.well-known/oauth-authorization-server

Configurar Claude.ai (web)

Ve a claude.ai → Settings → Integrations (o "Custom Connectors")
Haz clic en "Add custom connector" (o "Add MCP server")
Ingresa la URL: https://southgames.ai/api/mcp
Claude.ai descubrirá el servidor automáticamente y te pedirá autenticarte
Se abrirá SouthGames — inicia sesión y selecciona tu organización
Listo — Claude.ai tiene acceso a tus datos

Configurar Claude Desktop

Edita el archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "southgames": {
      "type": "http",
      "url": "https://southgames.ai/api/mcp"
    }
  }
}

Al reiniciar Claude Desktop, te pedirá autenticarte con tu cuenta SouthGames (flujo OAuth).

Configurar Cursor

En Cursor Settings → MCP → Add new MCP server:

Campo	Valor
Name	SouthGames
Type	HTTP
URL	`https://southgames.ai/api/mcp`

Cursor iniciará el flujo OAuth automáticamente.

Método alternativo — API Key

Si tu cliente MCP no soporta OAuth, puedes seguir usando API keys directamente:

{
  "mcpServers": {
    "southgames": {
      "type": "http",
      "url": "https://southgames.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sg_live_tu_api_key",
        "X-Org-Id": "tu-org-slug"
      }
    }
  }
}

Genera tu API key en Configuración → API Keys.

Datos disponibles

El servidor expone recursos de solo lectura para todos los dominios de tu organización. Consulta la referencia completa de recursos para ver los ~50 URIs disponibles.

Dominio	Datos
Campañas	Lista, detalle, estadísticas de plays/wins
Analytics	KPIs, series temporales, top campañas, engagement
Clientes	Perfil, XP, tier, puntos, segmentos
Notificaciones	Push sends, in-app, templates
Eventos	Definiciones, historial, eventos por cliente
Tiers	Configuración, distribución, tier del cliente
Puntos	Config, saldo, ledger, rewards, estadísticas
Journeys	Lista, detalle, enrollments, analytics
Misiones	Lista, detalle, analytics, progreso
Rankings	Leaderboard, configuración
Referidos	Config, lista, estadísticas
Configuración	Perfil de la organización

Seguridad

Tokens OAuth con expiración de 90 días — renovables vía re-autenticación
Solo se exponen datos de tu organización — no hay acceso cross-tenant
El servidor es de solo lectura — no es posible modificar datos a través del MCP
Puedes revocar el acceso en cualquier momento desde Configuración → API Keys