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| Asistente | Qué necesita |
|---|---|
| claude.ai, Claude Desktop | Inicias sesión y haces clic en Permitir. Ninguna clave que copiar. |
| ChatGPT | El mismo inicio de sesión, pero en modo desarrollador y con un plan de pago. |
| Claude Code, Cursor, VS Code | Una 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
En claude.ai, abre Personalizar en el menú de la izquierda.
Abre la pestaña Conectores.
Haz clic en Añadir y luego en Añadir conector personalizado.
Llámalo
Gloriads, pegahttps://gloriads.com/api/mcpy haz clic en Continuar.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.
Haz clic en Conectar.
Inicia sesión en Gloriads si te lo pide.
Comprueba la aplicación que hace la solicitud y haz clic en Permitir.
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.
En la configuración de ChatGPT, activa el modo desarrollador.
Abre Plugins y luego Nuevo plugin.
Nombre: escribe
Gloriads. El icono y la descripción son opcionales.Conexión: deja URL del servidor y pega
https://gloriads.com/api/mcp.Autenticación: elige OAuth. No hay nada que rellenar debajo: Gloriads publica su configuración en esa dirección, y ChatGPT la lee.
Marca Entiendo y quiero continuar —ChatGPT muestra esa advertencia para cualquier servidor personalizado, incluido el nuestro— y haz clic en Crear.
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.
En una conversación, activa el plugin antes de hacer tu primera pregunta.
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/mcpdentro de Claude Code. - El servidor se añade al proyecto actual. Añade
--scope userpara 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.
| Herramienta | Lee | Pregunta de ejemplo |
|---|---|---|
get_account | Tu suscripción, si tu cuenta de Amazon Ads está conectada y hasta qué día llegan las cifras | “¿Mi suscripción está activa?” |
list_marketplaces | Tus marketplaces conectados y cuántas campañas tiene cada uno | “¿Qué marketplaces están conectados?” |
get_summary | Los 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_timeline | Las 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_report | Las cifras de cada producto en un periodo | “¿Qué producto tiene el peor ACOS?” |
get_streaming_tv_report | Las 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_campaigns | Las campañas de un marketplace | “Lista mis campañas en pausa en Alemania” |
list_ad_groups | Los grupos de anuncios de un marketplace | “¿Cuál es la puja predeterminada de los grupos de anuncios de esta campaña?” |
list_targets | Las 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_ads | Los anuncios de una campaña | “¿Qué productos anuncia esta campaña?” |
list_rules | Tus reglas | “¿Cuáles de mis reglas están activadas?” |
list_rule_runs | Las últimas ejecuciones de una regla | “¿Qué cambió esta regla en su última ejecución?” |
list_activity | Todo lo que Gloriads hizo en Amazon | “¿Qué cambió Gloriads esta semana?” |
get_activity | Una operación | “¿Ya terminó esa copia?” |
list_activity_lines | Lo 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.