# Cómo conectar Claude a Outbox (connector remoto o npx)

> Dos formas de que Claude publique en Outbox: el connector remoto en mcp.out-box.dev con login en el navegador, o el servidor MCP local con npx y una API key.

Con Claude conectado, publicar es una frase: "publicá esto para el cliente". Hay tres formas de conectarlo. El connector remoto no necesita instalar nada y te loguea por el navegador. El servidor local corre con npx y una API key, para clientes que solo hablan stdio, para scripts o para crear links por destinatario desde el agente. Y la skill le enseña a cualquier agente compatible a publicar, y se conecta con un link la primera vez.

## Opción 1: el connector remoto (recomendado para empezar)

Outbox tiene un servidor MCP hospedado en https://mcp.out-box.dev/mcp. Usa OAuth: la primera vez que Claude se conecta, se abre el navegador para que entres a Outbox y apruebes qué puede hacer (leer, publicar, borrar). No hay API key para copiar ni guardar, y podés revocar el acceso desde Outbox cuando quieras.

En claude.ai o Claude Desktop, abrí Settings → Connectors, elegí Add custom connector, ponele Outbox de nombre y pegá la URL. Con el connector, Claude publica y actualiza páginas, lee lo que ya publicaste, revisa versiones y comentarios, y te dice quién abrió una página.

```
https://mcp.out-box.dev/mcp
```

## Connector remoto en Claude Code

Agregalo una vez desde la terminal y después corré /mcp dentro de Claude Code y elegí Outbox para loguearte en el navegador.

```
claude mcp add --transport http outbox https://mcp.out-box.dev/mcp
```

## Opción 2: el servidor local con npx

El paquete @out-box/mcp corre las herramientas en local por stdio. Creá una API key en Outbox en Ajustes → Keys y pasala como OUTBOX_API_KEY. No se instala nada global: npx lo descarga y lo corre.

Las versiones actuales traen por default las tools de publicar, comentarios y links compartidos (OUTBOX_TOOLSETS=core,comments,sharing); con OUTBOX_TOOLSETS=all suma carpetas, keys, equipos y automatizaciones. Para que el agente pueda crear links compartidos, la key tiene que tener ese permiso: el preset Personal lo tiene; los presets de agente (solo publicar, solo lectura, lectura y escritura) no.

```
claude mcp add outbox --env OUTBOX_API_KEY=outbox_xxxxxxxx -- npx -y @out-box/mcp
```

## Servidor local en Claude Desktop, Cursor u otros clientes

Los clientes que se configuran con un JSON usan el mismo comando. No subas la key a repos compartidos.

```
{
  "mcpServers": {
    "outbox": {
      "command": "npx",
      "args": ["-y", "@out-box/mcp"],
      "env": { "OUTBOX_API_KEY": "outbox_xxxxxxxx" }
    }
  }
}
```

## Opción 3: la skill

Si tu agente usa skills (Claude Code, Cursor, Codex, OpenCode y otros), instalá la skill de Outbox. El agente entiende pedidos como "publicá esto en mi Outbox" y, la primera vez, te pasa un link para conectar tu cuenta desde el navegador.

```
npx skills add jonathanleiva15/out-box-skills
```

## Probá que funcione

Pedile a Claude que publique una página de prueba en Outbox. Te responde con la URL y la página aparece en tu biblioteca, privada por default. Desde ahí podés pedirle que la actualice, que liste lo que publicaste o que te muestre las versiones.

Para mandársela a alguien, pedile un share link (con el servidor local o la skill) o crealo en Biblioteca → Lo que comparto, con passphrase y vencimiento. Si le ponés destinatario, cada apertura queda a su nombre y te llega un mail cuando la abre.

## ¿Cuál uso?

## Si algo no anda

En Claude Code, /mcp muestra si Outbox está conectado y te deja volver a loguearte. Un error 403 casi siempre es un permiso que la key no tiene: una key limitada a una carpeta no puede publicar fuera de ella, y una key de agente sin permiso de compartir no puede crear links. Las tools del MCP devuelven cada error con un campo fix que dice qué hacer, y el agente lo puede leer.

## Comparativas

- [Outbox vs Claude Artifacts](https://out-box.dev/es/guides/vs/claude-artifacts)
- [Outbox vs Derive](https://out-box.dev/es/guides/vs/derive)

---

Actualizado el 2026-10-11. Versión HTML: https://out-box.dev/es/guides/conectar-claude-a-outbox