Cómo conectar Pinpoint a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Pinpoint, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Pinpoint + Gemini

Pinpoint, seguimiento de candidatos (ATS): puestos, ofertas publicadas, flujos y etapas de contratación, candidaturas, candidatos, entrevistas, comentarios, scorecards, solicitudes de contratación, usuarios y estructura de la empresa. JSON:API v1 en el subdominio pinpointhq.com de tu empresa, cabecera X-API-KEY.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PINPOINT_SUBDOMAIN, PINPOINT_API_KEY

Paso 1 — Obtener credenciales

El conector lee la JSON:API v1 de Pinpoint en el subdominio propio de tu empresa con una clave API. Dos herramientas de escritura añaden comentarios internos y mueven candidaturas entre etapas.

1. Pon en PINPOINT_SUBDOMAIN la parte anterior a .pinpointhq.com de la dirección con la que inicias sesión: para acme.pinpointhq.com escribe acme.
2. Un administrador de Pinpoint abre Settings > API & Webhooks y activa el interruptor Pinpoint API. Sin él no se pueden crear claves y las llamadas responden 403.
3. En la pestaña API Keys crea una clave y pégala en PINPOINT_API_KEY. Pinpoint recomienda una clave aparte de solo lectura para herramientas de IA; pinpoint_add_comment y pinpoint_move_application_stage necesitan una clave con permiso de escritura.
4. Empieza con pinpoint_list_jobs (estado open), luego pinpoint_list_applications con job_id y pinpoint_get_application con include=candidate,stage para el detalle.

Conviene saber:

• Las respuestas siguen JSON:API: los registros están en data[] y los relacionados pedidos con include en included[]. Los ids son cadenas.
• page empieza en 1 y page_size es 100 por defecto (máximo 1000). Los puestos confidenciales no aparecen en pinpoint_list_jobs salvo que visibility incluya confidential.
• Los límites son 120 peticiones por IP y minuto y 240 cada 8 minutos; por encima, Pinpoint responde 429 con Retry-After. Mejor una llamada de listado filtrada con include que muchas lecturas sueltas.
• Mover una candidatura puede disparar los correos automáticos configurados en la etapa de destino. Los comentarios los ve el equipo de selección, no el candidato.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Pinpoint.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse