# Servidor MCP de Outbox: publicá HTML desde Claude, Cursor y Claude Code

> Conectá Outbox a cualquier cliente MCP: el connector remoto en mcp.out-box.dev con OAuth, o npx -y @out-box/mcp con una API key. Publicá, versioná, compartí y medí aperturas.

El servidor MCP de Outbox convierte tu biblioteca en herramientas nativas para Claude, Claude Code, Cursor y cualquier cliente MCP. Tu agente publica la página que acaba de armar, la vuelve a publicar con cambios, la comparte y te dice quién la abrió, sin curl ni copiar y pegar.

## Qué puede hacer tu agente

- Publicar una página desde HTML o Markdown, privada por defecto, y devolverte la URL.
- Leer una página, sumarle contexto y volver a publicarla en el mismo slug: cada publicación es una versión nueva, con rollback.
- Listar y buscar en tu biblioteca, y sumar bloques a una página diaria.
- Leer los comentarios y sugerencias que deja la gente, y aplicar los que aceptes.
- Crear [links por destinatario](https://out-box.dev/es/per-recipient-links) con vencimiento, y ver quién abrió una página.

Está publicado en npm como `@out-box/mcp` y declarado en el MCP Registry oficial como `dev.out-box/mcp`. Código: [github.com/jonathanleiva15/out-box-mcp](https://github.com/jonathanleiva15/out-box-mcp).

## Opción 1: el connector remoto (sin instalar nada)

Outbox aloja el servidor en la URL de abajo. Usa OAuth: la primera vez que tu cliente se conecta, una ventana del navegador te pide iniciar sesión en Outbox y elegir los permisos (`outbox:read`, `outbox:write`, `outbox:delete`). No hay API key para copiar. Cada conexión crea una key de agente llamada "Claude connector" que podés revocar en Ajustes → Keys.

URL del servidor:

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

En claude.ai o Claude Desktop: Settings → Connectors → Add custom connector, nombre Outbox y la URL. En Claude Code, agregalo desde la terminal y corré `/mcp` para iniciar sesión:

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

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

Para clientes que solo corren servidores locales (stdio), para CI o cuando querés una key limitada a una carpeta. Necesita Node.js 20 o superior y una API key de Ajustes → Keys; npx baja y corre el paquete, no se instala nada global.

Claude Desktop, Cursor y otros clientes con JSON:

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

Claude Code:

```
claude mcp add outbox --env OUTBOX_API_KEY=outbox_xxxxxxxx --env OUTBOX_TOOLSETS=core,comments,sharing -- npx -y @out-box/mcp
```

Acotá la key para que una filtración solo toque una carpeta: `outbox keys gen-agent --folder clientes/acme --verbs publish,list --days 30` (con la [CLI de Outbox](https://www.npmjs.com/package/@out-box/cli)). El verbo `list` deja que el agente relea sus propias páginas privadas.

## Toolsets y configuración

Las herramientas vienen agrupadas para que tu cliente cargue solo lo que usás. `OUTBOX_TOOLSETS` las elige (`core` siempre queda; `all` prende todo):

| Toolset | Qué cubre |
| --- | --- |
| core | Publicar, leer, listar, buscar, versiones, rollback, visibilidad, append al diario, borrar, quién abrió una página |
| comments | Leer comentarios y sugerencias, responder, aceptar o descartar |
| sharing | Links compartidos (destinatario, vencimiento), accesos a otros usuarios, contraseña de página, revocar |
| library | Carpetas, diffs, templates, exportar la biblioteca, chequeo de render |
| keys | API keys, keys de agente por carpeta, auditoría |
| teams | Miembros, invitaciones, grupos y keys de empresa |
| automation | Webhooks de eventos y schedules |
| apps | Visor interactivo de páginas para clientes con MCP Apps |

Otras variables: `OUTBOX_LANG` (descripciones en `en` o `es`), `OUTBOX_FILES_DIR` (la única carpeta donde el servidor lee y escribe archivos, `~/Outbox` por defecto) y `OUTBOX_USER`.

## Seguridad incluida

- Las herramientas destructivas (borrar, rollback, revocar, aceptar una sugerencia) llevan `destructiveHint`, así los clientes que lo respetan te piden confirmación.
- Los comentarios y sugerencias de otras personas vuelven como texto no confiable: el servidor le indica al modelo que son datos, nunca instrucciones.
- Si una página que publicás parece tener credenciales, el resultado trae un aviso con el tipo y la línea (nunca el valor).
- El servidor se niega a rotar o revocar la key con la que está corriendo.

## ¿Preferís la skill o la CLI?

Los agentes con skills (Claude Code, Cursor, Codex y otros) pueden usar la skill `outbox-publish`; la primera vez que publica, te da un link para conectar tu cuenta:

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

Scripts y CI pueden usar la CLI (`npm install -g @out-box/cli` y después `outbox setup`) o la API REST. Todo escribe en la misma biblioteca. Configuración por agente: [Claude Code](https://out-box.dev/es/agents/claude-code), [Claude](https://out-box.dev/es/agents/claude), [Cursor](https://out-box.dev/es/agents/cursor), [Codex](https://out-box.dev/es/agents/codex), [ChatGPT](https://out-box.dev/es/agents/chatgpt).

## Preguntas frecuentes

### ¿Connector remoto o npx?

El connector remoto cuando tu cliente soporta servidores MCP remotos: no hay key que cuidar y revocás el acceso desde Outbox. npx para clientes solo stdio, CI y scripts, o cuando querés una key acotada a una carpeta.

### ¿El servidor MCP cuesta algo?

No. Es gratis y open source; lo que publicás cuenta contra los límites de tu plan de Outbox, y hay plan gratis.

### ¿El agente puede leer mis páginas privadas?

Solo con una key que lo permita: leer privadas necesita el verbo `list` (o la carpeta correspondiente). Sin eso puede publicar pero no releer.

### ¿Se usa mi contenido para entrenar modelos?

No. Outbox no manda tus páginas a proveedores de IA y no se usan para entrenar.

## Relacionado

- [Conectar Claude a Outbox (paso a paso)](https://out-box.dev/es/guides/conectar-claude-a-outbox)
- [Links por destinatario](https://out-box.dev/es/per-recipient-links)
- [Publicar desde tu agente](https://out-box.dev/es/agents)
- [@out-box/mcp en npm](https://www.npmjs.com/package/@out-box/mcp)

---

Actualizado el 2026-10-11. Versión HTML: https://out-box.dev/es/mcp