# Primeros pasos

> Elija cómo integrarse con graph8 - SDK, MCP, CLI o API REST

Source: https://docs.graph8.com/es/developers/getting-started/

Bienvenido a la plataforma para desarrolladores de graph8. Cuatro formas de integrarse: elija la que mejor se adapte a su modo de trabajar.

> **Tip: Elija primero su plan**
> Antes de conectar código, decida cómo desea pagar. **PAYG** ($0.05/crédito, 1,000 créditos gratuitos, sin necesidad de tarjeta) es ideal para evaluadores y scripts de bajo volumen. **Platform** ($499/mes) incluye 75,000 créditos de IA *más* consultas ilimitadas al índice de graph8 con un límite de 5 rps. Consulte **[Precios](https://docs.graph8.com/developers/pricing/)** para ver la comparación completa.

### Instale e integre

**JavaScript SDK**

    25+ módulos: seguimiento, inteligencia de visitantes, AI Copilot, webchat, calendario, enriquecimiento. TypeScript. React hooks.

    `npm install @graph8/sdk` - [Referencia completa →](https://docs.graph8.com/developers/sdk/)

**MCP Server**

    43 herramientas para agentes de IA. Claude.ai, Claude Desktop, Cursor, VS Code, ChatGPT. Solo pegue la URL.

    `https://be.graph8.com/mcp/` - [Guía de configuración →](https://docs.graph8.com/developers/mcp/)

### Automatice con scripts

**CLI**

    Más de 20 comandos de terminal para contactos, prospección, enriquecimiento, secuencias y campañas. Salida JSON, ejecutable desde scripts.

    `pip install g8-mcp-server` - [Ver comandos →](https://docs.graph8.com/developers/cli/)

**REST API**

    Más de 300 endpoints. Contactos, empresas, listas, enriquecimiento, búsqueda, secuencias y webhooks. Cualquier lenguaje de programación.

    `https://be.graph8.com/api/v1` - [Descripción general de la API →](https://docs.graph8.com/developers/)

---

## ¿Cuál debería usar?

| Estoy desarrollando... | Use | Por qué |
|-----------------|-----|-----|
| Una aplicación de navegador (React, Next.js, Vue) | [JavaScript SDK](https://docs.graph8.com/developers/sdk/) | Tipado, compatible con SSR, React hooks, widgets |
| Un script de servidor o backend | [REST API](https://docs.graph8.com/developers/) o [CLI](https://docs.graph8.com/developers/cli/) | HTTP directo o comandos de terminal |
| Flujos de trabajo con IA | [MCP Server](https://docs.graph8.com/developers/mcp/) | 43 herramientas, lenguaje natural |
| Un prototipo rápido | [CLI](https://docs.graph8.com/developers/cli/) | La forma más rápida de probar, salida JSON |

## Autenticación

| Método | Para | Dónde obtenerla |
|--------|-----|----------------|
| **Write key** | SDK (lado del cliente) | Configuración > MCP & API > fragmento de seguimiento |
| **API key** | REST API, CLI, SDK (lado del servidor) | Configuración > MCP & API > pestaña API |
| **OAuth** | MCP Server | Automático: pegue la URL e inicie sesión |

Consulte [Autenticación](https://docs.graph8.com/developers/authentication/) para más detalles.

---

## Flujos de trabajo habituales

### Encontrar y contactar nuevos leads

```
g8.enrich.search(filters)          // or POST /api/v1/search/contacts
  → g8.enrich.person(email)        // or POST /api/v1/enrichment/lookup/person
  → g8.sequences.add(config)       // or POST /api/v1/sequences/{id}/contacts
```

1. **Busque** en la base de datos de más de 700 millones de contactos con filtros ([SDK](https://docs.graph8.com/developers/sdk/#enrichment) | [API](https://docs.graph8.com/developers/search/) | [CLI](https://docs.graph8.com/developers/cli/#g8-find-contacts))
2. **Enriquezca** los contactos para completar los correos y teléfonos faltantes ([SDK](https://docs.graph8.com/developers/sdk/#enrichment) | [API](https://docs.graph8.com/developers/enrichment/) | [CLI](https://docs.graph8.com/developers/cli/#g8-enrich))
3. **Inscríbalos en secuencias** de prospección ([SDK](https://docs.graph8.com/developers/sdk/#sequences) | [API](https://docs.graph8.com/developers/sequences/) | [CLI](https://docs.graph8.com/developers/cli/#g8-add-to-sequence))

### Incorporar graph8 en su producto

```
g8.init({ writeKey })
g8.visitors.identify()             // Know who's visiting
g8.copilot.open()                  // AI assistant
g8.calendar.show()                 // Booking widget
g8.forms.lookup(email)             // Smart forms
```

Todo se hace mediante el [JavaScript SDK](https://docs.graph8.com/developers/sdk/) con una write key. No se necesita API key.

### Automatizar con IA

Pegue `https://be.graph8.com/mcp/` en [Claude.ai](https://docs.graph8.com/developers/mcp/), [Claude Desktop](https://docs.graph8.com/developers/mcp/), [Cursor](https://docs.graph8.com/developers/cursor-setup/) o [ChatGPT](https://docs.graph8.com/developers/mcp/). Luego consulte en lenguaje natural:

> "Encuentra 10 VPs de Ventas en empresas SaaS con 50-200 empleados, guárdalos en una lista y enriquece los que no tienen correo electrónico."

Consulte [MCP Server](https://docs.graph8.com/developers/mcp/) y [Qué puede preguntar](https://docs.graph8.com/developers/what-you-can-ask/).

### Enviar datos a su almacén

```
g8.track() → Functions (transform/filter) → BigQuery / Snowflake / Postgres
```

Cada evento se enruta automáticamente a todos los [destinos](https://docs.graph8.com/developers/destinations/) conectados. Agregue BigQuery en el panel y cada llamada `g8.track()` llegará allí. Sin código adicional.

- [Descripción general del pipeline de datos](https://docs.graph8.com/developers/data-pipeline/): cómo fluyen los eventos
- [Destinos](https://docs.graph8.com/developers/destinations/): BigQuery, Snowflake, ClickHouse, Redshift, Postgres, S3, GA4, HubSpot, Amplitude
- [Funciones](https://docs.graph8.com/developers/functions/): transformaciones en JavaScript (filtrar, enriquecer, eliminar datos personales)
- [Eventos en vivo](https://docs.graph8.com/developers/live-events/): depurador de eventos en tiempo real