DE
Aufgabe beschreiben

API und MCP für Partner

Geben Sie Aufgaben direkt aus Ihrer Software und Ihren KI-Assistenten an mich weiter: Aufgabe senden, Preis und Termin erhalten, zusagen - und ich beginne. Dieselbe API liefert den Katalog meiner 8 Leistungen.

Aufträge über die API

Ein API-Schlüssel ist nicht nötig. Beim Anlegen eines Auftrags erhalten Sie eine Auftragsnummer und einen Auftragsschlüssel: Damit lesen Sie den Status und antworten. Dieselben Schritte gibt es über MCP mit den Werkzeugen create_order, get_order und order_action.

  1. Sie senden die Aufgabe: POST /api/orders. Status: received.
  2. Ich lese die Aufgabe und trage Preis und Termin in den Auftrag ein. Status: quoted.
  3. Sie nehmen den Preis an (accept mit der Nummer des Preisangebots, quote_id), lehnen ab (decline) oder stellen eine Frage (message).
  4. Nach Ihrer Zusage beginne ich: Status in_work, danach delivered mit einem Link zum Ergebnis.
  5. Sie nehmen die Arbeit ab (approve) - Status closed - oder geben sie mit Anmerkungen zurück (revision): Dann steht der Auftrag wieder auf in_work.
POST /api/ordersNeuer Auftrag. Pflicht: task (bis 4.000 Zeichen), contact und consent: true. Optional: title, partner, ref (Ihre eigene Aufgabennummer), deadline, budget, service, links (bis zu 5 https-Links), lang, callback_url, idempotency_key.
GET /api/orders/{id}Status, Preis und Termin (quote), Ergebnisse (deliverables), Ereignisse, die jetzt möglichen Schritte (actions) und ein Hinweis, was als Nächstes zu tun ist (next). Benötigt den Header Authorization: Bearer mit dem Auftragsschlüssel.
POST /api/orders/{id}Ihr Schritt: action - accept (benötigt quote_id aus quote.id), decline, cancel, approve, revision oder message; message und revision brauchen text. Derselbe Header.
curl -X POST 'https://fastdev24.com/api/orders' \
  -H 'Content-Type: application/json' \
  --data '{"task":"Landingpage für eine Zahnarztpraxis: 5 Abschnitte, Anfrageformular, Texte liegen bei.","contact":"dev@example.com","consent":true,"ref":"TASK-17","idempotency_key":"<random-hex-64>","links":["https://example.com/brief.pdf"]}'
curl 'https://fastdev24.com/api/orders/ORDER_ID' -H 'Authorization: Bearer ORDER_KEY'
curl -X POST 'https://fastdev24.com/api/orders/ORDER_ID' \
  -H 'Authorization: Bearer ORDER_KEY' -H 'Content-Type: application/json' \
  --data '{"action":"accept","quote_id":"QUOTE_ID"}'

Wenn Sie über Änderungen am Auftrag informiert werden möchten, übergeben Sie callback_url: Bei jeder Aktualisierung sende ich Auftragsnummer, Status und Preis per POST an diese Adresse. Die Anfrage ist mit dem Auftragsschlüssel signiert (Header X-Order-Signature); ich versuche zweimal, sie zuzustellen. Antwortet Ihre Adresse nicht, können Sie den Stand jederzeit per GET lesen. Damit eine Wiederholung sicher ist, übergeben Sie idempotency_key - eine eigene zufällige Zeichenfolge mit mindestens 16 Zeichen: Eine wiederholte Anfrage mit demselben Schlüssel liefert denselben Auftrag.

Leistungskatalog

Nur Lesezugriff, kein API-Schlüssel nötig. Der Parameter lang legt die Sprache der Antwort fest: ru, pl, en, de, es oder fr (Standard: en). Die Antworten sind JSON mit ETag und werden 5 Minuten zwischengespeichert.

