# Instrucciones para el agente: Markifact MCP: consulta marketing y prepara cambios con aprobación

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/markifact/markifact-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/markifact-ads-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara la cuenta y el cliente

Comprueba que Claude Code abre una sesión autenticada. Crea tu cuenta en [Markifact](https://www.markifact.com) y revisa los permisos de los conectores. Para Claude Code, el README indica:

```text
claude plugin marketplace add markifact/markifact-mcp
/plugin install markifact@markifact
```

El primer comando registra el catálogo desde la CLI y el segundo instala el plugin dentro de Claude Code. Reinicia la sesión. El plugin configura el servicio remoto `https://api.markifact.com/mcp`; no instala el backend localmente. La [guía de Claude Code](https://github.com/markifact/markifact-mcp/blob/main/docs/claude-code.md) indica que la primera llamada abre OAuth en el navegador: inicia sesión en Markifact y autoriza la conexión. Vincula la cuenta de marketing en [Connections](https://www.markifact.com/app/connections).

### Paso 2: prueba una lectura

Pide: «Consulta mis cuentas de Meta y prepara un informe de la última semana frente a la anterior, sin modificar nada». Es la adaptación al español del ejemplo oficial de informe semanal. Revisa sus datos antes de iniciar cualquier flujo de escritura.

## Comprobación

Contrasta una métrica con el panel original. Para una prueba de escritura, confirma que existe una aprobación explícita y que el destino y estado coinciden con lo revisado.

## Si algo falla

Si falta una plataforma, revisa su conexión y permisos. Si no aparece aprobación, detén la escritura y consulta la documentación del flujo concreto.