Conectar un asistente de IA por MCP

Qué funciona hoy

El servidor acepta una clave de API en el encabezado Authorization. La conexión por OAuth, en la que pegas la dirección y apruebas en una pantalla de G3 Apply sin copiar ningún secreto, está en pruebas: la comprobamos con un cliente MCP local, todavía no con ChatGPT, Claude ni Cursor. Por ahora, los pasos de abajo usan una clave.

No lo confundas con el /mcp público del sitio: solo responde sobre el producto, no accede a ninguna cuenta y no pide clave.

Antes de empezar: genera una clave

Todos los clientes usan esta dirección y la clave que generes:

https://apply.g3infotech.app/api/mcp

1. Entra en G3 Apply y abre la sección Integraciones de tu cuenta.
2. Haz clic en Generar clave, ponle un nombre y marca solo lo que el asistente necesita. Por defecto, solo leer copilots.
3. Elige la validez y copia la clave, que aparece una sola vez. Trátala como una contraseña.

Claude Code

En la terminal, cambia TU_CLAVE por tu clave y ejecuta:

claude mcp add --transport http g3apply https://apply.g3infotech.app/api/mcp \
  --header "Authorization: Bearer TU_CLAVE"

Compruébalo con claude mcp list: el servidor aparece como Connected. La clave queda en texto plano en la configuración local de Claude Code, en tu ordenador. No uses --scope project con la clave en el comando: iría a un archivo que suele acabar en Git.

Más detalles en la documentación de Claude Code.

Cursor

Todavía no lo probamos en la app de Cursor. Estos pasos siguen la documentación de Cursor. En la CLI cursor-agent 2025.09.18, el encabezado no se envió y la conexión falló: si te pasa, actualiza Cursor.

Abre o crea el archivo ~/.cursor/mcp.json y pega la configuración de abajo, cambiando TU_CLAVE por tu clave. Si ya hay otros servidores, añade solo la entrada g3apply.

{
  "mcpServers": {
    "g3apply": {
      "url": "https://apply.g3infotech.app/api/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE"
      }
    }
  }
}

Usa el archivo global, no el .cursor/mcp.json del proyecto, para que la clave no vaya a Git.

App de Claude (claude.ai, Desktop y Cowork)

Todavía no lo probamos. Estos pasos siguen la documentación de Anthropic, que dice que el conector personalizado acepta una credencial fija en Request headers. La conexión sale de los servidores de Anthropic, no de tu ordenador, y la clave queda guardada allí.

1. En Customize, abre Connectors.
2. Haz clic en + Add y luego en Add custom connector.
3. Ponle un nombre, pega la dirección del servidor y haz clic en Continue.
4. En Authentication, elige No sign in.
5. En Request headers, crea el encabezado Authorization con el valor Bearer TU_CLAVE, usando tu clave.
6. Haz clic en Add.

En los planes Team y Enterprise, todos los que usan el conector entran con la misma credencial, es decir, con tu cuenta de G3 Apply. En esos planes, no uses tu clave.

El archivo claude_desktop_config.json es para servidores locales y no sirve para este caso.

ChatGPT

En pruebas. La documentación de OpenAI dice que ChatGPT usa OAuth 2.1 y no envía claves de API propias. G3 Apply ya tiene OAuth, pero todavía no lo probamos con ChatGPT de verdad, así que no prometemos que funcione. Cuando lo probemos, esta página traerá los pasos.

Qué permite cada permiso

El asistente solo ve las herramientas de los permisos que marcaste. Ninguna herramienta envía postulaciones ni correos, toca los pagos o muestra contactos.

Envío automático: lee esto antes de marcar Cambiar copilots

La clave no tiene ninguna herramienta para enviar postulaciones. Pero, con Cambiar copilots, puede poner un copilot en envío automático (FULL_AUTO, con update_copilot) y encenderlo (con resume_copilot). A partir de ahí, el copilot envía postulaciones solo.

Para eso, el asistente recibe una propuesta, confirma en una segunda llamada y además debe enviar confirmFullAuto. Un copilot creado con una clave nace pausado y en revisión manual.

Estas confirmaciones se le piden al asistente. Nuestro servidor solo ve la llamada y no sabe si dijiste que sí, así que no dejes que el cliente apruebe herramientas solo con esta clave.

Revocar la clave no apaga un copilot que ya está encendido. Pausar el copilot en G3 Apply detiene la búsqueda y la preparación de vacantes nuevas y también retiene lo que está en la cola de envío hasta que lo vuelvas a encender. El envío que ya empezó termina, porque no se puede interrumpir, y la postulación que tú mismo mandes a enviar desde su pantalla sigue adelante. Para sacar una postulación de la cola, ábrela en Postulaciones y haz clic en Descartar postulación.

Límites, actividad y revocación

• 60 mensajes por minuto por clave y 30 escrituras por hora por cuenta. Por encima de eso, la respuesta es 429, con el tiempo de espera en Retry-After.
• Las llamadas a herramientas aparecen en Actividad reciente, en la sección Integraciones, con la clave, la IP y el resultado.
• Revocar vale al instante: la siguiente llamada con esa clave se rechaza.
• La clave vence en la fecha que elijas. Cambiar la contraseña o cerrar sesión en todos los dispositivos también la apaga.
• El texto de vacantes y empresas viene de terceros y puede traer instrucciones escritas para engañar al asistente. El servidor le avisa al asistente que trate ese texto solo como datos, pero eso no es una garantía: revisa lo que propone.

Si no se conecta

• Error 401: la clave es incorrecta, venció o fue revocada, o el encabezado no llegó. Revisa el valor Bearer seguido de la clave, o genera otra.
• El cliente pide iniciar sesión, o muestra un error como Unexpected token: no envió la clave e intentó OAuth, que aquí todavía no existe. Revisa la configuración del encabezado.
• Error 403: la solicitud vino de una página de otro sitio. El servidor la rechaza a propósito; usa un cliente de terminal o de escritorio.
• INSUFFICIENT_SCOPE: falta un permiso. Genera una clave nueva con lo que falta, porque no se pueden cambiar los permisos de una clave existente.