GET /api/services?lang=deListe der Leistungen: Nummer, slug, Gruppe, Titel, Ergebnis, Dauer und Preis, soweit veröffentlicht.
GET /api/services/{id}?lang=deEine Leistung nach Nummer 1-8 oder slug, z. B. web-design: Umfang, was ich von Ihnen brauche, Prüfungen, Abnahme, Fragen und Antworten.
GET /openapi.jsonOpenAPI-3.1-Beschreibung der API.
curl 'https://fastdev24.com/api/services/web-design?lang=de'

MCP-Server

Endpunkt: https://fastdev24.com/mcp. Zustandsloser Streamable-HTTP-Transport (ohne Sitzungen): Protokollversion 2026-07-28 und die früheren Versionen mit initialize 2025-11-25, 2025-06-18. Die Antworten sind einfaches JSON; einen SSE-Stream über GET gibt es nicht.

Werkzeuge

  • list_services - Liste der Leistungen in der gewählten Sprache, auf Wunsch nach Gruppe gefiltert
  • get_service - alle Angaben zu einer Leistung
  • create_request - eine Anfrage an mich: Kontaktdaten, Beschreibung der Aufgabe mit bis zu 600 Zeichen und Einwilligung in die Datenverarbeitung
  • create_order - ein neuer Auftrag: Aufgabe, Kontakt und Einwilligung; liefert Auftragsnummer und Schlüssel
  • get_order - Status des Auftrags, Preis und Termin, Ergebnisse, Ereignisse
  • order_action - Preis annehmen oder ablehnen, Auftrag stornieren, Arbeit abnehmen, zur Korrektur zurückgeben oder eine Nachricht senden

So verbinden Sie sich

Fügen Sie in einem Client, der Remote-MCP-Server unterstützt, einen Server mit dem obigen Endpunkt hinzu. Beispiel für Claude Code (.mcp.json):

{
  "mcpServers": {
    "fastdev24": {
      "type": "http",
      "url": "https://fastdev24.com/mcp"
    }
  }
}

Beispiel für die Kommandozeile: Liste der Werkzeuge. Bei Version 2026-07-28 gehören Protokollversion und Client-Fähigkeiten in _meta:

curl -X POST 'https://fastdev24.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/list' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Limits

  • Neue Aufträge: etwa 20 pro Stunde je IP-Adresse und etwa 100 pro Tag insgesamt. Request-Body: bis 32 KB für einen neuen Auftrag, 16 KB für einen Schritt. Je Auftrag: bis zu 60 Schritte pro Stunde und 20 Nachrichten pro Tag. Bewahren Sie den Auftragsschlüssel auf: Ohne ihn lässt sich der Auftrag nicht lesen. Aufträge werden 180 Tage nach der letzten Änderung gespeichert. Fragen Sie den Status höchstens alle paar Minuten ab. Bleibt ein geliefertes Ergebnis 7 Tage ohne Antwort, schließe ich den Auftrag.
  • Die Limits für Anfragen sind Näherungswerte: etwa 10 pro Stunde über das Formular und 30 über MCP je IP-Adresse, insgesamt etwa 60 pro Tag. Bei Störungen oder gleichzeitigen Anfragen können sie abweichen.
  • Senden Sie eine Anfrage erst, wenn die Person ausdrücklich eingewilligt hat: Kontaktdaten und Aufgabe kommen bei mir genauso an wie über das Formular der Website.
  • MCP-Werkzeugaufrufe sind auf etwa 60 pro Minute je IP-Adresse und Serverinstanz begrenzt. Maximale Größe des Request-Bodys: 64 KB für MCP, 16 KB für das Formular.
  • Die API antwortet auch mit 400 (bad_lang, bad_group), 404 (not_found) und 304, wenn das ETag passt. Eingabefehler bei create_request liefern isError mit einer Erklärung.
  • Der Katalog wird zusammen mit der Website aktualisiert; ein neuer Wert von version oder ein neues ETag für dieselbe Ressource und Sprache bedeutet, dass sich Daten oder Antwortformat geändert haben.