Einrichtung mit KI

Ein Agent oder Ihr Terminal schlägt die Einrichtung des Kontos vor; eine Person prüft und übernimmt sie.

Cord liest die Website eines Unternehmens, eine Beschreibung in eigenen Worten und seine Preisliste und erstellt daraus einen Einrichtungsvorschlag: Profildaten, Marke, Steuern, Produktkatalog, Nachrichtenvorlagen und Angebotseinstellungen. Es ist derselbe Assistent wie im Onboarding und unter Einstellungen, für Entwickler über drei Zugänge erreichbar:

Zugang	Wie
REST-API	`POST /api/v1/setup/plans` und `GET /api/v1/setup/plans/{id}`
CLI	`cord setup` (siehe CLI)
MCP-Server	Die Tools `proponer_configuracion` und `estado_configuracion` (siehe MCP-Server)

Die KI übernimmt nie etwas

Keiner der drei Zugänge ändert das Konto. Alle geben eine review_url zurück: eine Seite der App, auf der eine angemeldete Person mit der Berechtigung Einstellungen den Vorschlag prüft, ihn bearbeiten kann und ihn übernimmt oder verwirft. Der Vorschlag richtet immer das echte Konto ein, zu dem der Schlüssel gehört, auch wenn es ein Testschlüssel ist.

Eine Einrichtung vorschlagen

Senden Sie mindestens eines der drei Felder:

Feld	Typ	Detail
`sitio`	string	Die Website des Unternehmens, zum Beispiel `materialesdelvalle.mx`. Cord liest Texte, Farben, Logo, E-Mail-Adressen und Telefonnummern. Bis zu 300 Zeichen.
`descripcion`	string	Was das Unternehmen tut, wie es Zahlungen erhält und welche Steuern es erhebt oder einbehält, in eigenen Worten. Bis zu 4.000 Zeichen; der Rest wird abgeschnitten.
`archivo`	object	Die Preisliste: `{ "nombre": "prices-2026.csv", "base64": "..." }`. Excel (`.xlsx`), CSV, PDF oder ein Foto (PNG oder JPG), bis zu 3 MB vor der Kodierung.

curl https://cordhq.app/api/v1/setup/plans \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sitio": "materialesdelvalle.mx",
    "descripcion": "We sell building materials on 30-day credit and withhold 4% VAT on freight."
  }'

So fügen Sie die Preisliste aus dem Terminal hinzu:

curl https://cordhq.app/api/v1/setup/plans \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d "{\"sitio\":\"materialesdelvalle.mx\",\"archivo\":{\"nombre\":\"prices.csv\",\"base64\":\"$(base64 < prices.csv | tr -d '\n')\"}}"

Die Antwort ist 201 Created:

{
  "data": {
    "object": "setup_plan",
    "id": "c7a2e9d1-4b6f-4f0a-8e3c-2d9b1a5f7e64",
    "estado": "propuesto",
    "review_url": "https://cordhq.app/app/setup/c7a2e9d1-4b6f-4f0a-8e3c-2d9b1a5f7e64",
    "resumen": "Building materials distributor with 30-day credit and VAT withholding on freight.",
    "conteos": { "perfil": 3, "marca": 2, "cotizaciones": 1, "impuestos": 1, "productos": 42, "plantillas": 2 },
    "avisos": [],
    "descartado": [
      { "campo": "perfil.telefono", "motivo": "No es un teléfono válido." }
    ]
  }
}

Feld	Was es ist
`review_url`	Die Seite, auf der eine Person den Vorschlag prüft und übernimmt. Geben Sie sie an die Person weiter, die das Konto verwaltet.
`resumen`	Eine Zeile mit dem, was Cord über das Unternehmen verstanden hat. Sie ist in der Sprache des Kontos verfasst.
`conteos`	Wie viele Änderungen jeder Abschnitt enthält.
`avisos`	Was nicht gelesen werden konnte, zum Beispiel eine Website, die nicht geantwortet hat, oder eine Liste mit Spalten, die nicht erkannt wurden. Der Vorschlag wird trotzdem mit dem Rest erstellt.
`descartado`	Daten, die die KI vorgeschlagen hat und die die Validierung von Cord nicht bestanden haben (Steuerformat, Steuersätze, Preise). Sie gelangen nie in den Vorschlag.

Cord schlägt nur vor, was die Quelle belegt: eine Steuernummer nur, wenn sie wörtlich vorkommt, ein Produkt nur, wenn es einen Preis hat, und eine Steuer nur, wenn sie noch nicht in Ihrem Katalog ist. Jeder Wert durchläuft dieselben Länderregeln wie in den Einstellungen.

Den Status abfragen

curl https://cordhq.app/api/v1/setup/plans/c7a2e9d1-4b6f-4f0a-8e3c-2d9b1a5f7e64 \
  -H "Authorization: Bearer sk_test_..."

