Saltar al contenido
Notificado
Menú
Crear cuenta

MCP para afiliados

Conecte un asistente de IA a su cuenta de afiliado: el token, los alcances, la factura que espera su confirmación y lo que solo hace usted.

Actualizado:

Si usted es afiliado aprobado del programa de referidos, puede conectar un asistente de IA (Claude Code, Claude Desktop, Cursor) a su propia cuenta del programa. El asistente consulta sus cifras, sus estados de cuenta y sus movimientos, descarga el documento soporte y puede preparar la factura de un estado de cuenta. Nunca presenta una factura sin su confirmación.

El servidor es https://www.notificado.co/mcp/afiliados. Es distinto del servidor de las firmas (/mcp): un token de afiliado no abre nada de una firma, y un token de firma no abre nada aquí.

Qué ve el asistente

Solo su cuenta de afiliado. El token actúa por usted: no hay forma de pedir la cuenta de otro afiliado, ni los procesos, notificaciones o evidencia de ninguna firma, incluida la suya.

1. Cree un token

  1. Inicie sesión y abra /afiliados. La sección Acceso para agentes (MCP y API) aparece cuando su afiliación está aprobada.
  2. Póngale un nombre que diga dónde lo usará (por ejemplo, "Claude Desktop, portátil").
  3. Elija los alcances. Dé solo los que necesita.
  4. Pulse Crear token. El token se muestra una sola vez, con un botón para copiarlo. Guardamos solo su huella: si lo pierde, revóquelo y cree otro.

En la misma sección ve cada token con su fecha de creación, su último uso y su vencimiento, y lo revoca cuando quiera. Un token revocado deja de funcionar en la siguiente llamada.

2. Conecte su cliente

Claude Code, con un comando:

claude mcp add --transport http notificado-afiliados https://www.notificado.co/mcp/afiliados --header "Authorization: Bearer <token>"

Claude Desktop, mediante el puente mcp-remote (requiere Node.js), en su archivo de configuración:

{
  "mcpServers": {
    "notificado-afiliados": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.notificado.co/mcp/afiliados", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer <token>" }
    }
  }
}

Cursor, por URL y encabezado, en mcp.json:

{
  "mcpServers": {
    "notificado-afiliados": {
      "url": "https://www.notificado.co/mcp/afiliados",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Reemplace <token> por el que copió. El servidor de afiliados no ofrece inicio de sesión OAuth: siempre es con un token. Para probar la conexión, pida al asistente que llame whoami({}) y luego list_resources({}).

Cómo trabaja el asistente

Como en el servidor de las firmas, el asistente ve cinco herramientas: list_resources, describe_resource, manage_resource, docs y whoami. Las acciones de su cuenta están en tres recursos y se ejecutan con manage_resource:

Recurso Qué contiene
account Su cuenta de un vistazo: código, enlace de referido, estado, verificación, embudo y saldos.
statements Los estados de cuenta mensuales, el libro de movimientos y la descarga del documento soporte de un estado de cuenta.
invoice-filing Subir el XML y el PDF de la factura, pedir que se presente y ver las facturas que esperan su confirmación. 
manage_resource({ resource: "account", action: "myAffiliateSummary", params: {} })

Cada token ve solo las acciones que abren sus alcances. El propio servidor entrega tres recetas por la herramienta docs: leer el tablero (docs://affiliate/read-my-affiliate-dashboard), presentar la factura de un estado de cuenta (docs://affiliate/file-a-statement-invoice) y consultar la verificación (docs://affiliate/check-my-kyc-status).

Alcances

Alcance Qué permite
affiliate:read Leer el resumen (código, enlace de referido, clics, registros, conversiones y saldos), el estado de su verificación, los estados de cuenta mensuales y el libro de movimientos, y descargar el documento soporte de un estado de cuenta. Cada descarga queda registrada.
affiliate:invoices Subir los dos archivos de la factura electrónica de un estado de cuenta (el XML que validó la DIAN y su PDF) y presentarla.

La factura espera su confirmación

Cuando un asistente presenta una factura con affiliate:invoices, Notificado no la toma todavía: la guarda como pendiente y la muestra en /afiliados, en Facturas enviadas por un agente, con el estado de cuenta, el canal por el que llegó y la huella SHA-256 de cada archivo. El asistente recibe awaiting_confirmation y un enlace que abre esa factura en /afiliados. Tiene 7 días para confirmarla; después vence sin presentarse.

  • Confirmar: la factura se presenta como si usted la hubiera subido, y se revisa contra lo que el estado de cuenta pide.
  • Rechazar: la factura se descarta y el estado de cuenta sigue esperando una.

Un agente no puede confirmar su propia factura. Si la factura no coincide con el estado de cuenta (NIT, valores, fecha), se rechaza al confirmarla con las mismas razones que vería al subirla usted. Si los archivos cambian después de que el agente los envió, la confirmación se niega y el agente debe enviarla de nuevo.

Lo que solo hace usted

Estas acciones no tienen herramienta MCP ni operación en la API, con ningún alcance:

  • Postularse al programa y aceptar los términos.
  • La verificación de identidad y tributaria (documento, RUT, régimen).
  • La cuenta de pago: a dónde se transfieren sus comisiones.
  • Confirmar o rechazar una factura enviada por un agente.
  • Crear y revocar tokens de afiliado.

La misma cuenta por HTTP

Cada lectura y la factura están también en la API de afiliados, https://www.notificado.co/v1/afiliados, con el mismo token y los mismos alcances. Vea API para afiliados.

Límites

El servidor de afiliados comparte las reglas de frecuencia del resto del MCP: al superar el límite, la respuesta es HTTP 429 con retry-after, los segundos que debe esperar. Vea Límites.