Cómo conectar GoAffPro a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → GoAffPro, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

GoAffPro + Gemini

Gestiona tu programa de afiliados de GoAffPro desde tu IA: encuentra afiliados y sus códigos, mira los pedidos, recompensas y tráfico que traen, lo que les debes y lo que ya les pagaste, y aprueba afiliados y comisiones, añade recompensas y registra pagos con confirmación.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

GOAFFPRO_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos y necesitas acceso de administrador a la app de afiliados GoAffPro de tu tienda.

1. Inicia sesión en el admin de GoAffPro de la tienda, desde la app en Shopify, WooCommerce o tu otra plataforma, o en https://app.goaffpro.com.
2. Abre Settings → Advanced → API Keys y genera un access token.
3. Pégalo en GOAFFPRO_ACCESS_TOKEN e instala el conector. El token solo se envía a GoAffPro.

Qué cubre: afiliados con sus códigos de referido, cupones y estructura de comisiones; grupos de afiliados (niveles); los pedidos atribuidos a afiliados con su comisión y estado de aprobación; recompensas como bonos de alta, de captación y por objetivos; el libro de cada abono y cargo; lo que se le debe ahora a cada afiliado, los pagos ya realizados y las solicitudes de pago que envían los afiliados; y el tráfico que los afiliados llevan a tu tienda.

Confirma primero: las escrituras cambian lo que los afiliados ganan y ven. La IA indica el afiliado y el importe o el estado y espera tu sí. Puede crear afiliados, aprobarlos o rechazarlos, cambiar su porcentaje de comisión, cupón o código de referido, asignar cupones, atribuir un pedido que el seguimiento no registró, aprobar o rechazar una comisión, dar una recompensa, registrar un pago y actualizar una solicitud de pago. goaffpro_record_payout solo registra un pago que hiciste por otra vía, por ejemplo por transferencia o PayPal: nunca envía dinero. goaffpro_delete_affiliate y goaffpro_delete_order están desactivados al instalar; rechazar un afiliado o un pedido conserva el historial.

Campos: la mayoría de las listas devuelven solo los campos pedidos. El conector pide un conjunto útil por defecto, y la IA pide más cuando la pregunta lo necesita.

Privacidad: afiliados, pedidos y tráfico contienen nombres, correos, datos de pago e IP de visitantes. La IA pide solo los campos que necesita la pregunta.

Errores comunes: 403 x-goaffpro-access-token missing from the headers: GoAffPro responde esto también con un token incorrecto o eliminado; genera uno nuevo en Settings → Advanced → API Keys. 400 o un texto error: falta un parámetro obligatorio o un valor no es válido.

El conector no mueve afiliados en estructuras multinivel, no edita grupos, comisiones especiales, materiales promocionales ni la configuración de la tienda, no gestiona webhooks y no usa los endpoints del lado del afiliado.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de GoAffPro.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué 10 afiliados generaron más ingresos en pedidos aprobados el mes pasado?"
• "¿Cuánto le debemos ahora a cada afiliado? Ordénalo por importe."
• "Muéstrame los afiliados que se registraron esta semana y siguen pendientes de aprobación, y luego aprueba los que yo elija."
• "Registra un pago por PayPal de 250 EUR a [email protected] correspondiente a septiembre."
• "Dale a Marco un bono de 50 EUR por alcanzar su objetivo de octubre."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT