Entwickler & KI-Agenten

Was ein Teammitglied in Segui kann, kann auch ein KI-Agent oder ein Skript, nach denselben Regeln und nur in deinem Workspace. Segui bietet einen MCP-Server für KI-Agenten und eine REST-API mit OpenAPI-Spezifikation. Agenten finden alles Wichtige in llms.txt.

Anmeldung

Ein Admin öffnet Einstellungen → API & KI-Agenten und klickt Agent verbinden. Segui erstellt einen API-Schlüssel (sgi_…), zeigt ihn einmal an und zeigt die Einrichtung für dein Tool mit der richtigen URL. Schick ihn bei jeder Anfrage mit:

Authorization: Bearer sgi_…

• Ein Schlüssel handelt im Namen des Admins, der ihn erstellt hat, mit den gewählten Rechten: Mitglied (Anfragen, Notizen, Aufgaben, Mitteilungen) oder Admin (auch Pipeline, Einstellungen und Formular-Links), auf Wunsch nur lesen.
• Schlüssel gelten nur in ihrem Workspace. Sie funktionieren nicht mehr, wenn sie widerrufen werden, wenn die Person, die sie erstellt hat, das Team verlässt, und solange das Abo den Workspace sperrt.
• Grenze: 120 Anfragen pro Minute und Schlüssel (HTTP 429 mit Retry-After).

Schnellstart

Die API liegt unter https://api.segui.app. Der erste Aufruf listet die Anfragen, deren nächster Schritt fällig ist, der zweite erstellt eine Anfrage, deren nächster Schritt am 1. Oktober fällig ist (reminderOn ist das Datum des nächsten Schritts).

curl -H "Authorization: Bearer $SEGUI_API_KEY" https://api.segui.app/api/v1/inquiries/due

curl -X POST https://api.segui.app/api/v1/inquiries \
  -H "Authorization: Bearer $SEGUI_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: form-4711" \
  -d '{"familyName":"Muster","firstName":"Anna","email":"anna@example.com","reminderOn":"2026-10-01"}'

MCP einrichten

Der MCP-Endpunkt ist https://api.segui.app/mcp (Streamable HTTP, zustandslos; Protokoll 2026-07-28 und die früheren 2025er-Versionen).

Claude Code

claude mcp add --transport http segui https://api.segui.app/mcp --header "Authorization: Bearer sgi_…"

Claude Desktop und claude.ai

Einstellungen → Konnektoren → Eigenen Konnektor hinzufügen. URL https://api.segui.app/mcp, Header Authorization: Bearer sgi_….

Codex

# ~/.codex/config.toml
[mcp_servers.segui]
url = "https://api.segui.app/mcp"
bearer_token_env_var = "SEGUI_API_KEY"

Hermes

# ~/.hermes/config.yaml
mcp_servers:
  segui:
    url: "https://api.segui.app/mcp"
    headers:
      Authorization: "Bearer sgi_…"

Andere MCP-Clients

{"mcpServers": {"segui": {"type": "http", "url": "https://api.segui.app/mcp",
  "headers": {"Authorization": "Bearer sgi_…"}}}}

Tools und Endpunkte

Jedes MCP-Tool gibt es auch als REST-Endpunkt unter /api/v1. Ressourcen: segui://workspace, segui://pipeline, segui://team, segui://due-today.

• Anfragen: search_inquiries, list_due_today, get_inquiry, create_inquiry, update_inquiry, move_inquiry, update_inquiry_step, set_reminder, clear_reminder, assign_advisor, unassign_advisor, mark_inquiry_lost, mark_inquiry_invoiced, delete_inquiry, restore_inquiry
• Notizen: list_notes, add_note, update_note, delete_note
• Aufgaben: list_tasks, get_task, create_task, update_task, complete_task, delete_task, restore_task
• Pipeline und Team: get_pipeline, update_pipeline, remove_stage, list_team
• Mitteilungen: list_notifications, archive_notification, archive_all_notifications
• Auswertungen (Business): get_report, export_inquiries_csv
• Workspace: get_workspace, update_workspace, list_form_links, create_form_link, revoke_form_link

Der nächste Schritt einer Anfrage ist der erste Schritt im Ablauf, der weder erledigt noch übersprungen ist. Sein Datum ist die Erinnerung: An dem Tag erscheint die Anfrage in «Heute» und in den Mitteilungen der zuständigen Personen. set_reminder setzt das Datum des nächsten Schritts, clear_reminder entfernt es, list_due_today listet die Anfragen, deren nächster Schritt fällig ist (Überfälliges zuerst), und reminderOn an einer Anfrage ist dasselbe Datum. Aufgaben sind davon getrennte interne To-dos, nicht Teil des Ablaufs.

Konventionen

• JSON rein und raus. Tage als YYYY-MM-DD, Zeitpunkte als ISO 8601.
• Listen liefern {"items": [...], "nextCursor": "..."}; für die nächste Seite cursor mitschicken.
• Beim Erstellen verhindert der Header Idempotency-Key (MCP: idempotencyKey) Doppelte: Eine Wiederholung innerhalb von 24 Stunden liefert das erste Ergebnis.
• Fehler: {"error": {"code": "NOT_FOUND", "message": "..."}} mit 400, 401, 402 (Abo oder Plan), 403 (Rechte oder nur lesen), 404, 409, 429.

OpenAPI

Die vollständige Spezifikation liegt unter https://api.segui.app/api/v1/openapi.json und entsteht aus denselben Definitionen wie die MCP-Tools.