Conectar tu agente por MCP

Apps de chat en menos de un minuto

claude.ai, Claude Desktop y otras apps de chat con conectores personalizados inician sesión con tu cuenta de Staglight (OAuth 2.1), así que nadie tiene que pegar una clave. Apruebas cada app una vez y le das un tope de gasto.

Claude

Añadir a Claude

1. Haz clic en el botón de arriba o, en Claude, abre Personalizar > Conectores > Añadir conector personalizado con el nombre Staglight y la URL https://staglight.ai/mcp.
2. Haz clic en Continuar, deja Iniciar sesión ahora y haz clic en Añadir; luego entra con tu cuenta de Staglight, elige qué puede hacer y su tope de gasto, y haz clic en Permitir. Con el plan gratuito puedes añadir un conector personalizado; en Team y Enterprise lo añade primero un propietario y tú haces clic en Conectar.
3. En un chat, abre + > Conectores y activa Staglight. Adjunta una foto del producto y pide: hazme un anuncio para este producto.

ChatGPT

1. En ChatGPT en la web, abre Ajustes > Plugins y haz clic en + > Añadir servidor MCP personalizado. Hace falta un espacio Business, Enterprise o Edu que lo permita; en Pro solo puede leer.
2. Llámalo Staglight, pega la URL https://staglight.ai/mcp, elige OAuth, marca la casilla para continuar y haz clic en Crear como plugin.
3. Inicia sesión con tu cuenta de Staglight y haz clic en Permitir.
4. En un chat nuevo, escribe @, elige Staglight y pide tu anuncio.

Cada conexión aparece en Ajustes > Conexiones con su tope de gasto (en 24 horas); Desconectar le quita el acceso al instante. Las herramientas que gastan, suben o cambian algo necesitan el permiso Crear anuncios y gastar créditos; una conexión de solo lectura puede ver pero no gastar.

Servidor

Crea una clave con límite diario en el estudio y guárdala como STAGLIGHT_API_KEY.

export STAGLIGHT_API_KEY="sl_live_..."

Claude Code

Un solo comando para todos los proyectos de este equipo. La terminal inserta la clave y Claude Code la guarda en ~/.claude.json.

claude mcp add --transport http staglight https://staglight.ai/mcp \
  --header "Authorization: Bearer $STAGLIGHT_API_KEY" --scope user

¿Prefieres iniciar sesión en vez de usar una clave? Ejecuta el comando sin la parte --header, escribe /mcp en Claude Code y elige staglight para iniciar sesión con tu cuenta de Staglight.

Comprueba que se conectó:

claude mcp get staglight

Para compartirlo con un equipo en el repositorio, añade .mcp.json. Cada persona guarda la clave en su propia STAGLIGHT_API_KEY.

{
  "mcpServers": {
    "staglight": {
      "type": "http",
      "url": "https://staglight.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${STAGLIGHT_API_KEY}"
      },
      "timeout": 600000
    }
  }
}

Llama a la variable STAGLIGHT_API_KEY. Claude Code deja vacías en los encabezados remotos algunas variables de credenciales con nombres reservados, así que usa esta.

Codex

codex mcp add staglight --url https://staglight.ai/mcp --bearer-token-env-var STAGLIGHT_API_KEY

O escríbelo a mano en la configuración de Codex:

[mcp_servers.staglight]
url = "https://staglight.ai/mcp"
bearer_token_env_var = "STAGLIGHT_API_KEY"
startup_timeout_sec = 20
tool_timeout_sec = 120

Codex corta una llamada a una herramienta a los 60 s por defecto. Todas las herramientas responden en menos de 50 s, y get_job espera 50 s como máximo.

Cursor

En ~/.cursor/mcp.json para todos los proyectos, o en .cursor/mcp.json para uno:

{
  "mcpServers": {
    "staglight": {
      "url": "https://staglight.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:STAGLIGHT_API_KEY}"
      }
    }
  }
}

Claude Desktop y claude.ai

claude.ai y Claude Desktop se conectan iniciando sesión con tu cuenta de Staglight: consulta Apps de chat.

Si prefieres usar ahí una clave de API, usa como puente en tu equipo el paquete de la comunidad mcp-remote en claude_desktop_config.json:

{
  "mcpServers": {
    "staglight": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://staglight.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}",
        "--transport",
        "http-only"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_..."
      }
    }
  }
}

mcp-remote es un paquete de terceros que se ejecuta en tu equipo con tu clave. Revísalo antes de usarlo.

Herramientas

Las herramientas de pago aceptan max_credits e idempotency_key. Cada resultado trae un texto breve, los datos en JSON y, para archivos terminados, enlaces de descarga.

Reglas de gasto para agentes

• Llama a estimate_cost antes de cualquier herramienta de pago. Es gratis y calcula el precio de la llamada exacta: tool más arguments.
• Envía max_credits y un idempotency_key nuevo en cada llamada de pago.
• Las herramientas de pago responden al momento con un job_id o run_id. Consulta get_job o get_ad con wait_seconds=50.
• Si se agota el tiempo de espera, llama a list_jobs con el mismo idempotency_key antes de volver a pagar.
• Los trabajos fallidos se reembolsan solos. Sin créditos, buy_credits_link da al usuario un enlace al estudio. Ningún pago pasa por el MCP.
• Da a cada agente su propia clave con límite diario. Al llegar al límite recibe daily_limit_reached y se detiene.
• Con auto: true, create_ad y create_ad_from_brief aprueban solos cada paso de revisión mientras todo el anuncio quepa en max_credits. Si el siguiente paso lo superara, el anuncio espera en ese paso con auto_stopped y no se cobra nada más.

Errores

Los errores de las herramientas llegan como resultado con isError: true y los mismos códigos que la API REST. Sin créditos incluye needed, balance y topup_url. Una clave que falta o es incorrecta da HTTP 401 con WWW-Authenticate.

{
  "content": [
    {
      "type": "text",
      "text": "Error insufficient_credits: This needs 63 credits and the balance is 10. ..."
    }
  ],
  "structuredContent": {
    "error": {
      "code": "insufficient_credits",
      "message": "This needs 63 credits and the balance is 10. Buy credits to continue.",
      "status": 402,
      "needed": 63,
      "balance": 10,
      "charged": false,
      "topup_url": "https://staglight.ai/app/creditos?need=53"
    }
  },
  "isError": true
}

Prueba con curl

El servidor responde JSON normal por POST, sin sesiones, así que curl funciona:

curl -s https://staglight.ai/mcp \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-11-25", "capabilities": {}, "clientInfo": {"name": "curl", "version": "1.0"}}}'

curl -s https://staglight.ai/mcp \
  -H "Authorization: Bearer $STAGLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "get_balance", "arguments": {}}}'

Esta página en Markdown · llms.txt