Documentación

Conecta CrunchJunkie a VS Code (GitHub Copilot)

Añade el conector MCP de CrunchJunkie a VS Code con el comando MCP: Add Server, inicia sesión con tu cuenta de CrunchJunkie y úsalo desde el chat de Copilot.

Lo que necesitas

VS Code con sus funciones de IA activadas (chat de GitHub Copilot) y una cuenta de CrunchJunkie con un plan de pago activo. La documentación de VS Code no indica ningún requisito de plan para los servidores MCP, pero dice que tu organización puede restringir qué servidores están disponibles. La URL del conector es https://app.crunchjunkie.io/api/mcp/mcp. También aparece en Ajustes → Conectar asistentes de IA (MCP) en CrunchJunkie.

Añadir el conector

1. Abre la paleta de comandos y ejecuta "MCP: Add Server". 2. Elige "HTTP (HTTP or Server-Sent Events)". 3. Escribe la URL del conector como endpoint MCP. 4. Escribe un ID de servidor que no esté en uso, por ejemplo crunchjunkie. 5. Elige dónde guardarlo. Para una configuración personal, elige "Global" y después la opción que VS Code ofrezca a continuación (mostraba "Copilot Global" cuando leímos la página). Para compartirlo con un equipo, VS Code describe un archivo .mcp.json en la raíz del espacio de trabajo, que es experimental y está tras el ajuste chat.mcp.workspaceRootConfig.enabled. VS Code escribe el servidor en el archivo de configuración que hayas elegido. Su documentación remite a su referencia de configuración de MCP para el formato exacto del archivo.

Iniciar sesión

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 VS Code solo dice que, si un servidor necesita autenticación, se sigan las instrucciones de inicio de sesión del editor del servidor, así que el aviso exacto puede ser distinto del que se describe aquí.

Comprobar que funciona

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. Pregúntalo en una sesión de agente del chat de Copilot y comprueba que la llamada a la herramienta muestra el servidor de CrunchJunkie como origen.

Acciones de escritura

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.

Si no funciona

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 falta "MCP: Add Server", comprueba que las funciones de IA están activadas y que has abierto una carpeta de proyecto. Si tu organización restringe los servidores MCP, un administrador tiene que permitir esta URL. Los demás asistentes están cubiertos en la documentación del conector.