Conecta CrunchJunkie a Claude Code

Claude Code instalado y con la sesión iniciada, y una cuenta de CrunchJunkie con un plan de pago activo. La URL del conector es https://app.crunchjunkie.io/api/mcp/mcp. También aparece en Ajustes → Conectar asistentes de IA (MCP) en CrunchJunkie.

Ejecuta esto en tu terminal: claude mcp add --transport http crunchjunkie https://app.crunchjunkie.io/api/mcp/mcp El nombre (crunchjunkie) lo eliges tú. Por defecto, el servidor se guarda solo para ti y para el proyecto actual. Añade --scope user para que esté disponible en todos tus proyectos, o --scope project para escribirlo en el .mcp.json del proyecto y que tu equipo lo comparta (Claude Code pide a cada persona que apruebe un servidor de proyecto antes de usarlo).

Dentro de Claude Code, ejecuta /mcp y sigue los pasos en tu navegador. Desde una shell puedes ejecutar claude mcp login crunchjunkie en su lugar. Por SSH, donde no hay navegador local (conéctate con ssh -t para que funcione el paso de pegar), el comando imprime la URL de autorización: ábrela en tu propio equipo y pega después en el prompt la URL de redirección completa de la barra de direcciones del navegador. Añade --no-browser para forzar ese modo. Cuando el asistente usa el conector por primera vez, te envía a una página de inicio de sesión de CrunchJunkie. Inicias sesión con tu cuenta de CrunchJunkie, igual que en la aplicación (correo y contraseña, Google o el SSO de tu empresa), y apruebas el acceso. No hay ninguna clave API que copiar ni guardar. El inicio de sesión es OAuth 2.1 a través de WorkOS AuthKit, y el asistente se registra por sí mismo con registro dinámico de clientes o con un Client ID Metadata Document, así que no introduces ningún ID de cliente ni secreto. La conexión actúa como tú y solo ve lo que puede ver tu cuenta, en un espacio de trabajo a la vez. Hasta que elijas, es el espacio de trabajo al que te uniste primero. Para cambiarlo, abre Ajustes → Conectar asistentes de IA (MCP), o pide al asistente que enumere tus espacios de trabajo y cambie de uno a otro. Si tu empresa exige SSO, conéctate después de iniciar sesión con SSO. Claude Code guarda los tokens y los renueva automáticamente. Para cerrar sesión, usa "Clear authentication" en el menú de /mcp o ejecuta claude mcp logout crunchjunkie.

Empieza un chat nuevo con el conector activado y pregunta: "Enumera mis clientes." Deberías recibir tus clientes de CrunchJunkie. Prueba después con una pregunta real: "¿Qué visibilidad tuvo <brand> en las respuestas de IA durante los últimos 30 días, con los tamaños de muestra?" Sustituye <brand> por uno de tus clientes. La respuesta sale de tus datos en vivo y cita en cuántas respuestas de IA se basa cada porcentaje. Si el asistente responde con conocimiento general en lugar de llamar a una herramienta de CrunchJunkie, dile que use el conector de CrunchJunkie. Ejecuta /mcp para ver si el servidor figura como conectado.

Leer nunca cambia nada. Las acciones de escritura (crear un informe, añadir un widget, seguir un prompt y similares) están desactivadas hasta que el propietario o un administrador del espacio de trabajo active «Permitir acciones de escritura» en Ajustes → Conectar asistentes de IA (MCP). Aun así, cada herramienta de escritura devuelve primero una vista previa y no cambia nada hasta que la confirmas, y un miembro con el rol Solo lectura no puede hacer cambios en absoluto. Las reglas completas están en la documentación del conector.

La página de inicio de sesión de CrunchJunkie no llega a abrirse, o el asistente dice que no ha iniciado sesión: elimina el conector y vuelve a añadirlo, y comprueba que la URL es exactamente https://app.crunchjunkie.io/api/mcp/mcp. Una herramienta responde "missing scope" o "forbidden": la cuenta con la que iniciaste sesión no tiene un plan de pago activo, o no es miembro del espacio de trabajo propietario de los datos. Inicia sesión con una cuenta que tenga acceso. Si tu cuenta pertenece a varios espacios de trabajo, puede que el asistente esté trabajando en otro; pídele que enumere tus espacios de trabajo. Las herramientas de escritura se rechazan: las acciones de escritura están desactivadas por defecto. El propietario o un administrador del espacio de trabajo las activa en Ajustes → Conectar asistentes de IA (MCP). Si el navegador no se abre, copia la URL del terminal y ábrela tú. Si la redirección falla con un error de conexión después de iniciar sesión, pega en el prompt de Claude Code la URL de retorno completa de la barra de direcciones. Las ejecuciones en modo no interactivo (claude -p) y las del Agent SDK no pueden completar el inicio de sesión, así que inicia sesión antes desde una sesión interactiva. Para empezar de cero, ejecuta claude mcp remove crunchjunkie, que también borra los tokens guardados y el registro del cliente, y vuelve a añadir el servidor. Los demás asistentes están cubiertos en la documentación del conector.