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

# KI-Agent mit Remote MCP verbinden

> Alter als Remote-MCP-Server für Besprechungen, gespeicherte Actions und Unterhaltungen auf dem Mac verwenden

Mit MCP Gateway kann ein kompatibler KI-Agent die Tools von Alter über eine private HTTPS-URL aufrufen. Damit können Sie Besprechungen durchsuchen, Transkripte lesen, erlaubte gespeicherte Actions ausführen sowie Alter-Unterhaltungen starten oder fortsetzen.

Alter führt die Tools auf Ihrem Mac aus. Ein Alter-Relay verbindet Ihren KI-Agenten mit der laufenden App. Sie müssen keinen Port auf Ihrem Mac freigeben und keinen separaten lokalen MCP-Befehl ausführen.

> [!TIP]
>
> Sie verwenden ChatGPT für den Desktop? Folgen Sie der Anleitung [Alter in ChatGPT verwenden](/de/apps-tools/gateways-chatgpt.md) zur Plugin-Installation. Diese Anleitung behandelt die Remote-MCP-Verbindung für kompatible Agents.

## Voraussetzungen

* Melden Sie sich auf Ihrem Mac bei Alter an.
* Verwenden Sie einen KI-Agenten, der eine **Remote-HTTPS-MCP-Server-URL** unterstützt. Ein Client, der nur einen lokalen Befehl akzeptiert, kann diese URL nicht direkt verwenden.
* Lassen Sie Ihren Mac online und Alter während der Nutzung der Verbindung geöffnet.

> [!NOTE]
>
> ChatGPT ist die erste getestete Integration. Die Kompatibilität anderer Clients mit Alter's Remote-MCP-Endpunkt wurde noch nicht vollständig verifiziert. Tool-Unterstützung und Ereignisabonnements können sich innerhalb desselben Clients unterscheiden.

## MCP Gateway aktivieren

**1. Gateways in Alter öffnen**

Drücken Sie **⌘,**, um **Settings** zu öffnen, und wählen Sie unter **Integrations** die Option **Gateways**.

Wählen Sie **Add gateway → MCP Gateway** oder öffnen Sie ein vorhandenes MCP Gateway.

**2. Zugriff auswählen und speichern**

Aktivieren Sie **Enabled**. Aktivieren Sie unter **Allowed access** die Funktionen, die der Agent verwenden darf. Für einen schreibgeschützten Besprechungstest aktivieren Sie **Read meeting transcripts**.

Wählen Sie **Save and restart** und warten Sie, bis die Verbindung bereit ist.

![Alter MCP-Gateway-Einstellungen mit aktiviertem Enabled-Schalter und Verbindungssteuerung](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9)

Aktivieren Sie MCP Gateway und speichern Sie die Verbindung, bevor Sie sie Ihrem KI-Agenten hinzufügen.

**3. Verbindungs-URL kopieren**

Wählen Sie im Abschnitt **Connection** die Option **Copy connection URL**.

Dies ist Ihr privater Remote-MCP-Endpunkt. Halten Sie die vollständige URL geheim, einschließlich des Schlüssels am Ende.

## Alter zu Ihrem KI-Agenten hinzufügen

Öffnen Sie die MCP- oder Integrationseinstellungen Ihres Agents und fügen Sie mit diesen Angaben einen Remote-Server hinzu:

| Feld | Wert |
| - | - |
| Name | **Alter** |
| Server-URL | Fügen Sie die vollständige URL aus **Copy connection URL** ein. |
| Authentifizierung | **No authentication** oder die entsprechende Option Ihres Clients. Der Zugriff ist bereits in der privaten URL enthalten. |

Speichern Sie die Verbindung und aktualisieren oder suchen Sie nach den Tools. Die genauen Bezeichnungen hängen vom Client ab. Für diese Verbindung benötigen Sie keinen zusätzlichen API-Schlüssel und keine OAuth-Anmeldung.

Beginnen Sie mit einer schreibgeschützten Anfrage:

> Liste meine letzten Besprechungen in Alter auf.

