API y asistentes de IA/Conectar un asistente de IA

Conectar un asistente de IA

Pregunta a claude.ai, ChatGPT, Claude Code, Cursor, VS Code o Claude Desktop sobre tu cuenta de Gloriads, mediante el conector MCP de solo lectura.

Conecta un asistente de IA a Gloriads y pregúntale sobre tu cuenta con tus propias palabras.

El asistente ve exactamente lo que ve la API de Gloriads, y no cambia nada en tu cuenta.

Qué puede ver el asistente

  • Todo lo que ve la API, y nada más.
  • Nada que pueda cambiar: ninguna configuración, nada de la facturación.
  • Tus datos sí salen de Gloriads. Conecta solo un asistente de confianza: una vez que ha leído tu cuenta, desconectarlo (Configuración → API → Aplicaciones conectadas) impide cualquier lectura posterior, pero no puede recuperar lo que ya leyó.

Qué puedes preguntar

  • “¿Qué resultados dieron mis anuncios el mes pasado y en qué marketplace invertí más?”
  • “¿Mi ACOS es mejor que el del mes anterior?”
  • “¿Qué productos tuvieron el peor ACOS en los últimos 30 días?”
  • “Muéstrame mi gasto día a día de este mes”
  • “Lista mis campañas en pausa en Alemania”
  • “¿A qué palabras clave se dirige esta campaña?”
  • “¿Qué cambiaron mis reglas esta semana, puja por puja?”

El asistente lee las mismas cifras que tu panel: la lista de lo que puede leer está en Qué lee la API.

La dirección y lo que necesita cada asistente

Una sola dirección, la misma para todos los asistentes:

https://gloriads.com/api/mcp
AsistenteQué necesita
claude.ai, Claude DesktopInicias sesión y haces clic en Permitir. Ninguna clave que copiar.
ChatGPTEl mismo inicio de sesión, pero en modo desarrollador y con un plan de pago.
Claude Code, Cursor, VS CodeUna de tus claves de API, desde Configuración → API.

Cualquier otra herramienta compatible con servidores MCP personalizados puede usar la misma dirección.

Todo está en una sola página de la aplicación, Configuración → API: la dirección, los comandos listos para usar y tus claves. Cada bloque tiene un botón Copiar.

claude.ai

  1. En claude.ai, abre Personalizar en el menú de la izquierda.

  2. Abre la pestaña Conectores.

  3. Haz clic en Añadir y luego en Añadir conector personalizado.

  4. Llámalo Gloriads, pega https://gloriads.com/api/mcp y haz clic en Continuar.

  5. No cambies nada en la página siguiente: claude.ai detectó que Gloriads se encarga del inicio de sesión y publica su propia identidad. Haz clic en Añadir.

  6. Haz clic en Conectar.

  7. Inicia sesión en Gloriads si te lo pide.

  8. Comprueba la aplicación que hace la solicitud y haz clic en Permitir.

  9. Vuelves a claude.ai. En la página del conector, en Permisos de herramientas, elige Permitir siempre: así Claude lee tus cifras sin preguntarte cada vez, y este conector no puede hacer nada más.

En una conversación, activa el conector si la aplicación te lo pide y haz tu pregunta.

Elige Haiku. Es el modelo de Claude más rápido y el más económico, y leer tus cifras no le exige nada más. Selecciónalo en el menú de modelos de tu conversación.

Una cuenta gratuita de Claude puede añadir un conector personalizado.

Para desconectarlo, abre Configuración → API → Aplicaciones conectadas en Gloriads y elige Desconectar. Deja de leer tus cifras al instante.

Claude Desktop

Claude Desktop usa los mismos conectores que claude.ai, así que no hay nada más que instalar: añade el conector desde cualquiera de los dos, inicia sesión y haz clic en Permitir. Después funciona en ambos.

ChatGPT

ChatGPT no se conecta como Claude: sus servidores personalizados están detrás del modo desarrollador, que solo se ofrece en los planes de pago de ChatGPT. Este es el recorrido completo.

  1. En la configuración de ChatGPT, activa el modo desarrollador.

  2. Abre Plugins y luego Nuevo plugin.

  3. Nombre: escribe Gloriads. El icono y la descripción son opcionales.

  4. Conexión: deja URL del servidor y pega https://gloriads.com/api/mcp.

  5. Autenticación: elige OAuth. No hay nada que rellenar debajo: Gloriads publica su configuración en esa dirección, y ChatGPT la lee.

  6. Marca Entiendo y quiero continuar —ChatGPT muestra esa advertencia para cualquier servidor personalizado, incluido el nuestro— y haz clic en Crear.

  7. ChatGPT abre Gloriads: inicia sesión si te lo pide, comprueba que la aplicación que solicita el acceso es ChatGPT y haz clic en Permitir.

  8. En una conversación, activa el plugin antes de hacer tu primera pregunta.

  9. Elige cuánto puede hacer ChatGPT por su cuenta, en Configuración → Plugins → Gloriads → Permisos. Permitir acciones de lectura es suficiente: este conector solo puede leer. Permitir todas las acciones está marcado como de riesgo elevado y aquí no te aporta nada.

