Bezug auf die Werkzeuge

Der Maetra-MCP-Server zeigt ein fähigkeitsabhängiges Tool-Set. Anruf tools/list um die Tools zu finden, die für den aktuellen Arbeitsbereich und den API-Schlüssel verfügbar sind.

Aufrufen eines Tools mit tools/call:

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "check_task_alignment",
    "arguments": {
      "mcp_access_token": "<token from get_mcp_access>",
      "session_ref": "conversation_01JY8Q",
      "action": "Edit the refund approval route"
    }
  }
}

Zugangsvorflug#

get\ mcp\ access

Erforderlicher erster Aufruf für jeden neuen Benutzerwechsel oder Arbeitszyklus, nach Kontextverdichtung oder Neustart und immer dann, wenn Maetra eine Aktualisierung des Zugriffs anfordert. Keine Argumente.

Die Antwort enthält:

{
  "name": "get_mcp_access",
  "arguments": {}
}

Anmerkung: Jedes Werkzeug unten erfordert ein zusätzliches String-Argument, mcp_access_token, mit dem aktuellen Token zurückgegeben von get_mcp_access.

Task Guard Werkzeuge#

start\ task

Starten oder Übergang zur aktuellen benutzerautorisierten Task Guard-Task.

Nach dem Start, behalten task.id, contract_versionund den zurückgebrachten Anker.

get\ task\ context

Holen Sie den aktiven Task Guard-Vertrag nach dem Start, der Verdichtung, dem Neustart oder wenn der Kontext veraltet ist.

check\ task\ alignment

Überprüfen Sie eine vorgeschlagene materielle Aktion gegen die aktive Aufgabe, bevor Sie sie ausführen.

Folgen Sie der Rückkehr verdict und next_action genau. Siehe Angleichungsurteile.

explain\ task\ relationship

Beschränkte Beweise liefern, wenn check_task_alignment Rücksendungen NEEDS_EXPLANATION.

Die Antwort ist eine neue Anpassungsentscheidung. Folgen Sie seinem Urteil.

record\ task\ progress

Notieren Sie einen kompakten Meilenstein für die aktive Aufgabe.

Prüfen Sie alle new_dependencies Posten mit check_task_alignment bevor sie danach handeln.

record\ action\ effekt

Melden Sie, was eine zuvor überprüfte Aktion tatsächlich geändert hat.

Wenn effect_aligned ist falsch, hör auf, die arbeit zu erweitern und frage den sitzungsbenutzer inline.

full\ task

Schließen Sie die aktive Task Guard-Aufgabe ab, wenn die Ziel- und Erfolgskriterien erfüllt sind.

Secure Werkzeuge#

check\ action

Scannen Sie eine AI-Agent-Eingabeaufforderung, einen Werkzeugaufruf oder eine Ausgabe mit Maetra Secure. Rücken POST /v1/secure/scan.

Ehrung safe, flagged, oder Blockiert Bevor wir fortfahren.

list\ active\ rules

Liste aktive Secure-Regeln auf. Keine Argumente darüber hinaus mcp_access_token.

create rule

Erstellen Sie eine Secure-Regel. Neue Regeln standardmäßig draft.

update rule

Aktualisieren Sie eine bestehende Secure-Regel nach ID. id ist erforderlich; jedes Create-Rule-Feld ist optional und nur eingereichte Felder ändern sich.

Govern Werkzeuge#

request

Fordern Sie einen Govern-Checkpoint an, bevor Sie eine Folgemaßnahme durchführen. Rücken POST /v1/checkpoints.

Wenn die Antwort anhängigWeiterlesen über Polling with get_approval_status. Eine genehmigte Antwort ist die Entscheidung; Anruf authorize_execution unmittelbar vor der externen Aktion, um diese Genehmigung einmal zu konsumieren.

Eine genehmigte Antwort beinhaltet die unterzeichnete decisionToken, kanonisch actionEnvelope, actionEnvelopeHash, policyDigest, genau policyVersions, token lifecycle timestamps und die erwarteten ausführungs- und wirkungsfristen. Maetra führt diese Felder automatisch in die MCP-Ausführungswerkzeuge, wenn Sie die Checkpoint-ID angeben.

get\ approval\ status

Long-Poll ein Govern Checkpoint.

Pollen bis genehmigt, rejected, expired, Blockiert, oder cancelled.

list\ active\ policies

Listen Sie aktive Govern-Richtlinien auf, einschließlich der Frage, ob jede genaue Regeln oder Entscheidungsintelligenz verwendet. Keine Argumente darüber hinaus mcp_access_token.

authorize\ ausführung

Verbrauchen Sie eine genehmigte Entscheidungsfähigkeit einmal, unmittelbar vor der genauen Anbieteranfrage. Maetra lädt den Checkpoint neu, überprüft die unterzeichnete Entscheidung und den kanonischen Aktionsumschlag und erstellt einen unterzeichneten Ausführungsbeleg.

Rufen Sie den Anbieter nicht zuerst an. Eine geänderte Anfrage, ein falscher Vollstrecker, eine abgelaufene oder widerrufene Entscheidung oder eine zweite unabhängige Verwendung schlägt fehl. Provider-Retributionen bleiben unter den zurückgegebenen executionId.

record\ execution\ versuch

Fügen Sie einen unveränderlichen Anbieterversuch an die autorisierte Ausführung an. Aufzeichnung von Erfolgen, Misserfolgen, Timeouts und Wiederholungen gegen dieselben execution_id.

Ein gescheiterter oder unbekannter Versuch verbraucht keine andere Entscheidung. Wiederholen Sie nur die identische autorisierte Aktion und notieren Sie dann die nächste Versuchsnummer.

record\ execution\ effect

Fügen Sie den nach der Hinrichtung beobachteten Zustand hinzu. Dies verbindet die genehmigte Aktion und den Anbieterversuch mit dem, was sich tatsächlich geändert hat.

Selbstberichtete Beobachtungen bleiben gekennzeichnet unverified. Unabhängige verifizierungsmethoden erfordern, dass ihr konfigurierter verifier den beweis validiert; der anrufer kann eine nicht verifizierte beobachtung nicht in einen verifizierten beleg umwandeln, indem er einen booleschen festlegt.

Mehrfachkontrollen bestellen#

Für die gleiche materielle Aktion:

1. Anruf check_task_alignment Wenn Task Guard aktiviert ist.
2. Anruf check_action vor der Verarbeitung nicht vertrauenswürdiger Inhalte oder der Ausführung des Toolaufrufs.
3. Anruf request_approval vor der externen Aktion, wenn Govern aktiviert ist.
4. Umfrage, bis die Entscheidung terminal ist; stoppen, es sei denn, es ist genehmigt.
5. Anruf authorize_execution unmittelbar vor der genauen Anbieteranfrage.
6. Ausführen nur nach Autorisierung erfolgreich, dann aufrufen record_execution_attempt Für jeden Provider-Versuch.
7. Anruf record_execution_effect mit dem resultierenden beobachteten Zustand.
8. Anruf record_action_effect wenn die Task Guard-Effekt-Berichterstattung aktiviert ist.

Die Task Guard-Inline-Bestätigung ersetzt nicht die Govern-Genehmigung und die Govern-Genehmigung ersetzt nicht die One-Use-Ausführungsautorisierung.