Conectar con Claude
Agrega Atribu como conector nativo en Claude Desktop o Claude.ai con OAuth de un clic — sin tokens que copiar ni pegar
Si usas Claude Desktop o Claude.ai (web), la forma más fácil de conectar es como conector personalizado. Pegas la URL del servidor MCP de Atribu una vez, inicias sesión y apruebas — Claude se encarga de la autenticación por OAuth. No hay que generar, copiar ni guardar ningún token atb_user_.
Dos formas de conectar
- Claude Desktop / Claude.ai → agrega Atribu como conector personalizado (esta página). OAuth de un clic, sin token.
- Claude Code, Cursor, scripts, CI → usa un token de acceso personal. Consulta el Inicio rápido.
Agrega el conector
Abre Settings → Connectors (Configuración → Conectores).
Haz clic en Add custom connector (Agregar conector personalizado).
Pega la URL del servidor MCP de Atribu y confirma:
https://mcp.atribu.app/mcpSe abre una ventana de inicio de sesión. Inicia sesión en Atribu (la misma cuenta que usas en atribu.app).
Revisa el acceso solicitado, elige tus scopes y haz clic en Allow (Permitir). Claude queda conectado.
Abre Settings → Connectors (Configuración → Conectores).
Haz clic en Add custom connector (Agregar conector personalizado).
Pega la URL del servidor MCP de Atribu:
https://mcp.atribu.app/mcpInicia sesión en Atribu en la ventana que se abre y haz clic en Allow (Permitir) en la pantalla de consentimiento.
Requisito de plan
Los conectores personalizados en Claude.ai están disponibles en los planes de pago de Claude. Las etiquetas exactas del menú pueden variar ligeramente entre versiones de Claude.
La pantalla de consentimiento
Antes de conectar, Atribu te muestra exactamente lo que Claude solicita: la cuenta con la que iniciaste sesión, los scopes pedidos, y que la conexión cubre todos los workspaces a los que perteneces.
Otorga solo los scopes que realmente necesites:
| Scope | Qué permite | Recomendado |
|---|---|---|
Read analytics (mcp:read) | Atribución, campañas, creativos, journeys — datos personales enmascarados | ✅ Para la mayoría |
Read unmasked PII (mcp:read_pii) | Desenmascara email/teléfono/nombre cuando lo pides explícitamente | Solo si lo necesitas |
Write-back (mcp:write) | Envía conversiones a Meta CAPI (send_meta_conversions) | Solo si lo necesitas |
Deja PII y write-back sin marcar salvo que los necesites
Si Claude solicita todos los scopes, puedes desmarcar los que no quieras antes de hacer clic en Allow — con Read analytics basta para preguntar sobre rendimiento. Read-PII aún requiere que tu workspace esté en modo PII completo, y Write-back aún requiere que un admin del workspace lo habilite, así que marcarlos nunca salta los controles propios de tu workspace.
Pruébalo
Abre un chat en Claude y pregunta sobre el rendimiento de tus anuncios:
¿Cuál es mi ROAS este mes? ¿Qué campañas rinden mejor?Claude llama las herramientas correctas de Atribu y responde con tus datos reales. Si perteneces a varios workspaces, te preguntará cuál usar.
Gestiona las apps conectadas
Cada conexión aparece en Developer → Connected Apps en el panel de Atribu. Ahí ves qué apps autorizaste, los scopes que tienen y cuándo se usaron por última vez.
Para revocar el acceso, haz clic en Disconnect (Desconectar) — la app pierde acceso de inmediato. Puede volver a conectarse autorizando otra vez.
Revocar conector vs. token
Desconectar un conector aquí revoca la concesión OAuth (y los tokens de corta duración que emitió). Los tokens de acceso personal se gestionan por separado en Developer → MCP Tokens.
Cuándo usar un token
El conector personalizado es ideal para uso interactivo en Claude Desktop y Claude.ai. Para todo lo demás, crea un token de acceso personal:
- Claude Code y Cursor — configurados con un token en el header
- Scripts, automatizaciones, CI — donde no hay inicio de sesión interactivo
Solución de problemas
- No aparece la ventana de inicio de sesión, o Claude dice que no puede conectar. Verifica que la URL sea exactamente
https://mcp.atribu.app/mcp(con la ruta/mcp). Confirma que el servidor responde:curl https://mcp.atribu.app/health/livedebe devolver{ "status": "ok" }. - "Add custom connector" no está disponible en Claude.ai. Los conectores personalizados requieren un plan de pago de Claude. Claude Desktop también los admite.
- Claude sigue preguntando por el workspace. Es esperado si perteneces a más de uno — nombra el workspace en tu pregunta, o pídele a Claude que "liste mis workspaces" primero.
- Quieres empezar de cero. Desconecta en Developer → Connected Apps y agrega el conector de nuevo.