Ihr Agent fragt möglicherweise nach der Freigabe eines Tool-Aufrufs. Wenn keine Besprechungen angezeigt werden, vergewissern Sie sich, dass Besprechungen in Alter gespeichert sind und der Transkriptzugriff aktiviert ist.

## Erlaubten Zugriff auswählen

![Abschnitt Allowed access des Alter MCP Gateways mit Schaltern für Besprechungen, Actions, Chats und Verlauf](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec)

Aktivieren Sie nur die Funktionen, die der verbundene Agent verwenden soll.

| Einstellung | Verfügbare Tools und Verhalten |
| - | - |
| **Read meeting transcripts** | `list_meetings`, `search_meetings` und `get_meeting_transcript` listen und durchsuchen gespeicherte Besprechungen und lesen anschließend ein ausgewähltes Transkript. |
| **Run saved actions** | `list_actions` und `run_action` finden und führen gespeicherte Actions aus, die für dieses Gateway erlaubt sind. |
| **Chat with Alter** | `create_conversation` und `send_message` starten und setzen Unterhaltungen mit erlaubten Actions fort. |
| **Read conversation history** | `list_conversations`, `search_conversations` und `get_conversation` finden und lesen Unterhaltungen, deren Actions für dieses Gateway erlaubt sind. |
| **Notify when transcripts are ready** | Erlaubt Transkript-bereit-Ereignisse für unterstützte Clients mit aktivem Ereignisabonnement. Die aktuellen Einschränkungen finden Sie unter [Ereignisunterstützung](#ereignisunterstützung). |

Deaktivierte Funktionen werden aus den verfügbaren Tools entfernt und können nicht direkt aufgerufen werden. Wählen Sie nach einer Zugriffsänderung **Save and restart** und aktualisieren Sie die Tools in Ihrem Agent. Ein Neustart des Gateways bricht aktive Gateway-Aufgaben ab.

### Standard-Action und gespeicherte Actions

Wählen Sie unter **Behavior** die **Default action** für neue Chats. **Ask Anything** ist üblicherweise die Standardeinstellung.

Für eine andere gespeicherte Action öffnen Sie **Action Editor → Gateways** und aktivieren **MCP Gateway** oder **All**. Die Liste **Available actions** des Gateways zeigt die erlaubten Actions. Der Agent benötigt außerdem den Zugriff **Run saved actions**, um sie zu finden und auszuführen.

Neue Unterhaltungen mit **Ask Anything** verwenden Ihren Standard-Workspace von Alter. Andere Actions verwenden den dafür konfigurierten Workspace. Beim Fortsetzen einer Unterhaltung bleiben deren Workspace und Action-Berechtigungen erhalten.

## Diese Anfragen ausprobieren

| Ziel | Beispielanfrage |
| - | - |
| Besprechung nach Thema finden | „Durchsuche meine Alter-Besprechungen nach Preisen und fasse die passenden Gespräche zusammen.“ |
| Letzte Besprechungen ansehen | „Liste meine letzten Besprechungen in Alter auf und lies dann das neueste Transkript.“ |
| Gespeicherte Actions finden | „Welche Alter-Actions kannst du über diese Verbindung ausführen?“ |
| Alter-Chat starten | „Bitte Alter, die neuesten Dateien im aktuellen Workspace anzusehen, ohne sie zu ändern.“ |
| Frühere Unterhaltungen durchsuchen | „Finde meine früheren Alter-Unterhaltungen zum Onboarding.“ |

Die Besprechungssuche gleicht Begriffe im indexierten Besprechungsinhalt ab. Die Unterhaltungssuche durchsucht indexierte Unterhaltungstitel und Nachrichten. Bitten Sie den Agenten, ein passendes Transkript oder eine Unterhaltung zu lesen, wenn Sie weitere Details benötigen.

### Fragen und Berechtigungen

Chats und Actions können eine Aufgaben-ID zurückgeben, während Alter arbeitet. Der Agent verwendet `get_task`, um das Ergebnis abzurufen, und kann `cancel_task` verwenden, um eine laufende Aufgabe zu beenden.

Eine Alter-Aufgabe kann pausieren, um eine Frage zu stellen oder den Zugriff auf Dateien anzufordern. Ihr Agent sollte Ihnen die Frage und Auswahlmöglichkeiten anzeigen, auf Ihre Antwort warten und diese an Alter zurücksenden, bevor er fortfährt.

Zu den Berechtigungsoptionen gehören **Allow once**, **Always allow** oder das Ablehnen des Zugriffs. Die Verbindung genehmigt solche Anfragen nicht automatisch. Wenn der Agent ohne angezeigte Frage weiter wartet, bitten Sie ihn, die ausstehende Frage der Aufgabe zu prüfen und nach Ihrer Antwort das verfügbare Tool `answer_questions` zu verwenden.

## Ereignisunterstützung

Der Remote-Toolzugriff erstellt nicht automatisch ein Ereignisabonnement. Die Ereignisunterstützung hängt auch vom KI-Agenten und seinem ausgewählten Modus ab.

Alter akzeptiert Transkript-bereit-Webhook-Ziele derzeit nur auf ChatGPT-/OpenAI-Domains. Andere MCP-Agents können kompatible Tools verwenden, beliebige Ereignisziele von Drittanbietern werden jedoch nicht unterstützt. Folgen Sie der Anleitung [Benachrichtigungen zu ChatGPT-Besprechungen](/de/apps-tools/gateways-chatgpt.md) zur unterstützten Einrichtung des Abonnements.

## Datenschutz und Verfügbarkeit

Die Verbindungs-URL gewährt den Zugriff, den Sie für dieses Gateway aktiviert haben. Behandeln Sie sie wie ein Passwort und speichern Sie sie nur in vertrauenswürdigen Clients.

Tools werden in Alter auf Ihrem Mac ausgeführt. Anfragen und Ergebnisse laufen über das Alter-Relay, einschließlich Transkripttext, wenn ein Agent ihn anfordert. Ihre gespeicherten Besprechungen und Unterhaltungen bleiben in Alter; der verbundene Agent erhält die Daten, die seine erlaubten Tool-Aufrufe zurückgeben.

Lassen Sie Alter geöffnet und Ihren Mac online. Durch Deaktivieren des Gateways wird der Zugriff beendet und aktive Aufgaben werden abgebrochen. Wenn Sie das Gateway löschen und neu erstellen, wird eine neue Verbindungs-URL erzeugt; ersetzen Sie die alte URL in jedem verbundenen Client.

## Fehlerbehebung

| Symptom | Was Sie prüfen sollten |
| - | - |
| Der Client bietet nur ein Befehls- oder ausführbares Programmfeld an | Wählen Sie einen Client oder Verbindungstyp mit Unterstützung für Remote-HTTPS-MCP-URLs. |
| Der Server kann keine Verbindung herstellen | Prüfen Sie, ob Alter läuft und MCP Gateway aktiviert und verbunden ist. Versuchen Sie **Reconnect** im Abschnitt **Connection** von Alter und aktualisieren Sie dann den Client. Die erneute Verbindung bricht aktive Gateway-Aufgaben ab. |
| Tools fehlen | Aktivieren Sie den passenden Schalter unter **Allowed access**, speichern Sie und aktualisieren Sie die Tool-Liste des Agents. Prüfen Sie bei Actions auch **Action Editor → Gateways**. |
| Eine Aufgabe wartet | Prüfen Sie, ob Alter eine ausdrückliche Antwort oder eine Entscheidung zum Dateizugriff benötigt. |
| Tools funktionieren, aber Ereignisse nicht | Prüfen Sie Client und Modus. Ereignisziele sind derzeit auf ChatGPT-/OpenAI-Domains beschränkt und benötigen ein aktives Abonnement. |
| Zugriff nach Kontowechsel oder Neuerstellung des Gateways beendet | Kopieren Sie die aktuelle Verbindungs-URL und ersetzen Sie sie in Ihrem Agent. |

## Verwandte Seiten

* [Alter in ChatGPT verwenden](/de/apps-tools/gateways-chatgpt.md)
* [Gateways im Überblick](/de/apps-tools/gateways.md)
* [Alter Actions](/de/workflows/alter-actions.md)
* [Lokale Daten und Datenschutz](/de/references/local-data-and-privacy.md)


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