# AI Agent Governance API und MCP Dokumentation

**Maetra** ist ein Runtime Control-Flugzeug für KI-Agenten. Verwenden Sie den REST API- oder MCP-Server, um die Arbeit auf die Aufgabe des Benutzers abzustimmen, sensible Aktionen für Richtlinien oder menschliche Zustimmung zu unterbrechen, riskante Inhalte zu scannen und Beweise dafür zu erhalten, was nach der Genehmigung passiert ist.

Neu bei Maetra? Beginnen Sie mit dem [Quickstart](https://maetra.io/de/docs/getting-started/quickstart). Verbinden Sie einen Agenten oder Assistenten? Verwenden Sie die [MCP Server Guide](https://maetra.io/de/docs/mcp-server/overview-and-connection). Benötigen Sie nur einen Endpunkt? Jump to the [API-Referenz](https://maetra.io/de/docs/reference/api-reference).

### Die drei Runtime Controls

#### Task Guard

**AI Agent Task Alignment.** Verwandeln Sie das Ziel, die Einschränkungen, den Umfang und die Erfolgskriterien des Benutzers in einen aktiven Aufgabenvertrag. Vor einer materiellen Aktion prüft Task Guard, ob die Arbeit ausgerichtet ist, unterstützt, eine Erklärung benötigt, eine Benutzerbestätigung erfordert oder neu ausgerichtet werden sollte. Danach kann es erwartete und gemeldete Effekte vergleichen.

#### Govern

**Human-in-the-Loop-Genehmigungen und Ausführungsbelege.** Bevor ein Agent Geld bewegt, Daten löscht oder einem Kunden eine E-Mail schickt, ruft er Maetra an. Genaue Richtlinien oder Entscheidungsintelligenz können die Aktion genehmigen, blockieren oder an einen Menschen weiterleiten. Eine unterzeichnete Entscheidung ist an die genaue Aktionsnutzlast gebunden, und Ausführungsquittungen können diese Genehmigung mit Versuchen und dem beobachteten Ergebnis verknüpfen.

#### Secure

**Laufzeit-Content-Scanning.** Bildschirmaufforderungen, Toolaufrufe und Modellausgaben gegen Ihre Workspace-Regeln - sofortige Injektion, Datenexfiltration, unzulässige Tools - und erhalten Sie ein Urteil zurück`safe`, `flagged`, `blocked`) und eine empfohlene Aktion. Alles, was markiert oder blockiert wird, wird zu einem Vorfall.


### Zwei Wege zur Integration

<table data-view="cards"><thead><tr><th>Schnittstelle</th><th>Am besten für</th><th></th></tr></thead><tbody><tr><td><strong>REST API</strong></td><td>Backends und Services Calling <code>/v1</code> über HTTPS.</td><td><a href="https://maetra.io/de/docs/getting-started/quickstart">Quickstart</a></td></tr><tr><td><strong>MCP Server</strong></td><td>KI-Agenten und Assistenten, die das Model Context Protocol sprechen.</td><td><a href="https://maetra.io/de/docs/mcp-server/overview-and-connection">MCP Übersicht</a></td></tr></tbody></table>

Beide werden von der gleichen Evaluation Engine unterstützt und mit dem gleichen Workspace-API-Schlüssel authentifiziert.

### Was Sie bauen können

* **Zahlungsdienstleister und Finanzdienstleister** die das genehmigte Konto, den genehmigten Betrag oder die genehmigte Währung nach Überprüfung nicht ändern können.
* **Kundendienstmitarbeiter** die vor Rückerstattungen, Kontoänderungen oder externen Nachrichten eine Pause einlegen.
* **Langzeitassistenten** die ihren Aufgabenvertrag vor wesentlichen Maßnahmen erneut überprüfen und anschließend die tatsächlichen Auswirkungen melden.
* **MCP-vernetzte Agenten** die nur die Task Guard-, Govern- und Secure-Tools entdecken, die für ihren Arbeitsbereich und API-Schlüssel aktiviert sind.

Genehmigung und Ausführung sind getrennte Tatsachen. Ein Entscheidungstoken beweist, was Maetra autorisiert hat; ein [Ausführungseingang](https://maetra.io/de/docs/govern-api/execution-receipts) zeichnet auf, wie genau diese Aktion versucht wurde und welche Wirkung Beweise beobachtet wurden.

> **Good to know**
> **Sie müssen Ihre Agenten nicht zuerst registrieren.** Jeder Endpunkt akzeptiert einen freien Text `agent_name`, so dass sie in minuten integrieren und agenten später für eine reichhaltigere berichterstattung registrieren können. Govern bewertet immer noch API-only und MCP-Agenten gegen organisationsweite Richtlinien; wenn `agent_name` oder `agent_id` Übereinstimmungen mit einem registrierten agenten, agenten-scoped richtlinien können gelten. Siehe [Agenten](https://maetra.io/de/docs/agents).


### Basis-URL

```
https://api.maetra.io
```

Alle REST Endpunkte sind versioniert unter `/v1`. Der MCP-Server hat eine eigene Basis-URL - siehe [MCP Überblick](https://maetra.io/de/docs/mcp-server/overview-and-connection).

### Nächste Schritte

1. [Erstellen Sie einen API Key](https://maetra.io/de/docs/getting-started/authentication) im Armaturenbrett.
2. [Führen Sie Ihren ersten Checkpoint und Scan](https://maetra.io/de/docs/getting-started/quickstart), [Verbinden Sie einen MCP-Client](https://maetra.io/de/docs/mcp-server/overview-and-connection), oder [Starten Sie eine Task Guard-Aufgabe](https://maetra.io/de/docs/task-guard-api/tasks-and-context).
3. Durchsuchen der [Vollständige API Referenz](https://maetra.io/de/docs/reference/api-reference).