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

# MCP-Anleitung

> Verwenden Sie Hybridbox über den Endpunkt und die Tools Model Context Protocol.

# MCP-Anleitung

Hybridbox stellt einen Model Context Protocol (MCP)-Endpunkt für Agent-Clients bereit, die Hybridbox-Pseudofunktionen über die A2A-Agentenlaufzeit erkennen und aufrufen möchten.

Der MCP-Endpunkt ist `/mcp`. Quellrouten registrieren `POST /mcp` für MCP JSON-RPC-Anfragen. `GET /mcp` ist registriert, aber die Rückgabemethode ist nicht zulässig, daher sollten Clients POST für MCP-Verkehr verwenden.

<Note />

## Protokolloberfläche

Zu den unterstützten JSON-RPC-Methoden gehören:

* `initialize`
* `ping`
* `notifications/initialized`
* `tools/list`
* `tools/call`

Für `tools/list` und `tools/call` sind authentifizierte Sitzungen erforderlich. Die sichtbaren Tools und aufrufbaren Funktionen hängen von der authentifizierten Sitzung ab.

## MCP Werkzeuge

### `hybridbox_functions_list`

Listet Hybridbox-Pseudofunktionen auf, die für die authentifizierte Sitzung sichtbar sind. Das Tool akzeptiert keine Argumente.

Verwenden Sie dies zuerst, wenn ein Agent verstehen muss, welche Funktionen verfügbar sind, bevor er etwas anruft.

### `hybridbox_functions_explain`

Erklärt sichtbare Hybridbox-Pseudofunktionen mit Schemata, Dokumentation und Beispielen.

Argumente:

* `function`: optionaler einzelner Pseudofunktionsname zur Erläuterung.
* `functions`: optionales Array von Pseudofunktionsnamen zur Erläuterung.

Verwenden Sie dies vor der Ausführung, damit der Agent Namen, erforderliche Argumente, optionale Argumente und erwartete Ergebnisse validieren kann.

### `hybridbox_execute`

Führt öffentliche Pseudofunktionen von Hybridbox mithilfe von Pseudo-Python-Code über denselben Autorisierungs- und Ausführungspfad wie der Agent A2A aus.

Argumente:

* `code`: Erforderliche Zeichenfolge mit Pseudo-Python-Funktionsaufrufcode Hybridbox, z. B. `domains.list(account_id='acc_123')`.

<Warning>
  Führen Sie Code erst aus, nachdem Sie das relevante Funktionsschema überprüft und Argumente validiert haben. Der Ausführungspfad verwendet das Autorisierungsprofil der authentifizierten Sitzung.
</Warning>

## Empfohlener Arbeitsablauf

<Steps>
  <Step title="Funktionen auflisten">
    Rufen Sie `tools/list` und dann `hybridbox_functions_list` auf, um die für die authentifizierte Sitzung verfügbaren Pseudofunktionen zu überprüfen.
  </Step>

  <Step title="Erklären Sie Funktionen">
    Rufen Sie vor der Ausführung `hybridbox_functions_explain` mit `function` oder `functions` auf. Verwenden Sie das zurückgegebene Schema und die Beispiele, um gültige Argumente vorzubereiten.
  </Step>

  <Step title="Mit validierten Argumenten ausführen">
    Rufen Sie `hybridbox_execute` mit einer `code`-Zeichenfolge erst auf, nachdem der Funktionsname und die Argumente mit dem erläuterten Schema übereinstimmen.
  </Step>
</Steps>

## Funktionskatalog

Der generierte A2A-Funktionskatalog ist die Referenz für verfügbare Hybridbox-Pseudofunktionen und deren Signaturen.

<CardGroup cols={2}>
  <Card title="A2A Funktionskatalog" icon="list" href="/de/agents/a2a-function-catalog">
    Durchsuchen Sie generierte Funktionssignaturen, Funktionen und öffentliche API-Routenzuordnungen.
  </Card>

  <Card title="Roher Funktionskatalog JSON" icon="code" href="/a2a_functions.v1.json">
    Überprüfen Sie die generierten `hybridbox.a2a.functions.v1`-Katalogdaten.
  </Card>
</CardGroup>