> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/api-and-hooks/mcp/werkzeuge-katalog.md).

# Werkzeuge (Katalog)

MCP Werkzeuge, MCP Tools erweitern

{% hint style="success" %}
*Modul: ETRON onRetail REST API*
{% endhint %}

> *API & Hooks -> MCP -> Katalog -> Werkzeuge*

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F1COItt3jE5XhspjcyRJF%2Fimage.png?alt=media&amp;token=3bcf4f25-2540-4e9a-b3eb-61fa59778e54" alt="API &#x26; Hooks -> MCP -> Katalog -> Werkzeuge"><figcaption><p>API &#x26; Hooks -> MCP -> Katalog -> Werkzeuge</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FqP1TDj3r5dAqtcX3BcxF%2Fimage.png?alt=media&amp;token=8e31334a-3c0f-47a5-bda9-10765549c47b" alt="MCP-Werkzeuge unter API &#x26; Hooks -> MCP -> Katalog -> Werkzeuge"><figcaption><p>MCP-Werkzeuge unter API &#x26; Hooks -> MCP -> Katalog -> Werkzeuge</p></figcaption></figure></div>

Es sind bereits Tools für Read- und Write-Vorgänge integriert. Zudem können eigene Tools erstellt werden.

{% hint style="info" %}
*Alle verfügbaren Werkzeuge werden im Menüpunkt* [*Playground*](/verwaltungsoberflache/api-and-hooks/mcp/playground-katalog.md) *angezeigt.*
{% endhint %}

<details>

<summary>Integrierte Standard-Tools Read</summary>

| Tool                | Beschreibung                                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `list_models`       | Verfügbare Modelle werden über Teilzeichenketten durchsucht.                                                                   |
| `list_modules`      | Installierte Module werden mit Version und Status angezeigt.                                                                   |
| `describe_model`    | Felddefinitionen, Typen, Bezeichnungen, Relationen und Auswahlwerte werden abgerufen.                                          |
| `whoami`            | Name, Unternehmen, Sprache, Zeitzone und Sicherheitsgruppen werden abgerufen.                                                  |
| `get_access_rights` | CRUD-Rechte und Zugriffsregeln für ein Modell werden geprüft.                                                                  |
| `search_read`       | Datensätze werden per Domain gesucht und mit Paginierung sowie Sortierung zurückgegeben.                                       |
| `read_records`      | Datensätze werden anhand ihrer Datenbank-ID gelesen.                                                                           |
| `search_count`      | Die Anzahl der zu einer Domain passenden Datensätze wird ermittelt.                                                            |
| `read_group`        | Gruppierte Aggregationen mit automatischer Summen- und Anzahlbildung werden erstellt.                                          |
| `get_messages`      | Chatter-Verlauf, Kommentare und Feld-Tracking werden abgerufen.                                                                |
| `print_report`      | Berichte werden als PDF, Text oder HTML Base64-kodiert zurückgegeben. XML-ID, Berichtname und numerische ID werden akzeptiert. |
| `export_records`    | CSV- oder XLSX-Exporte werden Base64-kodiert zurückgegeben. Feldpfade werden mit `/` über Relationen geführt.                  |

</details>

<details>

<summary>Integrierte Standard-Tools Write</summary>

{% hint style="success" %}
*Modul: ETRON onRetail REST API*
{% endhint %}

| Tool             | Beschreibung                                                                                                            |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `create_records` | Neue Datensätze werden erstellt. Relationale Command-Tupel werden unterstützt.                                          |
| `update_records` | Bestehende Datensätze werden anhand ihrer ID aktualisiert. Teil-Updates werden unterstützt.                             |
| `delete_records` | Datensätze werden unwiderruflich gelöscht.                                                                              |
| `post_message`   | Kommentare oder interne Notizen werden im Chatter eines Datensatzes erstellt.                                           |
| `call_method`    | Öffentliche Methoden eines Modells oder Recordsets werden ausgeführt. Private Methoden mit führendem `_` sind gesperrt. |

</details>

## MCP Werkzeuge erstellen

Über den Button "NEU" können eigene MCP Werkzeuge erstellt werden. Änderungen an den Werkzeugen werden automatisch an den KI-Client übermittelt.

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FRmUTJQRCb2WcJ8PZaPQS%2Fimage.png?alt=media&amp;token=5f2cbc69-b4e5-4131-a843-68bf48c2e17f" alt=""><figcaption></figcaption></figure></div>

#### Name

Bezeichnung des Werkzeugs

#### Kategorie

* Lesen (Read-Zugriff)
* Schreiben (Read\&Write-Zugriff)

#### Registry

MCP

#### Reiter: Beschreibung

Im Reiter "Beschreibung" kann eine Beschreibung des Werkzeugs hinterlegt werden.

#### Reiter: Python-Code

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F2Hvl78e9rEph5vlaY74Y%2Fimage.png?alt=media&amp;token=905e9051-add1-423c-b171-0e33d09a3723" alt=""><figcaption></figcaption></figure></div>

Im Reiter "Python-Code" wird die Logik des Tools definiert.\
Hier kann individueller Python-Code hinterlegt werden, der beim Aufruf des Tools durch einen KI-Client ausgeführt wird.\
Es stehen folgende Objekte zur Verfügung:

| Objekt    | Beschreibung         |
| --------- | -------------------- |
| `env`     | Aktuelle Umgebung    |
| `model`   | Zielmodell des Tools |
| `params`  | Übergebene Parameter |
| `user`    | Aktueller Benutzer   |
| `context` | Kontext              |

#### Reiter: Eingabe-Schema

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FXjB1AvOveRC961OScSnF%2Fimage.png?alt=media&amp;token=33ac2496-4716-4b6e-ab7f-6ee7e5dad83a" alt=""><figcaption></figcaption></figure></div>

Im Reiter Eingabe-Schema kann das JSON-Schema hinterlegt werden.

### Protokollierung der MCP Anfragen

MCP-Anfragen werden mit Methode, Werkzeugname, Zielmodell, Dauer und Status im [MCP-Prüfprotokoll](/verwaltungsoberflache/api-and-hooks/protokollierung/mcp-prufprotokoll.md) erfasst.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.etron.info/verwaltungsoberflache/api-and-hooks/mcp/werkzeuge-katalog.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.