> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MAIP-Integrationen

> Verbinden Sie Ihre KI-Agenten mit den Tools und Plattformen, die Ihr Team bereits verwendet.

# MAIP-Integrationen

Das Machine Agent Identity Protocol (MAIP) wird mit Integrationen geliefert, die Agentenidentität, Belege und Vertrauensbewertung in Ihre bestehenden Workflows bringen. Lokale Nachweise, das Einreichen von gehosteten Belegen und die Signaturverifikation sind separate Vorgänge. Konfigurieren und testen Sie die von Ihnen verwendete Integration; die Installation allein erstellt keinen vollständigen Audit-Trail.

> [!NOTE]
>
> **Voraussetzungen:** Sie benötigen ein Truthlocks-Konto mit einem API-Schlüssel und mindestens einem registrierten Agenten. Informationen zur Registrierung Ihres ersten Agenten finden Sie im [Leitfaden zur Maschinenidentität](https://docs.truthlocks.com/de/guides/machine-identity.md).

> [!TIP]
>
> Durchsuchen Sie die verfügbaren Integrationen im [Integrations-Hub](https://truthlocks.com/resources/integrations). Links sind nach SDK, AI-Framework, Editor und Kollaborationstool gruppiert.

## Entwicklertools

### VS Code-Erweiterung

Ein Seitenbereich zum Durchsuchen von Belegen, zum Generieren von Belegen aus Ihrem Editor und zum Anzeigen von Vertrauensdaten. Installieren Sie es vom [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=truthlocks.maip-vscode).

**Was es tut:**

* MAIP-Belege über die Seitenleiste durchsuchen und suchen
* Belege für Codeänderungen direkt aus dem Editor generieren
* Vertrauenswerte von Agenten und Belegketten anzeigen

**Installation:**

1. Öffnen Sie VS Code und gehen Sie zur Erweiterungsansicht (`Ctrl+Shift+X` / `Cmd+Shift+X`).
2. Suchen Sie nach „Truthlocks MAIP“.
3. Klicken Sie auf **Installieren**.

Alternativ von der Kommandozeile installieren:

```bash theme={null}
code --install-extension truthlocks.maip-vscode
```

Nach der Installation öffnen Sie das MAIP-Seitenleistenfenster und geben Sie Ihren API-Schlüssel und Ihre Agenten-ID ein, um eine Verbindung herzustellen.

### JetBrains-Plugin

MAIP-Integration für IntelliJ, PyCharm und WebStorm mit den gleichen Funktionen zum Durchsuchen und Generieren von Belegen wie die VS Code-Erweiterung.

### Neovim-Plugin

Installieren Sie das veröffentlichte `truthlocks/maip.nvim` Plugin, mit curl verfügbar in Ihrem PATH:

```lua theme={null}
-- lazy.nvim
{ "truthlocks/maip.nvim", tag = "v1.1.0", main = "maip",
  opts = {
    api_url = "https://sandbox-api.truthlocks.com/v1",
    api_key = vim.env.MAIP_API_KEY or "",
    agent_id = vim.env.MAIP_AGENT_ID or "",
    auto_receipt_on_commit = false,
    telescope = false,
  } }
```

Verwenden Sie `:MAIPListAgents`, `:MAIPCreateReceipt`, `:MAIPListReceipts`,
`:MAIPVerifyReceipt`, `:MAIPShowTrust` und `:MAIPDashboard`. Metadaten der Quittung sind
keine verifizierte Signatur. Automatische Commit-Belege sind Opt-in und beachten unterstützte
abgeschlossene Commit-Ereignisse; es gibt in dieser Version keine `auto_receipt` Speicheroption.
Siehe die [versionierte README](https://github.com/truthlocks/maip.nvim) für Telescope
Konfiguration und die aktuellen interaktiven Testgrenzen.

### MCP-Server

Installieren Sie die ausführbare Datei auf dem Computer, auf dem Ihr MCP-Host läuft:

```sh theme={null}
npm install --global @truthlocks/maip-mcp-server@1.2.4
```

```json theme={null}
{
  "mcpServers": {
    "truthlocks": {
      "command": "maip-mcp-server",
      "env": {
        "MAIP_API_URL": "https://sandbox-api.truthlocks.com/v1",
        "MAIP_API_KEY": "REPLACE_WITH_WORKSPACE_TEST_KEY",
        "MAIP_TIMEOUT_MS": "30000",
        "MAIP_MAX_RETRIES": "3"
      }
    }
  }
}
```

Geben Sie Anmeldeinformationen über die sichere Konfiguration des Hosts an. Verwenden Sie einen Schlüssel und einen Agenten
aus derselben Umgebung. Bitten Sie den Host, die verfügbaren Tools aufzulisten, und verwenden Sie dann
`maip_list_agents`, `maip_list_receipts` und `maip_verify_receipt`. Eine positive Signatur
Ergebnis erfordert `valid: true`, `signature_verified: true` und `verdict: "VALID"`.
Die Transparenzprüfung ist ein separates Ergebnis. Schreibvorgänge werden nicht automatisch wiederholt.

## Teamzusammenarbeit

Slack-, Linear- und Notion-Integrationen erfordern eine eigene echte Anwendung/einen eigenen Arbeitsbereich
Anmeldeinformationen zusätzlich zur Truthlocks-Authentifizierung. Ihre vollständige Anbieter-zu-Beleg-
die Annahme noch aussteht. Behandeln Sie die Verfügbarkeit der Quelle, lokale Tests oder eine
Truthlocks API-Schlüssel als Nachweis, dass ein externer Arbeitsbereich verbunden ist.

Lesen Sie die README-Datei des Quellpakets für Anbieterberechtigungen und -konfiguration:
[Slack](https://github.com/truthlocks/truthlock/tree/main/packages/maip-slack),
[Linear](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear),
[Notion](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion).
Verwenden Sie einen dedizierten Test-Arbeitsbereich, bevor Sie die Verarbeitung realer Ereignisse aktivieren.

### Slack-Einrichtung und -Validierung

Slack ist eine Quellinstallation, kein veröffentlichtes `@truthlocks/maip-slack` npm-Paket.
Die Bot-Authentifizierung und eine autorisierte Testnachrichtenübermittlung wurden vom Anbieter bestanden
Prüfungen. Vollständige Slash-Befehle für persönliche Benutzer und gehostete Ereignis-Workflows bleiben unter
Validierung. Folgen Sie dem [Slack README](https://github.com/truthlocks/truthlock/tree/main/packages/maip-slack)
für den überprüften Build und alle erforderlichen Einstellungen.

Binden Sie die App an `SLACK_TEAM_ID` und explizite persönliche `SLACK_ALLOWED_USER_IDS`.
Verwenden Sie `MAIP_AGENT_ID` von einem bestehenden registrierten Truthlocks-Agenten zur Erstellung;
eine Slack-Mitglieder-ID ist keine Maschinenidentität. Geben Sie einen Sandbox-Schlüssel und
`https://sandbox-api.truthlocks.com/v1` während der Auswertung. Befehle werden registriert
in den Slack-App-Einstellungen. Sowohl HTTP als auch Socket Mode bieten `/webhook/maip`, aber
Hosting des Listeners abonniert Truthlocks-Ereignisse nicht automatisch.
Delegationsgenehmigungen bleiben in der authentifizierten Console Überprüfung. Lokaler Replay-Schutz
ist prozesslokal; die Produktionslieferung erfordert eine dauerhafte Upstream-Verfolgung.

### Notion-Einrichtung und -Validierung

Notion ist ein privates Quellpaket, keine npm-Installation. Echte QA-Akzeptanz
eine Unterseite und Datenbankschemata erstellt, einen vorhandenen Arbeitsbereichsbeleg eingefügt,
die Synchronisierung wiederholt, ohne diese Seite zu duplizieren, und die Anbieter-Rücklesung überprüft.
Kontinuierliche gehostete Automatisierung und dauerhafte Wiederherstellung befinden sich noch in der Validierung.

Verbinden Sie nur die gewünschte Seite über das Menü **••• → Verbindungen** von Notion. Folgen Sie den
[Notion README](https://github.com/truthlocks/truthlock/tree/main/packages/maip-notion)
um Datenbanken einmal zu initialisieren und ihre IDs wiederzuverwenden. Verwenden Sie `WEBHOOK_SECRET` mit dem
versionierter HMAC/Zeitstempel-Vertrag; unsignierte Anfragen werden abgelehnt. Empfangsstatus
ist Metadaten, daher überprüft ein abgeschlossener Beleg nicht automatisch die Notion
**Verifiziert**-Feld. Verwenden Sie die explizite Signaturverifizierung separat.

## CI/CD

Die Eingaben der MAIP-Aktion sind `maip-api-url`, `maip-api-key` und `maip-agent-id`.
Die älteren Namen `api-key` und `agent-id` sind keine deklarierten Eingaben. Für eine überprüfte
Quell-Checkout mit seinem erstellten `dist/index.js`, einem explizit ausgelösten QA-Workflow
können diesen Schritt verwenden:

```yaml theme={null}
- uses: ./packages/maip-github-action
  with:
    maip-api-url: https://sandbox-api.truthlocks.com/v1
    maip-api-key: ${{ secrets.TRUTHLOCKS_API_KEY }}
    maip-agent-id: ${{ vars.TRUTHLOCKS_AGENT_ID }}
    mode: receipt
    event-type: commit
    create-check: 'false'
    post-comment: 'false'
```

Dies ist ein lokaler Aktionspfad nach dem Checkout und Build, kein nicht verifizierter Marketplace
Tag. Pinnen Sie überprüfte Releases, wenn Sie die Aktion verteilen. Überprüfen/Kommentieren Sie die Veröffentlichung
erfordert bewusste GitHub-Berechtigungen und separate Akzeptanz; niemals Geheimnisse preisgeben
zu Workflows von nicht vertrauenswürdigen Forks. Siehe die [Aktion README](https://github.com/truthlocks/truthlock/tree/main/packages/maip-github-action).

## KI-Modell-Konnektoren

Python-Wrapper erfassen Ereignisse, die über die konfigurierte Integration ausgegeben werden. Lokale Hashes sind keine Serversignaturen. Anbieteranmeldeinformationen, Truthlocks-Anmeldeinformationen und gehostete Übermittlungen werden separat konfiguriert; überprüfen Sie die von Ihnen gesendeten Metadaten und gehen Sie nicht davon aus, dass das Hashing Datenschutzpflichten aufhebt.

### Unterstützte Frameworks

| Framework | Installieren |
| :- | :- |
| LangChain | `pip install truthlocks-langchain` |
| LlamaIndex | `pip install truthlocks-llamaindex` |
| CrewAI | `pip install truthlocks-crewai` |
| AutoGen | `pip install truthlocks-autogen` |
| OpenAI | `pip install truthlocks-openai` |
| Anthropic | `pip install truthlocks-anthropic` |
| AWS Bedrock | `pip install truthlocks-bedrock` |

**Vollständiges lokales LangChain-Beispiel (keine gehostete Anfrage):**

```python theme={null}
from langchain_core.runnables import RunnableLambda
from truthlocks_langchain import MAIPRunnableWrapper
from maip_ai_connectors.config import MAIPConfig

chain = RunnableLambda(lambda value: value.upper())
wrapped = MAIPRunnableWrapper(chain, config=MAIPConfig(auto_receipt=False))
print(wrapped.invoke("hello"))
receipts = wrapped.get_receipts()
print(receipts[0].payload_hash)
wrapped.clear_receipts()
```

`payload_hash` beschreibt lokale Beweise. Für die gehostete Einreichung verwenden Sie `MAIPClient.create_receipt`
und überprüfen Sie den zurückgegebenen Server `receipt_id`; die [LangChain README](https://github.com/truthlocks/truthlock/tree/main/packages/truthlocks-langchain)
enthält das Beispiel für die asynchrone Übermittlung. Für asynchrone automatische Hooks, leeren und
Schließen Sie den Wrapper und überprüfen Sie die Übermittlungsergebnisse vor dem Herunterfahren. Aufrufe außerhalb des
konfigurierten Wrappers werden nicht beobachtet.

## Daten- und ML-Pipelines

### Kafka-Konnektor

Der Go-Konnektor übermittelt Nachrichten-Fingerabdrücke als MAIP `data.attestation` Belege
mit einem bestehenden Agenten. Sein HTTP-Client verwendet `/v1/agent-receipts`, bewahrt teilweise
Batch-Ergebnisse und erfordert eine bestätigte Signatur für eine erfolgreiche Verifizierung.

Installieren Sie `github.com/truthlocks/kafka-maip-connector@v0.1.0` mit `go get`.
Siehe das [Release- und vollständige Beispiel](https://github.com/truthlocks/kafka-maip-connector/releases/tag/v0.1.0).
Der API-Schlüssel wählt den Arbeitsbereich und die Umgebung aus; eine vom Aufrufer bereitgestellte Mandanten-ID tut dies
Autorisierung nicht überschreiben. Nachrichtenbytes und Roh-Nachrichtenschlüssel werden nicht hochgeladen.

Die Producer/Consumer-Wrapper puffern Belege im Speicher. Broker-Zustellung und -Empfang
Lieferung sind separate Vorgänge; ein erfolgreicher Kafka-Schreibvorgang garantiert keine
Beleg wurde aufbewahrt. Erforderliche Audit-Lieferung benötigt eine dauerhafte Anwendungs-Outbox
und explizite Fehlerbehandlung. Konsultieren Sie die Freigabebelege vor der Produktionsnutzung.

### Ereignis-Streaming

Installieren Sie [Go event-stream v0.1.0](https://github.com/truthlocks/maip-event-stream/releases/tag/v0.1.0):

```sh theme={null}
go get github.com/truthlocks/maip-event-stream@v0.1.0
```

Die Bibliothek enthält einen konkreten Redis-Client und Adapter-Schnittstellen für NATS
JetStream, EventBridge und Kinesis. Redis-wiederverbindende Konsumenten scannen ihre eigenen
ausstehende Einträge vor neuen Nachrichten; fehlgeschlagene Verarbeitung bleibt unbestätigt.
Halten Sie Konsumentennamen über Neustarts hinweg stabil. Das Beanspruchen eines ausstehenden Konsumenten eines anderen
Einträge erfordert immer noch einen expliziten Wiederherstellungsprozess. Das veröffentlichte Artefakt wurde bestanden
einen isolierten echten Redis-Neustart-/Bestätigungstest und die vollständige Go-Race-Suite.
Andere Backend-Adapter erfordern echte, authentifizierte Client-Implementierungen. Diese Adapter
Transport-Ereignis-Envelopes; sie prägen oder verifizieren MAIP-Signaturen nicht automatisch.
Die Kafka-Beleggenerierung ist ein separater Konnektor, der oben beschrieben wird.

> [!WARNING]
>
> Das eigenständige Gateway ist nicht bereit für die Bereitstellung: seine Backend-Client-Fabriken
> sind nicht verdrahtet, und es verweigert nun den Start, anstatt nicht durchgeführte
> Veröffentlichungen als akzeptiert. Es gibt keine veröffentlichte `truthlocks_streaming.StreamingGateway`
> Python-API, die dem älteren Beispiel auf dieser Seite entspricht.

Die Deduplizierung verwendet jetzt einen begrenzten exakten Cache bestätigter Ereignisidentitäten, der begrenzt ist
an Mandanten und Quelle. Fehlgeschlagene Veröffentlichungen werden nicht zwischengespeichert. Wiederholungen sind standardmäßig null;
explizite Wiederholungen bieten eine At-Least-Once-Zustellung, keine Exactly-Once-Garantien.
Die Batch-Middleware verarbeitet jeweils ein Ereignis, sodass sie fehlgeschlagene Elemente nicht erraten kann.
aus aggregierten Zählungen. Cache-Entleerung und Prozessneustart können Duplikate zulassen.

Der Belegvalidator prüft Struktur und lokale Hash-Links; er ist keine Signatur
Verifizierer. Behalten Sie authentifiziertes Routing, dauerhafte Aufbewahrung und kryptografische Validierung bei
in Ihrem Anwendungsdesign.

### MLflow, DVC und Delta Lake

Installieren Sie `mlflow-maip`, `dvc-maip` oder `delta-lake-maip` für die entsprechenden Metadaten
Builder. Diese Pakete erzeugen lokale strukturierte Beweise; die Installation eines Pakets führt nicht dazu,
jede Framework-Operation zu einem signierten gehosteten Beleg machen. Es gibt keine unterstützte
`truthlocks_mlflow.TruthlocksPlugin.enable` API entsprechend dem älteren Beispiel.

Verwenden Sie die vollständigen lokalen und gehosteten Beispiele in den Quell-READMEs:
[MLflow](https://github.com/truthlocks/truthlock/tree/main/packages/mlflow-maip),
[DVC](https://github.com/truthlocks/truthlock/tree/main/packages/dvc-maip),
[Delta Lake](https://github.com/truthlocks/truthlock/tree/main/packages/delta-lake-maip).
Anbieter-Metadaten und Artefakt-URIs überprüfen Artefakt-Bytes oder
beweisen, dass ein externer Vorgang stattgefunden hat. Die gehostete Signaturprüfung tut dies nicht
Transparenz-Log-Aufnahme herstellen, es sei denn, diese separate Prüfung ist erfolgreich.

## Docker

Container-Quelldateien belegen nicht, dass ein öffentliches Image veröffentlicht wurde oder
Akzeptanz bestanden. Die zuvor aufgelisteten `truthlocks/*:latest` Bilder und kombinierten
Compose-Beispiel wurde nicht als funktionierende Bereitstellung verifiziert und ist kein
unterstützter Schnellstart. Leiten Sie die Verfügbarkeit von Bildern nicht aus diesen historischen Namen ab.

Verwenden Sie die veröffentlichte Paketversion und deren README für jede Integration. Beim Erstellen
einen Container aus überprüfter Quelle, pinnen Sie diese Revision und Abhängigkeiten, liefern Sie Geheimnisse
über Ihre Laufzeit und testen Sie die tatsächliche Anbieterverbindung. Slack zusätzlich
erfordert seine echten Anwendungsanmeldeinformationen; ein Truthlocks API-Schlüssel allein ist nicht ausreichend.
Das eigenständige Event-Stream-Gateway bleibt wie oben beschrieben nicht verfügbar.

## Nächste Schritte

> [card] [Maschinenidentität](https://docs.truthlocks.com/guides/machine-identity.md)
>
> Registrieren Sie Ihren ersten Agenten und verstehen Sie das MAIP-Protokoll.

> [card] [Agentenautorisierung](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> Konfigurieren Sie Bereiche, Sitzungen und Tool-Zugriff für Ihre Agenten.

> [card] [Downloads](https://truthlocks.com/resources/downloads)
>
> Veröffentlichte CLI-, SDK- und IDE-Versionen sowie deren Installationsanweisungen finden.

> [card] [Integrations-Hub](https://truthlocks.com/resources/integrations)
>
> Alle Integrationen nach Kategorie durchsuchen.

### Linear

Echte Anbieterauthentifizierung, SDK-Problemprüfung und ein Belegkommentar mit Rücklesung
in einem explizit autorisierten QA-Problem bestanden. Dies etabliert keine gehostete Webhook-
Belegerstellung oder kontinuierliche Synchronisation. Der Quell-Listener verifiziert Linear's
HMAC-Signatur und signierter Zeitstempel und beschränkt Ereignisse auf die konfigurierte Organisation
und Team-IDs. Die Automatisierung von Projektmeilensteinen bleibt nicht verfügbar, anstatt
geschätzte Beweise. Siehe die [Lineare Einrichtung und Grenzen](https://github.com/truthlocks/truthlock/tree/main/packages/maip-linear#readme).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.