Guía de
Conexiones

Cuenta en la org requerido

Qué es: el repo del hackathon vive en la organización FARO-DataLab en GitHub. Ahí están las ideas, los prototipos y el board. GitHub Desktop es la app con botones para clonar/commit/push sin terminal (ideal si no sos dev).

Cómo se conecta:

1. Creá tu cuenta de GitHub en github.com/signup (es gratis; si ya tenés una, usá esa). Después avisá tu usuario para que te sumen a FARO-DataLab/gkt-hackaton-julio-2026.
2. Descargá e instalá GitHub Desktop e iniciá sesión con la cuenta que creaste (la app te lo pide al abrirla). Después File → Clone repository → elegí el repo.
3. Alternativa por terminal: gh auth login y después gh repo clone FARO-DataLab/gkt-hackaton-julio-2026.

El agente y la app requerido

Qué es: Claude Desktop es la app para charlar y conectar MCPs; Claude Code es el agente que corre en la terminal y construye. Con tu cuenta de Growketing.

Cómo se conecta:

# Claude Desktop: descargar de claude.ai/download (Mac/Windows) e iniciar sesión

# Claude Code (CLI) — necesita Node.js
npm install -g @anthropic-ai/claude-code
cd gkt-hackaton-julio-2026
claude            # la 1ª vez abre el navegador para loguearte

Enchufarle herramientas al agente requerido

Qué es: un MCP es la forma estándar de darle herramientas y datos al agente (un "USB universal"). El más usado acá es el MCP del Data Platform (campañas, métricas, clientes sin tocar SQL); también hay MCPs oficiales de terceros.

Cómo se conecta — Claude Desktop (Settings → Developer → Edit Config, dentro de mcpServers):

{
  "mcpServers": {
    "data-platform": {
      "url": "https://mcp.data-platform.growketing.io/mcp",
      "headers": { "Authorization": "Bearer <passbolt>" }
    }
  }
}

Cómo se conecta — Claude Code:

claude mcp add --transport http data-platform https://mcp.data-platform.growketing.io/mcp \
  --header "Authorization: Bearer <passbolt>"
claude mcp list   # lista los servers configurados y su estado

CRM · conectado con Level Blue listo

Qué es: el CRM donde viven contactos, empresas, deals, pipelines y actividad. Es la base del ABM y de la higiene del pipeline. La conexión ya está establecida a través de Level Blue (la integración que administra el portal), así que el acceso sale de ahí: no se crea una private app nueva por persona.

Cómo se conecta: copiás el token de acceso (gestionado vía Level Blue) de Passbolt y llamás a la HubSpot API v3 con el header Authorization: Bearer. En Claude Desktop también podés sumar el conector oficial de HubSpot desde Settings → Connectors.

curl "https://api.hubapi.com/crm/v3/objects/deals?limit=1" \
  -H "Authorization: Bearer <passbolt>"

Google, Meta y LinkedIn Ads, GA4 listo

Qué es: el MCP del Data Platform (paso 03) ya expone la performance de las plataformas de Ads: campañas, ad groups, keywords, search terms, spend diario y GA4 por cliente. No hace falta tocar SQL ni pedir tokens de cada plataforma.

Cómo se conecta: con el mismo MCP del paso 03. No hay nada extra que configurar.

MCP de Odoo pedir acceso

Qué es: el ERP de Growketing: facturación, cobranzas, P&L por unidad de negocio y cliente, colaboradores y headcount por área. Se accede con el MCP de Odoo, que expone esos datos en modo lectura.

Cómo se conecta: pedile el token a Devs (Tito o Bianca); queda en Passbolt. Después lo sumás como MCP:

claude mcp add --transport http gkt-odoo https://odoo-mcp.growketing.io/mcp \
  --header "Authorization: Bearer <passbolt>"

Horas por persona y proyecto token personal

Qué es: donde el equipo carga las horas por cliente y proyecto. Es la mitad del cruce horas vs. facturación y de la vista de capacidad. Se accede con la Everhour API y un token personal.

Cómo se conecta: en Everhour, Settings → My Profile → API token. El token hereda tus permisos: si no ves las horas de todo el equipo en la web, tampoco las vas a ver por API. Guardalo como variable de entorno, nunca en el repo.

export EVERHOUR_API_KEY=<tu-token>
curl "https://api.everhour.com/users/me" -H "X-Api-Key: $EVERHOUR_API_KEY"