Ratgeber / MCP

Einen MCP-Server einrichten.

Ein MCP-Server gibt deinem KI-Chat Werkzeuge in die Hand: Kalender lesen, Dateien durchsuchen, für dich telefonieren. Eingerichtet ist so ein Server in zwei bis fünf Minuten — wenn man weiß, welche der beiden Sorten man vor sich hat.

Zuerst: lokal oder remote?

Die häufigste verlorene Viertelstunde beim Einrichten hat denselben Grund: Man befolgt eine Anleitung für die falsche Sorte Server. Es gibt zwei, und sie werden völlig unterschiedlich verbunden.

• Lokaler Server. Läuft als Programm auf deinem Rechner. Der KI-Client startet ihn selbst und spricht über die Standardein- und -ausgabe mit ihm — im Standard heißt dieser Weg „stdio“. Solche Server trägst du in eine Konfigurationsdatei ein, meist „claude_desktop_config.json“, und sie brauchen eine Laufzeitumgebung, üblicherweise Node.js oder Python.
• Remote-Server. Läuft im Netz und hat eine Adresse, die mit „https://“ beginnt. Er wird nicht installiert, sondern im Connector-Dialog des Chats eingetragen; die Anmeldung läuft über OAuth, also über dasselbe Verfahren, mit dem du dich anderswo „mit Google anmelden“ würdest. wecallio ist so einer.

Faustregel: Wird dir ein Befehl mit „npx“ oder „uvx“ genannt, ist es ein lokaler Server. Bekommst du eine https-Adresse, ist es ein Remote-Server — dann brauchst du weder Terminal noch Node.js.

Was du vorher zur Hand haben solltest

• Die Adresse des Servers (remote) oder den Startbefehl samt eventueller Schlüssel (lokal).
• Einen Chat, der MCP unterstützt: Claude, ChatGPT, Gemini und die gängigen Agenten-Werkzeuge tun das. In welchem Menü der Dialog jeweils steckt, steht in der Setup-Anleitung.
• Bei lokalen Servern: Node.js oder Python, je nachdem, womit der Server gebaut ist.
• Etwas Geduld für den ersten Neustart des Chats — viele Clients lesen ihre Konfiguration nur beim Start.

In vier Schritten verbunden (Remote-Server)

1. Adresse besorgen. Die MCP-Adresse beim Anbieter kopieren. Sie beginnt mit https und endet meist auf /mcp. Bei wecallio steht sie mit Kopierknopf auf der Setup-Seite.
2. Connector-Dialog öffnen. In den Einstellungen des Chats den Punkt für eigene Connector oder MCP-Server aufrufen. Bei ChatGPT muss dafür zuerst der Entwicklermodus eingeschaltet werden.
3. Name und Adresse eintragen. Einen Namen vergeben und die Adresse einfügen. Ein Schlüssel wird bei Remote-Servern nicht eingetragen — die Anmeldung läuft im nächsten Schritt.
4. Zugriff bestätigen. Im Anmeldefenster einloggen oder ein Konto anlegen und den Zugriff bestätigen. Danach im Chat nach den verfügbaren Werkzeugen fragen — sie sollten namentlich aufgezählt werden.

Ein lokaler Server wird stattdessen in die Konfigurationsdatei des Clients eingetragen: Name, Startbefehl, Argumente, bei Bedarf Umgebungsvariablen für Schlüssel. Danach den Chat vollständig beenden und neu starten — nicht nur das Fenster schließen.

Woran es meistens scheitert

Die Fehler wiederholen sich, und keiner davon sagt einem klar, was los ist. Diese fünf decken die meisten Fälle ab:

• Die falsche Adresse. Ältere Anleitungen nennen einen Pfad, der auf „/sse“ endet. Das war der frühere Transportweg; heute üblich ist „Streamable HTTP“ unter einem Pfad wie „/mcp“. Nimm immer die Adresse, die der Anbieter heute nennt.
• Die Adresse im Browser geöffnet. Dass dabei eine Fehlermeldung erscheint, ist normal: Ein MCP-Server beantwortet POST-Anfragen. Ein Aufruf im Browser ist ein GET und darf mit „Method Not Allowed“ abgelehnt werden — der Server ist trotzdem in Ordnung.
• Das Anmeldefenster wurde blockiert. Bei Remote-Servern öffnet sich zur Bestätigung ein Fenster. Popup-Blocker und strenge Browsereinstellungen fangen es gelegentlich ab; dann bleibt der Connector „nicht verbunden“, ohne dass eine Fehlermeldung erscheint.
• Der Client hat die alte Werkzeugliste behalten. Nach dem Hinzufügen hilft ein Neustart des Chats. Erscheinen die Werkzeuge dann immer noch nicht, ist meist der Server nicht erreichbar und nicht der Client schuld.
• Firmennetz oder VPN. Proxys blocken die Verbindung gern still. Ein Test über ein Mobilfunknetz klärt das in einer Minute.