Para desconectarlo, abre Configuración → API → Aplicaciones conectadas en Gloriads y elige Desconectar, igual que con claude.ai.

Claude Code

Crea una clave en Configuración → API → Crear una clave, llámala “Claude Code” y cópiala. Solo se muestra una vez.

Después ejecuta esto en una terminal, con tu clave en lugar de YOUR_API_KEY:

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
  • Compruébalo con claude mcp list, o con /mcp dentro de Claude Code.
  • El servidor se añade al proyecto actual. Añade --scope user para usarlo en todas partes.
  • Para quitarlo: claude mcp remove gloriads.

Cursor

Pon tu clave en la variable de entorno GLORIADS_API_KEY y pega esto en ~/.cursor/mcp.json (todos tus proyectos) o en .cursor/mcp.json (un solo proyecto):

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

Cursor lee la clave de esa variable, así que el archivo nunca la contiene. Define la variable antes de abrir Cursor.

VS Code

Abre MCP: Open User Configuration desde la paleta de comandos (todos tus proyectos), o crea .vscode/mcp.json en un proyecto, y añade:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

VS Code te pide la clave la primera vez que se inicia el servidor y la recuerda, así que el archivo nunca la contiene.

Las herramientas que usa

El asistente elige la herramienta adecuada para tu pregunta. Cada herramienta lee una parte de la API.

HerramientaLeePregunta de ejemplo
get_accountTu suscripción, si tu cuenta de Amazon Ads está conectada y hasta qué día llegan las cifras“¿Mi suscripción está activa?”
list_marketplacesTus marketplaces conectados y cuántas campañas tiene cada uno“¿Qué marketplaces están conectados?”
get_summaryLos totales de un periodo, por marketplace y por tipo de anuncio, comparados con un periodo anterior si lo pides“¿Cuánto gasté el mes pasado en comparación con el mes anterior?”
get_timelineLas mismas cifras día a día o mes a mes“Muéstrame mis ventas día a día de este mes”
get_products_reportLas cifras de cada producto en un periodo“¿Qué producto tiene el peor ACOS?”
get_streaming_tv_reportLas campañas de TV por streaming de un marketplace y sus cifras“¿Qué resultados dieron este mes mis anuncios de TV en Estados Unidos?”
list_campaignsLas campañas de un marketplace“Lista mis campañas en pausa en Alemania”
list_ad_groupsLos grupos de anuncios de un marketplace“¿Cuál es la puja predeterminada de los grupos de anuncios de esta campaña?”
list_targetsLas palabras clave y los demás segmentos de una campaña“¿A qué palabras clave se dirige esta campaña y con qué puja?”
list_adsLos anuncios de una campaña“¿Qué productos anuncia esta campaña?”
list_rulesTus reglas“¿Cuáles de mis reglas están activadas?”
list_rule_runsLas últimas ejecuciones de una regla“¿Qué cambió esta regla en su última ejecución?”
list_activityTodo lo que Gloriads hizo en Amazon“¿Qué cambió Gloriads esta semana?”
get_activityUna operación“¿Ya terminó esa copia?”
list_activity_linesLo que cambió una operación, línea por línea“¿Qué pujas bajó esa regla, y cuánto?”

Conviene saber

  • Las mismas cifras que la aplicación. Cada respuesta indica qué periodo y qué moneda usó, y lo dice cuando una cifra está incompleta.
  • Una clave lee toda tu cuenta. Mantenla fuera de los archivos compartidos y revócala en Configuración → API el día que dejes de usar el asistente.
  • Límites compartidos con la API: 60 solicitudes por minuto y 10.000 por día para tu cuenta. Una pregunta puede costar varias solicitudes. Consulta Límites y errores.
  • Pruébalo sin cuenta en una herramienta para desarrolladores: la clave pública de demostración de la referencia de la API también funciona aquí, y lee las cifras sintéticas de la cuenta de demostración.