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

# Integrationen & Tools – Überblick

> Wie der Agent handelt: Built-In-Tools, MCP-Server und Fachsystem-Connectoren.

Damit ein Agent nicht nur informiert, sondern **echte Vorgänge erledigt**, ruft er im [Flow](/flows-bauen) **Tools** auf – kleine, klar umrissene Aktionen wie „Anliegen einordnen", „Termin buchen" oder „Saldo abfragen". Woher ein Tool kommt und ob es ein externes System anspricht, hängt von seiner **Kategorie** ab.

## Drei Kategorien von Tools

<CardGroup cols={3}>
  <Card title="Built-In-Tools" icon="wand-magic-sparkles" href="/system-tools">
    Plattform-eigene Tools, die in **jedem Agenten ohne Konfiguration** verfügbar sind. Kein externes System, keine Zugangsdaten. Beispiel: `classify`.
  </Card>

  <Card title="MCP-Server" icon="server" href="/mcp-server">
    Binde einen **beliebigen MCP-Server** an. Der Agent liest dessen Tools aus; du schaltest pro Agent frei, was er nutzen darf.
  </Card>

  <Card title="Fachsystem-Connectoren" icon="plug">
    Anbindung an deine **Praxis- oder Fachsoftware**. Stellt fachliche Tools bereit (z. B. Terminbuchung) und spricht dein System real an.
  </Card>
</CardGroup>

<Info>
  Dieses Kapitel beschreibt, wie du Integrationen im Portal **auswählst und konfigurierst**. Die technische **Implementierung** einer eigenen Schnittstelle ist nicht Teil dieser Dokumentation.
</Info>

## Fachsystem-Connectoren

Ein **Connector** verbindet einen Agenten mit einem externen Fachsystem und stellt ihm die dazu passenden Tools bereit. Jedes Tool ist genau **einem** Connector zugeordnet.

### Verfügbare Connectoren

Im Tab **Connectoren** eines Agenten siehst du die verfügbaren Connector-Typen (mit Beschreibung, Anzahl unterstützter Tools und den unterstützten Authentifizierungsmethoden) sowie deine bereits aktiven Connectoren.

| Connector                        | Zweck                                                                                                                                                                                 | Auth         | Status |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------ |
| **planorg PVS (Principa)**       | Terminbuchung über die FHIR-R4-Schnittstelle des Praxisverwaltungssystems Principa von planorg – Patient suchen, Ärzt:innen/Kalender auflisten, freie Termine finden, Termine buchen. | Bearer-Token | Live   |
| **Forderungsmanagement (Demo)**  | Vorführ-Connector: telefonische Saldenabfrage und Ratenzahlungsvereinbarung mit fiktiven Beispieldaten.                                                                               | API-Key      | Demo   |
| **Vertragsverifizierung (Demo)** | Vorführ-Connector: telefonischer Bestätigungsanruf zu einem abgeschlossenen Vertrag mit fiktiven Beispieldaten.                                                                       | API-Key      | Demo   |

<Note>
  Die **Demo-Connectoren** antworten mit fest hinterlegten Beispieldaten und eignen sich, um einen Flow ohne echtes Fachsystem auszuprobieren. Für den produktiven Einsatz nutzt du einen Fachsystem-Connector wie **planorg PVS** oder einen **[MCP-Server](/mcp-server)**.
</Note>

### Einen Connector konfigurieren

<Steps>
  <Step title="Connector-Typ wählen">
    Wähle den passenden Connector-Typ für dein System.
  </Step>

  <Step title="Basis-URL hinterlegen">
    Trage die Adresse (Basis-URL) ein, unter der dein System die Schnittstelle bereitstellt.
  </Step>

  <Step title="Zugangsdaten hinterlegen">
    Gib die Authentifizierung ein (siehe unten). Welche Felder erscheinen, hängt von der gewählten Methode ab. Geheime Werte werden verschlüsselt gespeichert.
  </Step>

  <Step title="Tools aktivieren">
    Aktiviere die Tools, die der Agent über diesen Connector nutzen darf.
  </Step>
</Steps>

## Authentifizierung

Fachsystem- und MCP-Connectoren unterstützen zwei Authentifizierungsmethoden. Welche verfügbar ist, gibt der jeweilige Connector-Typ vor.

| Methode          | Feld           | Wie es gesendet wird                                                                                                      |
| ---------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **API-Key**      | `API Key`      | Als fester Schlüssel bei jeder Anfrage (bei MCP im Header `X-API-Key`).                                                   |
| **Bearer-Token** | `Bearer Token` | Im Header `Authorization: Bearer <Token>`. Der Token wird unverändert weitergereicht (z. B. ein vorab ausgestelltes JWT). |

<Note>
  Deine Zugangsdaten werden **verschlüsselt** abgelegt. Geheime Felder werden im Portal nach dem Speichern nicht mehr im Klartext angezeigt – beim Bearbeiten lässt du das Feld leer, um den gespeicherten Wert zu behalten.
</Note>

## Beispiel: Terminbuchung

Der ausgereifteste Anwendungsfall ist die telefonische **Terminbuchung** für das Gesundheitswesen über den **planorg-PVS-Connector**. Er stellt u. a. Tools bereit, um Patient:innen zu identifizieren, Ärzt:innen und Kalender aufzulisten, Verfügbarkeiten zu ermitteln sowie Termine für bekannte und neue Patient:innen zu buchen. In deinem Flow verkettest du diese Tools zum vollständigen Buchungsgespräch.

<Tip>
  Nach dem Einrichten einer Integration solltest du den Agenten gründlich mit einem [Test-Anruf](/agenten-testen) prüfen, bevor du ihn live schaltest.
</Tip>