Remote-MCP-Server in Kampagnen
Verbinden Sie Ihre eigenen MCP-Server, um dem Outreach-KI-Agenten Zugriff auf Live-Tools zu geben – CRMs, interne Dokumentationen, Analysen und alles, was das Model Context Protocol spricht.
Warum das zählt
Der Outreach-Agent von Kit recherchiert bereits jeden Kontakt mithilfe von Websuche, Quell-URLs und der Kampagnen-Wissensdatenbank. Manchmal muss er jedoch auch auf Daten zugreifen, die nur Ihr Team hat – einen Deal-Status aus Ihrem CRM, einen Customer-Health-Score aus Ihrem Data Warehouse oder ein internes Playbook aus Ihrem Wiki. Remote-MCP-Server schließen diese Lücke. Verbinden Sie einen beliebigen Server, der das Model Context Protocol implementiert, und der KI-Agent kann dessen Tools neben den integrierten Tools von Kit nutzen.
Was ist ein Remote-MCP-Server
Model Context Protocol ist ein offener Standard, um Tools über JSON-RPC für KI-Agenten bereitzustellen. Wenn Sie einen HTTPS-Endpunkt hosten können, der auf tools/list und tools/call antwortet, kann der Outreach-Agent ihn nutzen. Sie stellen den Server bereit, Kit übernimmt die Orchestrierung.
Gängige Anwendungsfälle:
| Anwendungsfall | Beispiel |
|---|---|
| CRM-Abfrage | “Hat dieser Kontakt schon einmal mit uns interagiert?” |
| Interne Dokumentation | “Finde die passende Fallstudie für einen Fintech-Käufer.” |
| Benutzerdefiniertes Data Warehouse | “Schlage den MRR des Unternehmens dieses Kontakts nach.” |
| Proprietäres Scoring | “Bewerte diesen Kontakt anhand unseres ICP-Modells.” |
Anforderungen
Damit Kit eine Verbindung zu einem Remote-MCP-Server herstellen kann, muss dieser:
- Öffentlich über HTTPS erreichbar sein. HTTP-Endpunkte und private IP-Bereiche werden aus Sicherheitsgründen abgelehnt. Selbstsignierte Zertifikate werden nicht unterstützt.
- Mit JSON-RPC 2.0 kompatibel sein, wie in der MCP-Spezifikation definiert.
-
Per Bearer-Token authentifiziert sein (optional). Wenn Ihr Server eine Authentifizierung erfordert, geben Sie beim Verbinden ein Token an. Kit sendet es bei jeder Anfrage als
Authorization: Bearer <token>. - Eine angemessene Größe einhalten. Kit begrenzt Antworten auf 512 KB und die Tool-Liste auf 50 Tools pro Server. Jedes Konto kann bis zu 10 Server verbinden.
Einen Server verbinden
- Öffnen Sie Integrationen > MCP-Server und klicken Sie auf Neuer Server.
- Geben Sie einen aussagekräftigen Namen an (dieser wird der KI in ihrer Tool-Liste angezeigt), die HTTPS-Endpunkt-URL und ein optionales Bearer-Token.
- Speichern Sie. Kit reiht sofort einen Tool-Discovery-Job ein, der
tools/listauf dem Server aufruft, das Schema zwischenspeichert und den Server als Aktiv markiert.
Die Erkennung dauert in der Regel wenige Sekunden. Bis zum Abschluss befindet sich der Server im Status Wird erkannt und ist innerhalb einer Kampagne noch nicht auswählbar. Falls die Erkennung fehlschlägt, wechselt der Server in den Status Fehlgeschlagen mit der Fehlermeldung des Servers. Nach drei aufeinanderfolgenden Fehlschlägen deaktiviert Kit den Server automatisch und benachrichtigt den Kontoadministrator.
Server in einer Kampagne auswählen
Öffnen Sie eine beliebige Kampagne, bearbeiten Sie deren Konfiguration und suchen Sie den Abschnitt Remote-MCP-Server. Jeder aktive Server in Ihrem Konto wird mit einem Kontrollkästchen, seiner Endpunkt-URL und der Anzahl der bereitgestellten Tools angezeigt. Aktivieren Sie die Server, die Sie für diese Kampagne verwenden möchten.
Einige Hinweise:
- Die Auswahl gilt pro Kampagne. Verschiedene Kampagnen können unterschiedliche Server-Kombinationen verwenden.
- Nur aktive Server werden angezeigt. Server, die sich noch in der Erkennung befinden oder fehlgeschlagen sind, werden in einem Hinweis unterhalb der Liste zusammengefasst.
- Keine Auswahl ist in Ordnung. Der KI-Agent fällt auf seine integrierten Tools zurück.
-
Tool-Namen sind mit einem Namespace versehen. Wenn die KI ein Remote-Tool sieht, erscheint es als
mcp__<server_id>__<tool_name>, sodass zwei Server mit überlappenden Tool-Namen nicht kollidieren.
Wie der Agent die Tools nutzt
Während der Recherche erhält der KI-Agent die Vereinigung von Kits integrierten Tools und den Tools aller ausgewählten Server. Er wählt das aufzurufende Tool anhand der Tool-Beschreibung aus. Die Qualität Ihrer Remote-Tool-Beschreibungen beeinflusst daher direkt, wie oft der Agent sie nutzt. Beschreiben Sie präzise, was jedes Tool tut und welche Argumente es erwartet.
Tool-Aufrufe werden in der Nachricht protokolliert und in der Oberfläche zur Entwurfsprüfung angezeigt. Sie können genau sehen, was der Agent aufgerufen hat, mit welchen Argumenten und was zurückgegeben wurde.
Sicherheitsmodell
Remote-MCP-Server laufen auf Ihrer Infrastruktur unter Ihrer Authentifizierung. Kit agiert ausschließlich als Client:
- Kit leitet niemals Datenverkehr von Kontakten, Endnutzern oder Dritten an Ihren Server weiter. Nur der Outreach-Agent tut dies, und nur während er eine E-Mail für einen Kontakt in einer von Ihnen konfigurierten Kampagne verfasst.
- Das Bearer-Token wird im Ruhezustand verschlüsselt und dem KI-Modell niemals offengelegt.
- Kit validiert vor jeder Anfrage, dass der Endpunkt-Hostname auf eine öffentliche IP aufgelöst wird, um SSRF-Angriffe abzuwehren.
- Tool-Argumente werden unverändert von der KI weitergegeben. Die serverseitige Eingabevalidierung liegt daher in Ihrer Verantwortung.
Wenn Sie Compliance-Anforderungen dazu haben, welche Tools wann aufgerufen werden dürfen, setzen Sie diese in Ihrem MCP-Server durch, nicht in Kit.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Empfohlene Maßnahme |
|---|---|---|
| Server bleibt im Status Wird erkannt | Tool-Discovery-Job wurde noch nicht ausgeführt | Warten Sie eine Minute und aktualisieren Sie die Integrationsseite |
| Server im Status Fehlgeschlagen mit HTTP 401 | Bearer-Token fehlt oder ist ungültig | Bearbeiten Sie die Verbindung und aktualisieren Sie das Token |
| Server im Status Fehlgeschlagen mit “Hostname resolves to private IP” | Endpunkt zeigt auf ein privates Netzwerk | Stellen Sie Ihren Server über einen öffentlichen Hostnamen bereit |
| Aktiver Server meldet 0 Tools | Server hat eine leere tools/list zurückgegeben |
Stellen Sie sicher, dass Ihr Server Tools registriert, und lösen Sie die Erkennung erneut aus |
| Server ist aktiv, aber die KI ruft seine Tools nie auf | Tool-Beschreibungen sind zu vage | Formulieren Sie die Beschreibungen um, damit klar ist, was jedes Tool tut |
| Server wurde automatisch deaktiviert | Drei aufeinanderfolgende Fehlschläge | Beheben Sie das zugrunde liegende Problem und aktivieren Sie den Server erneut |
Auf einen Blick
- Ihr MCP-Server ist über öffentliches HTTPS erreichbar
- Sie haben die Verbindung unter Integrationen > MCP-Server erstellt
- Der Server befindet sich im Status Aktiv mit mindestens einem Tool
- Sie haben den Server in der gewünschten Kampagne ausgewählt
- Die Tool-Beschreibungen sind konkret genug, damit die KI weiß, wann sie aufgerufen werden sollen
Wie geht es weiter
- MCP-Tools-Referenz – die integrierten Tools, die der KI-Agent standardmäßig hat
- KI-Recherche und Wissensdatenbank – wie Recherche und die Wissensdatenbank zusammen mit MCP-Tools funktionieren