Conecta CrunchJunkie a Cursor

Cursor y una cuenta de CrunchJunkie con un plan de pago activo. La documentación de Cursor no vincula los servidores MCP remotos a un plan concreto de Cursor; los equipos pueden restringir servidores con una lista de permitidos, así que puede que un administrador tenga que aprobar la URL. La URL del conector es https://app.crunchjunkie.io/api/mcp/mcp. También aparece en Ajustes → Conectar asistentes de IA (MCP) en CrunchJunkie.

Cursor lee los servidores MCP de un archivo mcp.json: ~/.cursor/mcp.json para todos los proyectos, o .cursor/mcp.json en un proyecto. Añade el servidor con la clave url: { "mcpServers": { "crunchjunkie": { "url": "https://app.crunchjunkie.io/api/mcp/mcp" } } } No añadas headers ni un bloque auth. CrunchJunkie admite el registro dinámico de clientes, que Cursor usa por defecto con los servidores que necesitan OAuth. También puedes gestionar los servidores MCP desde Customize, en la barra lateral de Cursor.

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. La documentación de Cursor dice que Cursor gestiona la autenticación de los servidores compatibles con OAuth, pero no describe el aviso en sí. Si no se inicia ningún inicio de sesión, abre el servidor en los ajustes de MCP de Cursor y busca un botón para conectar o iniciar sesión.

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. Usa el chat del agente, no una edición en línea.

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). Para ver los errores de conexión y de inicio de sesión, abre el panel Output (Cmd+Shift+U en macOS) y selecciona "MCP Logs". Comprueba que el JSON es válido y que el archivo está en el sitio correcto. Los demás asistentes están cubiertos en la documentación del conector.