Zu REZICS

Entwickler

Dein KI-Agent verbindet sich über /mcp.

REZICS stellt unter /mcp einen entfernten MCP-Server bereit. Der Agent verbindet sich mit deinem autorisierten Token. Die angezeigten Werkzeuge richten sich nach seinen aktuellen Berechtigungen. Jedes Werkzeug entspricht einem HTTP-Vorgang.

Weiterleitung

MCP leitet Anfragen weiter. Es ist kein eigener Schreibweg.

Jeder Werkzeugaufruf wird genau einmal an den entsprechenden HTTP-Vorgang weitergeleitet, mit demselben Token und Idempotenzschlüssel. Der Vorgang bestimmt, wer handelt, was erlaubt ist und wie viel Anfragebudget verbraucht wird.

Werktexte und Webseiten, die ein Werkzeug liest, gelten immer als Daten und nie als Anweisungen.

Durch eine Reihe runder Löcher in dunkelblaugrauem Papier läuft ein hellblauer Streifen abwechselnd hindurch.

Verbindung

Vier Schritte zur Verbindung

  • Ressourcenmetadaten lesen

    GET /.well-known/oauth-protected-resource/mcp

    Anfragen ohne Token erhalten 401. Der Header verweist auf diese Metadaten mit Angaben zum Autorisierungsserver und den unterstützten Berechtigungsbereichen.

  • Registrieren und Token erhalten

    RFC 7591 · PKCE

    Der Client eines Agenten kann sich selbst registrieren und mit Authorization Code und PKCE ein Token erhalten. Die Registrierung verleiht keine Berechtigungen für Ressourcen.

  • Werkzeuge auflisten

    tools/list

    Die Liste enthält nur Werkzeuge, die diese Identität gerade verwenden darf.

  • Werkzeug aufrufen

    tools/call

    Das Ergebnis enthält unverändert den HTTP-Statuscode, die Header und den Inhalt. Statuscodes ab 400 werden als Fehler markiert.

Derselbe Vorgang

Der Agent wird an denselben HTTP-Vorgang weitergeleitet.

  • Programm

    GET /v1/search/catalogue
  ?q=Reise&limit=5

  • Agent

    {
  "name": "search_catalogue",
  "arguments": {
    "query": {
      "q": "Reise",
      "limit": 5
    }
  }
}
    Diese Parameter werden mit tools/call gesendet.

Dieselbe Antwort

operationId
  getV1SearchCatalogue
profile
  public-catalogue-ranked-v1

Beispiel: Suche im Verzeichnis nach „Reise“. Der Agent erhält dieselbe Antwort, ergänzt um HTTP-Statuscode und Header. Die Parameter sind nach path, query, headers und body gruppiert.

Werkzeuge

Werkzeugliste

Werkzeuge werden aus den Fähigkeitsdeklarationen der API erstellt. Darin stehen Name, Zweck und benötigte Berechtigungsbereiche. Doppelte Namen oder fehlende Vorgänge führen zu einem Fehler.

Verzeichnis lesen

  • search_catalogue

    Im Verzeichnis nach Stichworten suchen

    GET /v1/search/catalogue · work:read

  • read_resource

    Eine Ressource lesen

    GET /v1/resources/{resource} · work:read context:read

  • resource_summaries

    Zusammenfassungen mehrerer Ressourcen lesen

    POST /v1/resources/summaries · work:read context:read

  • resource_relations

    Verknüpfungen einer Ressource lesen

    GET /v1/resources/{resource}/relations · work:read

  • work_editions

    Versionen eines Werks lesen

    GET /v1/works/{id}/releases · work:read

Bibliothek

  • library_export

    Die ganze Bibliothek exportieren

    GET /v1/me/library-export · work:read rating:read

  • library_import_create

    Eine Bibliotheksdatei hochladen

    POST /v1/me/library-imports · work:read library:write

  • library_import_rows

    Abgleiche Zeile für Zeile ansehen

    GET /v1/me/library-imports/{id}/rows · work:read

  • library_import_resolve

    Ein Werk für eine Zeile auswählen

    PUT /v1/me/library-imports/{id}/rows/{row} · work:read library:write

  • library_import_adopt

    Ein vorgeschlagenes Werk außerhalb des Verzeichnisses übernehmen

    POST /v1/me/library-imports/{id}/rows/{row}/adoptions · work:read library:write work:create

  • library_import_apply

    Den geprüften Import anwenden

    POST /v1/me/library-imports/{id}/apply · work:read library:write collection:edit rating:read rating:submit

  • library_import_status

    Importfortschritt ansehen

    GET /v1/me/library-imports/{id}/apply · work:read

  • library_import_delete

    Die hochgeladene Datei löschen

    DELETE /v1/me/library-imports/{id} · work:read library:write

Wiki

  • wiki_candidates

    Extrahierte Namen abgleichen

    POST /v1/wiki/candidates · wiki:propose

  • wiki_validate

    Eine Extraktion vorab prüfen

    POST /v1/wiki/validations · wiki:propose

  • wiki_history

    Angenommene Wiki-Inhalte lesen

    GET /v1/wiki/{work}/history · work:read

  • wiki_evidence

    Quellen und Zitate eines Eintrags lesen

    GET /v1/wiki/evidence/{id} · work:read

Grenzen

Grenzen für jeden Aufruf

  • 30 Sekunden

    Zeitlimit für jeden Werkzeugaufruf.

  • 1 MiB

    Maximale Größe normaler Werkzeuganfragen. Bibliotheksdateien zählen gesondert.

  • Zustandslos

    Jede Anfrage prüft das Token erneut. Der Server speichert keine Sitzung.

Entwickler

Weitere Seiten

Schreibe eigene Werkzeuge mit derselben API.

Lass dein Programm Werke, deine Bibliothek und Community-Daten lesen und schreiben. Jeder Vorgang folgt denselben Identitäts- und Berechtigungsregeln von REZICS.

Zu REZICS

Produkte

Module

Sprache