MCP Gateway
Verbinde deinen KI-Agenten über das Model Context Protocol mit jedem Remote-Dienst.
Möchtest du Claude, Cursor oder VS Code mit deinem Workspace verbinden? Das ist der MCP Server, die umgekehrte Richtung. Diese Seite behandelt die Verbindung deines Sois AI Agenten nach außen zu externen MCP-Servern.
Das MCP Gateway ermöglicht es dir, externe MCP-kompatible Server in deinen Sois AI Workspace einzubinden. Sobald verbunden, kann dein KI-Agent Tools auf diesen Servern erkennen und aufrufen: GitHub-Issues durchsuchen, eine Notion-Datenbank abfragen, eine Slack-Nachricht senden, alles über natürliche Sprache. Kein eigener Integrationscode. Keine Middleware. Nur eine Verbindung und ein Gespräch.
So funktioniert es
You: "Search GitHub for open issues labelled 'bug' in the acme/backend repo"
Agent: ✓ Found 7 open issues labelled 'bug'. Here's the list …
Der Agent ermittelt den richtigen MCP-Server, wählt das richtige Tool, übergibt die richtigen Argumente, kümmert sich um die Authentifizierung und liefert das Ergebnis. Du fragst einfach.
Einen Server einrichten
Navigiere zu MCP Gateway in der Seitenleiste und klicke auf Add Server.
Schnellstart-Voreinstellungen
Wähle eine Voreinstellung, um die Verbindungsdetails automatisch auszufüllen. Du fügst nur deine Zugangsdaten hinzu.
| Voreinstellung | Was es verbindet | Auth-Typ |
|---|---|---|
| GitHub | Repositories, Issues, PRs, Codesuche | Bearer Token |
| Brave Search | Websuche, News, Bilder | API-Key |
| Slack | Channels, Nachrichten, Benutzer | Bearer Token |
| Notion | Seiten, Datenbanken, Blöcke | Bearer Token |
| Linear | Issues, Projekte, Cycles | Bearer Token |
Oder wähle Custom Server und konfiguriere alles manuell.
Serverkonfiguration
| Feld | Beschreibung |
|---|---|
| Name | Eine Bezeichnung für diesen Server (z. B. "Production GitHub") |
| Endpoint URL | Der MCP-Endpunkt des Servers (z. B. https://api.github.com/mcp) |
| Transport | Streamable HTTP oder Server-Sent Events (SSE) |
Authentifizierung
Jeder Server kann eine von fünf Authentifizierungsmethoden nutzen. Zugangsdaten für API Key, Bearer Token und Basic Auth werden sicher in deinem Password Vault gespeichert; das Gateway sieht rohe Geheimnisse nie direkt.
None
Für öffentliche oder nicht authentifizierte Server. Keine Zugangsdaten nötig.
API Key
Verknüpfe einen Password-Vault-Eintrag, der den API-Key enthält. Das Gateway fügt ihn automatisch in Anfragen ein.
Bearer Token
Verknüpfe einen Password-Vault-Eintrag mit einem Bearer Token. Wird bei jeder Anfrage als Authorization: Bearer <token> gesendet.
Basic Auth
Verknüpfe einen Password-Vault-Eintrag mit Benutzername und Passwort. Wird als standardmäßige HTTP-Basic-Authentifizierung gesendet.
OAuth 2.0 + PKCE
Vollständiger OAuth-Flow für Dienste, die ihn erfordern. Konfiguriere:
| Feld | Beschreibung |
|---|---|
| Authorization Endpoint | Die Authorize-URL des Anbieters (z. B. https://provider.com/oauth/authorize) |
| Token Endpoint | Die Token-URL des Anbieters (z. B. https://provider.com/oauth/token) |
| Client ID | Die Client-ID deiner OAuth-Anwendung |
| Client Secret | Das Client Secret deiner OAuth-Anwendung |
| Scopes | Durch Leerzeichen getrennte Liste der OAuth-Scopes |
Klicke auf Connect with OAuth, um den PKCE-Flow zu starten. Ein Browserfenster öffnet sich, du autorisierst, und das Gateway speichert das Token. Tokens werden mit einem Puffer von 5 Minuten vor Ablauf automatisch erneuert, ohne manuelles Zutun.
MCP-Tools über den Agenten nutzen
Sobald ein Server verbunden und Tools erkannt wurden, kann dein KI-Agent sie automatisch aufrufen.
Explizite Adressierung: Verwende @mcp im Chat, um dem Agenten zu sagen, dass er MCP-Tools nutzen soll.
@mcp Search for open pull requests on acme/frontend
Implizites Routing: Der Router des Agenten erkennt MCP-bezogene Absicht anhand von Schlüsselwörtern wie "GitHub", "Slack", "Notion" oder "MCP" und wählt die richtigen Tools automatisch.
Verfügbare Tools ansehen
Öffne einen beliebigen Server im MCP Gateway und wechsle zum Abschnitt Available Tools. Jedes Tool zeigt:
- Name der Tool-Bezeichner auf dem Remote-Server
- Description was es tut
- Input Schema die Parameter, die es akzeptiert (JSON Schema)
Ressourcen, die der Server bereitstellt (Datenbankeinträge, Dateien, API-Antworten), erscheinen unter Available Resources.
Verlauf der Tool-Aufrufe
Jede Tool-Ausführung wird protokolliert. Öffne einen Server und wechsle zum Tab History, um Folgendes zu sehen:
| Spalte | Beschreibung |
|---|---|
| Tool | Name des aufgerufenen Tools |
| Status | Erfolg oder Fehlschlag |
| Duration | Wie lange der Aufruf dauerte |
| Called By | Welcher Benutzer oder Agent ihn ausgelöst hat |
| Time | Wann der Aufruf erfolgte |
Health-Monitoring
Server werden automatisch alle 10 Minuten per Health-Check geprüft. Wird ein aktiver Server nicht mehr erreichbar, ändert sich sein Status im Sidebar-Explorer auf Error.
| Status | Bedeutung |
|---|---|
| Active | Verbunden und gesund |
| Inactive | Manuell deaktiviert |
| Error | Nicht erreichbar oder Authentifizierungsfehler |
Du kannst jederzeit eine manuelle Prüfung über die Schaltfläche Test Connection auslösen.
Referenz der Agenten-Tools
Das MCP Gateway stellt dem KI-Agenten fünf Tools zur Verfügung, organisiert in drei fokussierte Kits:
Examine kit
| Tool | Beschreibung |
|---|---|
getMcpGatewayOverview |
Zusammenfassung aller konfigurierten Server: Gesamtzahl, Aufteilung in active/inactive/error, kürzlich verbundene Server. Der Agent ruft dies zuerst auf, um zu verstehen, was verfügbar ist. |
List kit
| Tool | Beschreibung |
|---|---|
mcpListServers |
Alle konfigurierten Server mit Status, Transport-Typ und Tool-Anzahl auflisten. Optional nach Status filtern (active, inactive, error). |
mcpDiscoverTools |
Mit einem Server verbinden und dessen Tools und Ressourcen abrufen. Gibt Namen, Beschreibungen und Input-Schemata zurück. |
Execute kit
| Tool | Beschreibung |
|---|---|
mcpCallTool |
Ein Tool auf einem Remote-Server ausführen. Erfordert server_id und tool_name. Argumente werden an das Remote-Tool durchgereicht. Zugangsdaten werden automatisch aufgelöst. Gated erfordert eine Bestätigung vor der Ausführung. |
mcpReadResource |
Eine Ressource von einem Server per URI lesen (z. B. file:///path oder db://table/id). |
Beispiele
Erkunden, was verfügbar ist:
What MCP servers do I have connected?
GitHub durchsuchen:
@mcp Find all open issues assigned to me on acme/backend
Notion abfragen:
@mcp Search my Notion workspace for pages about Q1 planning
Eine Slack-Nachricht senden:
@mcp Post a message in #engineering saying the deploy is complete
Mit Workspace-Daten verketten:
Find the Q1 report in my documents and post a summary to the #leadership Slack channel
Der Agent kombiniert MCP-Tools mit integrierten Workspace-Tools in einer einzigen Unterhaltung. Keine Orchestrierung erforderlich.
Berechtigungen
Der Zugriff auf das MCP Gateway wird durch deine Workspace-Rolle gesteuert:
| Berechtigung | Beschreibung |
|---|---|
| View MCP servers | Die Liste der konfigurierten Server sehen |
| View server details | Tools, Ressourcen und Verlauf eines Servers sehen |
| Create MCP servers | Neue Serververbindungen hinzufügen |
| Update MCP servers | Serverkonfiguration bearbeiten |
| Delete MCP servers | Serververbindungen entfernen |
| Execute remote tools | Tools auf Remote-Servern über den Agenten aufrufen |
Admins können diese Berechtigungen pro Rolle unter Settings > Permissions zuweisen.
Möchtest du, dass externe KI-Clients sich stattdessen mit deinem Workspace verbinden? Siehe den MCP Server für eingehende Verbindungen von Claude Desktop, Cursor, VS Code und jedem MCP-kompatiblen Client.