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

# Authentifizierung

> API-Token erzeugen und die Scopes wählen, die dein Assistent nutzen darf.

Der MCP-Server authentifiziert mit einem API-Token aus deinem Dashboard; ein
Browser-Login gibt es nicht.

Öffne **Keys** im Dashboard und wähle **Generate access token**. Vergib eine
Beschreibung, wähle die benötigten Scopes und eine Ablaufzeit. Kopiere den
Token sofort: Er wird nur einmal angezeigt. Bewahre ihn sicher auf und füge
ihn nicht in Chatnachrichten oder ein gemeinsam genutztes Repository ein.

| Aufgabe | Benötigte Scopes |
| - | - |
| Agents, Einstellungen und Einstellungsschemas lesen | `voice_agents:read` |
| Agent erstellen, Einstellungen oder Prompt ändern | `voice_agents:read` **und** `voice_agents:write` |
| Tools und Tool-Typen lesen | `tools:read` |
| Tools erstellen, ändern, aktivieren oder deaktivieren | `tools:write` |
| Ein Tool zum Test ausführen | `tools:execute` |
| Gespräche auflisten und Transkripte lesen | `conversations:read` |

Der Client sieht nur Tools, für die der Token **alle** benötigten Scopes hat.
Ein Token gilt für dein eigenes Konto. Widerrufe ihn auf der Keys-Seite, sobald
du ihn nicht mehr brauchst.


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