API & MCP — contrata al agente desde cualquier lugar

OnePress expone una superficie deliberadamente pequeña: envía una tarea, consulta el resultado, continúa la conversación. Suficiente para scripts, otros agentes y hosts MCP como Claude Code.

Obtén una API key

En la app: Settings → Account → API keys → Create. La clave se muestra una sola vez (empieza con opk_) — guárdala en tu entorno, no en el código. Revoca cualquier clave desde la misma página; hasta 10 claves activas.

Cada petición se cobra de tus propios créditos, exactamente igual que el chat — y cada clave está limitada a 60 peticiones por minuto.

REST API

Tres llamadas cubren todo el contrato:

Crea una tarea

curl -X POST https://www.getonepress.com/api/v1/conversations \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Research the AI coding-agent market and draft a one-page brief"}'
# → 202 {"conversationId": "conv_…", "injected": false}

Consulta el resultado

curl https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY"
# → {"status": "running"|"done", "answer": "…", "preview_path": "…"}

Cuando status es "done", answer lleva el resumen del agente y preview_path nombra el entregable en tu workspace — ábrelo en la app para previsualizar, compartir o exportar.

Continúa la conversación

curl -X POST https://www.getonepress.com/api/v1/conversations/conv_… \
  -H "Authorization: Bearer $ONEPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "make the brief punchier"}'

Los follow-ups conservan todo el contexto. Si una ejecución sigue activa, el mensaje se inyecta en el siguiente turno ("injected": true) — sigue consultando la misma conversación.

Dispara desde Zapier, Make o n8n

Cualquier herramienta que pueda enviar una petición HTTP puede contratar al agente — las mismas tres llamadas funcionan como webhook. En Zapier usa Webhooks → POST, en Make un módulo HTTP → Make a request:

URL	https://www.getonepress.com/api/v1/conversations
Method	POST
Headers	Authorization: Bearer opk_… Content-Type: application/json
Body	{"message": "Summarize this new row: {{fields}}", "title": "from Zapier"}

Mapea cualquier campo de la app disparadora a message — una nueva fila de Airtable, un pago de Stripe, un envío de formulario — y la ejecución arranca de inmediato. Consulta el conversationId devuelto en un segundo paso si necesitas el resultado de vuelta en el mismo Zap.

Servidor MCP

¿Prefieres herramientas sobre REST? Apunta cualquier host compatible con MCP al endpoint y obtiene tres herramientas — onepress_create_task, onepress_task_status, onepress_list_tasks:

{
  "mcpServers": {
    "onepress": {
      "url": "https://www.getonepress.com/api/mcp",
      "headers": { "Authorization": "Bearer opk_..." }
    }
  }
}

Ahora otros agentes pueden contratar al tuyo — "usa onepress para hacer ese deck" funciona desde Claude Code, Cursor o cualquier host MCP.

Errores que vale la pena manejar

Estado	Significado
401	Clave ausente o revocada
402	Sin créditos — recarga en Settings
409	Conversación ocupada — mensaje en cola, sigue consultando
429	Límite de peticiones (60 req/min) o demasiadas ejecuciones activas — retrocede

Lo que la API deliberadamente no hace

Sin descargas de archivos del workspace, sin streaming, sin conversaciones de grupo — por ahora. El contrato es "envía una tarea, obtén el resultado" y solo crecerá, nunca se romperá. Dinos qué necesitas en support [at] getonepress.com; el uso real da forma a la próxima superficie.

Una clave, treinta segundos

Settings → Account → API keys → Create. Luego ejecuta el curl de arriba y mira tu primera tarea en marcha.

Abrir la app