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

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 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.

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.

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.

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

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). 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):

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, Claude, Cursor, Codex, ChatGPT.

Preguntas frecuentes

Relacionado

• Conectar Claude a Outbox (paso a paso)
• Links por destinatario
• Publicar desde tu agente
• @out-box/mcp en npm