Quickstart

1. Client verbinden

Du brauchst einen API-Token. Der Server nutzt Streamable HTTP auf derselben Adresse wie dein Dashboard und authentifiziert mit dem Token im Authorization-Header.

https://aipro.placetel.de/v1/mcp
Authorization: Bearer <your-api-token>

Claude Code
Claude (Web und Desktop)
Codex

claude mcp add --transport http voice-platform https://aipro.placetel.de/v1/mcp \
  --header "Authorization: Bearer <your-api-token>"

Prüfe die Verbindung mit /mcp. Behandle die lokale Client-Konfiguration als vertraulich. Details: Claude Code MCP-Dokumentation.

Öffne die Connector-Einstellungen und füge einen Custom Web Connector mit dem Endpunkt oben hinzu. Wähle No sign in und ergänze einen Request header: Name Authorization, Wert Bearer <your-api-token>. Bei Team- und Enterprise-Konten kann ein Administrator erforderlich sein. Ein gemeinsam konfigurierter Token gewährt dessen Kontozugriff; wähle die Scopes entsprechend. Details: Claude Custom Connectors.

Trage den Server in ~/.codex/config.toml ein und halte den Token in einer Umgebungsvariable statt in der Datei:

[mcp_servers.voice-platform]
url = "https://aipro.placetel.de/v1/mcp"
bearer_token_env_var = "VOICE_PLATFORM_TOKEN"

Exportiere VOICE_PLATFORM_TOKEN in der Shell, die Codex startet, und prüfe die Verbindung mit codex mcp list oder /mcp. Details: Codex MCP-Dokumentation.

2. Mit diesem Prompt starten

Kopiere diesen Text in deinen Client. Er lädt die beiden Anleitungen, die der Assistent braucht, und lässt dich jede Änderung freigeben:

Lies zuerst diese beiden Anleitungen, bevor du irgendetwas tust:
- Prompting Guide: https://aipro.placetel.de/docs/de/ai-prompts.md
- Einstellungsanleitung: https://aipro.placetel.de/docs/en/api-reference/voice-agent-settings.md

Hilf mir dann, mit den MCP-Tools von voice-platform einen Voice Agent zu bauen.
Liste zuerst meine bestehenden Voice Agents auf. Bevor du etwas erstellst oder
änderst, sag mir, was du vorhast, und warte auf meine Bestätigung.

Beschreibe danach deinen Telefonassistenten: Wer ruft an, was soll er erledigen und wie soll er klingen? Clients mit Unterstützung für MCP-Prompts können die gleichen Anleitungen stattdessen über prompting-guide und schema-guide laden; siehe Anleitungen als MCP-Prompts.

3. Verbindung prüfen

Die erste Anfrage „Liste meine Voice Agents auf“ sollte list_voice_agents aufrufen. Eine erfolgreiche Tool-Antwort bestätigt den Zugriff; eine angelegte Connector-Konfiguration allein tut das nicht.

Problem	Prüfen
Endpunkt nicht erreichbar oder `404`	Vollständigen Pfad und Freischaltung für deine Anwendungsadresse prüfen
`401`	Bearer-Header, Token, Ablaufzeit und Widerruf prüfen
Tool fehlt oder `403`	Scopes des Tokens und eine mögliche IP-Beschränkung darauf prüfen

Weiter: Voice Agent bauen.

Einstieg

Bauen

Referenz

1. Client verbinden

2. Mit diesem Prompt starten

3. Verbindung prüfen

​1. Client verbinden

​2. Mit diesem Prompt starten

​3. Verbindung prüfen

1. Client verbinden

2. Mit diesem Prompt starten

3. Verbindung prüfen