{
  "data": {
    "object": "setup_plan",
    "id": "c7a2e9d1-4b6f-4f0a-8e3c-2d9b1a5f7e64",
    "estado": "aplicado",
    "review_url": "https://cordhq.app/app/setup/c7a2e9d1-4b6f-4f0a-8e3c-2d9b1a5f7e64",
    "resultado": [
      { "seccion": "perfil", "ok": true, "detalle": "6 ajustes" },
      { "seccion": "impuestos", "ok": true, "detalle": "1 de 1" },
      { "seccion": "productos", "ok": true, "detalle": "40 nuevos, 2 actualizados" },
      { "seccion": "plantillas", "ok": true, "detalle": "2 de 2" }
    ],
    "created_at": "2026-10-07T16:20:41.512Z",
    "aplicado_at": "2026-10-07T16:24:03.007Z",
    "expira_at": "2026-10-14T16:20:41.512Z"
  }
}

`estado`	Bedeutung
`generando`	Cord erstellt den Vorschlag noch.
`propuesto`	Fertig und wartet darauf, dass eine Person ihn unter `review_url` prüft.
`aplicado`	Eine Person hat ihn übernommen. `resultado` enthält eine Zeile pro Abschnitt mit `ok` und `detalle`; ist ein Abschnitt fehlgeschlagen, werden die übrigen trotzdem übernommen.
`descartado`	Eine Person hat ihn verworfen. Es wurde nichts geändert.
`fallido`	Der Vorschlag konnte nicht fertiggestellt werden, oder beim Übernehmen sind alle Abschnitte fehlgeschlagen.

resultado ist null, bis der Vorschlag übernommen wird. Um auf die Entscheidung zu warten, fragen Sie alle paar Sekunden ab (die CLI tut das alle 3) und hören Sie bei aplicado, descartado oder fallido auf.

Limits

Limit	Wert
Vorschläge pro Organisation	6 pro Tag, API, CLI, MCP und App zusammengerechnet. Der siebte gibt `429` mit `code: "rate_limited"` zurück.
Gültigkeit	7 Tage (`expira_at`). Ein abgelaufener Vorschlag kann nicht mehr übernommen werden; erstellen Sie einen neuen.
Datei	3 MB vor der Base64-Kodierung. Größere Dateien geben `413` zurück.
Vorgeschlagener Katalog	Bis zu 500 Produkte, 6 Steuern und 4 Vorlagen.

Fehler

Situation	Antwort
Sie haben weder `sitio` noch `descripcion` noch `archivo` gesendet	`400`, `code: "invalid_request"`
Die Datei ist weder Excel noch CSV, PDF oder Foto, oder sie ist leer	`400`, `code: "invalid_request"`, mit dem Grund in `error`
Die Datei ist größer als 3 MB	`413`, `code: "invalid_request"`
Heute wurden bereits 6 Vorschläge erstellt	`429`, `code: "rate_limited"`
Cord konnte den Vorschlag nicht fertigstellen	`502` mit der Meldung in `error`; der Vorschlag bleibt auf `fallido`
Die `id` existiert in Ihrem Konto nicht	`404`, `code: "not_found"`

Schlüssel und Berechtigungen

Für einen Vorschlag ist Schreibrecht auf die Ressource setup nötig, für die Statusabfrage Leserecht. Ein eingeschränkter Schlüssel nur mit setup genügt. Der Schlüssel, den cord login ausgibt, enthält es bereits.
Die Prüfseite erfordert eine Sitzung mit der Berechtigung Einstellungen in diesem Konto. Niemand sonst kann übernehmen.
Das Übernehmen wird im Audit-Log der Organisation mit der Person festgehalten, die es ausgeführt hat.

Über die CLI

npx @flouviahq/cli setup --sitio materialesdelvalle.mx --archivo prices.xlsx

Die CLI sendet den Vorschlag, öffnet review_url in Ihrem Browser und wartet auf Ihre Entscheidung. Sobald Sie ihn freigeben, gibt sie das Ergebnis pro Abschnitt aus. Mit Enter beenden Sie das Warten, ohne etwas abzubrechen: Der Vorschlag wartet 7 Tage lang unter dem Link auf Sie.

Über einen Agenten (MCP)

proponer_configuracion nimmt sitio, descripcion, archivo_base64 und archivo_nombre entgegen und gibt dasselbe zurück wie die API (id, estado, review_url, resumen, conteos, avisos, descartado). estado_configuracion nimmt die id entgegen und gibt estado, review_url, resultado, creada, aplicada und vence zurück. Der Agent muss die review_url an die Person weitergeben: Er hat keine Möglichkeit, den Vorschlag selbst zu übernehmen.