API & MCP — beauftrage den Agent von überall

OnePress bietet eine bewusst kleine Oberfläche: eine Aufgabe senden, das Ergebnis pollen, die Unterhaltung fortsetzen. Genug für Skripte, andere Agents und MCP-Hosts wie Claude Code.

API-Key holen

In der App: Settings → Account → API keys → Create. Der Key wird einmal angezeigt (er beginnt mit opk_) — leg ihn in deiner Umgebung ab, nicht im Code. Jeden Key kannst du auf derselben Seite widerrufen; bis zu 10 aktive Keys.

Jede Anfrage wird von deinen eigenen Credits abgerechnet, genau wie im Chat — und jeder Key ist auf 60 Anfragen pro Minute begrenzt.

REST-API

Drei Aufrufe decken den ganzen Vertrag ab:

Eine Aufgabe erstellen

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}

Das Ergebnis pollen

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

Wenn status "done" ist, trägt answer die Zusammenfassung des Agent und preview_path nennt das Deliverable in deinem Workspace — öffne es in der App zur Vorschau, zum Teilen oder Exportieren.

Die Unterhaltung fortsetzen

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"}'

Follow-ups behalten den vollen Kontext. Läuft ein Run noch, wird die Nachricht in den nächsten Turn injiziert ("injected": true) — polle dieselbe Unterhaltung weiter.

Auslösen aus Zapier, Make oder n8n

Jedes Tool, das eine HTTP-Anfrage senden kann, kann den Agent beauftragen — dieselben drei Aufrufe funktionieren als Webhook. In Zapier nutze Webhooks → POST, in Make ein HTTP → Make a request-Modul:

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

Mappe beliebige Felder aus der Trigger-App in message — eine neue Airtable-Zeile, eine Stripe-Zahlung, eine Formular-Einreichung — und der Run startet sofort. Polle die zurückgegebene conversationId in einem zweiten Schritt, wenn du das Ergebnis im selben Zap zurückbrauchst.

MCP-Server

Tools statt REST? Richte einen beliebigen MCP-fähigen Host auf den Endpunkt, und er bekommt drei Tools — onepress_create_task, onepress_task_status, onepress_list_tasks:

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

Jetzt können andere Agents deinen beauftragen — „nutze onepress, um das Deck zu bauen" funktioniert aus Claude Code, Cursor oder jedem MCP-Host.

Fehler, die sich zu behandeln lohnen

Status	Bedeutung
401	Fehlender oder widerrufener Key
402	Keine Credits mehr — in Settings aufladen
409	Unterhaltung beschäftigt — Nachricht eingereiht, weiter pollen
429	Rate-Limit (60 req/min) oder zu viele aktive Runs — Tempo reduzieren

Was die API bewusst nicht tut

Noch keine Workspace-Datei-Downloads, kein Streaming, keine Gruppen-Unterhaltungen. Der Vertrag lautet „Aufgabe einreichen, Ergebnis bekommen" und wird nur wachsen, nie brechen. Sag uns, was du brauchst, unter support [at] getonepress.com; echte Nutzung formt die nächste Oberfläche.

Ein Key, dreißig Sekunden

Settings → Account → API keys → Create. Dann führe das curl oben aus und sieh deiner ersten Aufgabe beim Laufen zu.

App öffnen