Lokale Server: der Eintrag im Einzelnen

Ein lokaler Server steht als Eintrag in einer JSON-Datei: ein Name, der Startbefehl, dessen Argumente und bei Bedarf Umgebungsvariablen für Zugangsdaten. Die Datei liegt je nach System an unterschiedlichen Orten — unter macOS im Anwendungsunterstützungs-Ordner des jeweiligen Programms, unter Windows im Anwendungsdaten-Verzeichnis.

Drei Fehler machen fast alle beim ersten Mal, und alle drei führen dazu, dass der Chat den Server kommentarlos übergeht:

• Ein Komma zu viel oder zu wenig. JSON verzeiht nichts. Ein fehlendes Komma zwischen zwei Einträgen macht die ganze Datei ungültig — und damit auch die Server, die vorher funktioniert haben. Vor dem Speichern durch einen JSON-Prüfer schicken.
• Rückwärtsschrägstriche unter Windows. Pfade müssen in JSON doppelt geschrieben oder mit gewöhnlichen Schrägstrichen angegeben werden. Ein einfacher Rückwärtsschrägstrich leitet eine Sonderzeichenfolge ein.
• Relative Pfade. Der Client startet den Server nicht aus dem Ordner heraus, in dem du gerade arbeitest. Alles, was auf eine Datei zeigt, gehört als vollständiger Pfad hinein.

Zugangsdaten gehören in die Umgebungsvariablen des Eintrags, nicht in den Auftrag im Chatfenster. Ein Schlüssel, den du in ein Gespräch tippst, steht danach im Verlauf — und dort bleibt er.

So prüfst du, ob die Verbindung wirklich steht

Der schnellste Test ist eine Frage im Chat: „Welche Werkzeuge hast du von diesem Connector?“ Ein verbundener Client zählt sie namentlich auf. Kommt eine allgemeine Antwort ohne Namen, ist der Server nicht angebunden — dann sagt das Modell nur, was es für plausibel hält.

Zweiter Test: Lass eine harmlose Abfrage ausführen, etwa das Auslesen des Kontostands oder der Version. Erst daran zeigt sich, ob auch die Anmeldung durchgelaufen ist. Ein Server kann erreichbar sein und trotzdem jede Anfrage mit „nicht berechtigt“ beantworten, wenn die Bestätigung im Anmeldefenster abgebrochen wurde.

Wenn du selbst einen Server baust

Für einen Remote-Server über Streamable HTTP reicht deutlich weniger, als die meisten Anleitungen vermuten lassen. Der MCP-Server hinter wecallio ist zustandslos: Jede Anfrage ist eine einzelne JSON-RPC-Nachricht per POST, die Antwort ist gewöhnliches JSON. Kein SSE-Stream, keine Sitzungsverwaltung — die Spezifikation erlaubt das ausdrücklich, und die gängigen Clients kommen damit zurecht.

Drei Dinge machen in der Praxis Arbeit. Erstens die Aushandlung der Protokollversion beim Verbindungsaufbau: Unterstütze mehrere Versionen und antworte mit der, die der Client nennt. Zweitens die Werkzeugbeschreibungen — sie sind die eigentliche Benutzeroberfläche deines Servers, denn das Modell entscheidet allein aus ihnen heraus, wann es ein Werkzeug aufruft. Drittens die Anmeldung.

Für die Anmeldung genügt der Public-Client-Pfad von OAuth 2.1 mit PKCE. Dazu kommen zwei Metadaten-Dokumente unter „/.well-known/“, damit der Client den zuständigen Authorization Server findet, und ein offener Registrierungs-Endpunkt: Ein Connector registriert sich, bevor überhaupt jemand angemeldet ist. Offen heißt dabei nicht unbegrenzt — ohne Bremse ist das ein kostenloser Schreibzugriff in deine Datenbank.

Zuletzt aktualisiert am 17. August 2026.

wecallio ist selbst ein MCP-Server — einer, der telefoniert. Verbinden dauert ein bis zwei Minuten, der erste Demo-Anruf kostet nichts. Was dabei genau passiert, steht auf der Produktseite; alle Ratgeber stehen in der Übersicht.