> ## 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.

# Quickstart

> Claude oder Codex mit dem MCP-Server verbinden und einen Voice Agent bauen.

## 1. Client verbinden

Du brauchst einen [API-Token](https://aipro.placetel.de/docs/de/mcp/authentication.md). Der Server nutzt
**Streamable HTTP** auf derselben Adresse wie dein Dashboard und
authentifiziert mit dem Token im `Authorization`-Header.

```text theme={null}
https://aipro.placetel.de/v1/mcp
Authorization: Bearer <your-api-token>
```

> [tab] Claude Code
>
> ```bash theme={null}
> 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](https://code.claude.com/docs/en/mcp).

> [tab] Claude (Web und Desktop)
>
> Ö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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

> [tab] Codex
>
> Trage den Server in `~/.codex/config.toml` ein und halte den Token in einer
> Umgebungsvariable statt in der Datei:
>
> ```toml theme={null}
> [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](https://developers.openai.com/codex/mcp).

## 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:

```text theme={null}
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](https://aipro.placetel.de/docs/de/mcp/guides.md).

## 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](https://aipro.placetel.de/docs/de/mcp/voice-agents.md).


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