## Inicio rápido

**URL base:** `https://www.easybits.cloud/api/v2`

**Autenticación:** Todas las llamadas requieren un Bearer token:
```
Authorization: Bearer eb_sk_live_...
```

Obtén tu API key desde el [Dashboard de Desarrollador](https://www.easybits.cloud/dash/developer). Tu key se ve así: `eb_sk_live_...`.

**Qué acceso otorga tu key:** acceso total a tus archivos, websites, bases de datos, webhooks, documentos, presentaciones y landings. Mantenla en secreto.

**Scopes:** las keys pueden tener READ (listar/obtener), WRITE (crear/subir/actualizar/compartir), DELETE (eliminar), o ADMIN (acceso completo a la cuenta). Las keys creadas desde el dashboard incluyen READ+WRITE+DELETE por defecto.

**Recomendado — skills + CLI (Claude Code, Codex, Cursor y cualquier agente con terminal):**
```bash
npx skills add https://easybits.cloud
```
Instala las skills de EasyBits (`easybits-cli`, `easybits-sandbox`, `easybits-agent`…). El agente usa el CLI `easybits` con `--json`; la primera vez corre `easybits login --json` y te pasa una liga para entrar. Sin llaves en archivos de configuración. Detalle en la sección [CLI](#cli).

El MCP sigue siendo el camino para clientes sin terminal (Claude.ai: Ajustes → Conectores → `https://www.easybits.cloud/api/mcp`) o que sólo hablan MCP:

**MCP — Ghosty Code (preinstalado):**
Ghosty Code v0.0.4+ ya trae EasyBits preinstalado vía HTTP. Solo configura tu API key:
```bash
export EASYBITS_API_KEY=eb_sk_live_YOUR_KEY
ghosty
```

**MCP — Claude Code (un comando):**
```bash
claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY
```

**MCP — Cursor / VS Code / Windsurf (Streamable HTTP):**
```json
{
  "mcpServers": {
    "easybits": {
      "type": "streamable-http",
      "url": "https://www.easybits.cloud/api/mcp",
      "headers": { "Authorization": "Bearer eb_sk_live_YOUR_KEY" }
    }
  }
}
```

**SDK:**
```bash
npm install @easybits.cloud/sdk
```

```ts
import { EasybitsClient } from "@easybits.cloud/sdk";
const eb = new EasybitsClient({ apiKey: "eb_sk_live_..." });
```

Por defecto solo carga el grupo `core`. Habilita más con `--tools`, separando
grupos por comas:
```bash
# Core + sandboxes + documents
claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY --tools core,sandbox,docs

# Todo
claude mcp add easybits -- npx -y @easybits.cloud/mcp --key eb_sk_live_YOUR_KEY --tools all
```
El catálogo de grupos —cuáles hay, qué trae cada uno y cuántas tools son— se
DERIVA del servidor MCP: ver [Tool Groups](#tool-groups). No lo copies aquí a
mano; cada cifra escrita en prosa se desincroniza en el siguiente deploy.