immoJUMP MCP Server verbinden: Claude & Codex in 5 Minuten

Ein Link, ein Token, eine Organisation-ID — danach beantwortet dir Claude Fragen wie „Was muss ich heute machen?“ mit echten Zahlen aus deinem Portfolio statt mit Vermutungen. Diese Anleitung führt dich Klick für Klick durch, mit Bildern. Ohne Terminal, ohne Programmieren.

Was der immoJUMP MCP Server macht

MCP steht für Model Context Protocol — ein offener Standard, den Anthropic 2024 veröffentlicht hat und den heute alle großen KI-Apps unterstützen. Ein MCP-Server ist für eine KI das, was der Werkzeugkoffer für den Handwerker ist: eine klar abgegrenzte Sammlung von Werkzeugen, die sie tatsächlich benutzen darf.

Ohne MCP kennt Claude deine Objekte nicht. Du kopierst Exposés in den Chat, die KI rechnet auf Basis dessen, was du ihr gerade gefüttert hast, und vergisst es beim nächsten Chat wieder. Mit dem immoJUMP MCP Server greift sie direkt auf dein System zu — auf denselben Datenbestand, den du im Browser siehst.

Was danach im Chat möglich ist

Was du brauchst

Du brauchst keine Programmierkenntnisse und kein Terminal. Alle Wege außer Claude Code und Codex sind reine Klick-Strecken.

Schritt 1: Token und Organisation-ID holen

Beide Werte stehen auf derselben Seite, direkt untereinander. Du holst sie einmal und brauchst sie danach nie wieder.

1. Melde dich in immoJUMP an.
2. Gehe auf Einstellungen → Schnittstellen-Zugang (Direktlink: immojump.de/ng/settings/api-access).
3. Oben unter Persönlicher Zugangstoken auf das Kopier-Symbol ① klicken. Noch kein Token vorhanden? Dann einmal Neuen Token erzeugen — das ersetzt den bisherigen.
4. Darunter unter Organisations-IDs die passende Organisation heraussuchen und deren Kopier-Symbol ② klicken. Die gerade ausgewählte Organisation ist farbig markiert.

Arbeitest du mit mehreren Organisationen? Die Organisation-ID entscheidet, welchen Datenbestand die KI später sieht. Nimm die Organisation, in der die Objekte liegen, um die es gehen soll.

Wichtig: Der Token ist ein Schlüssel zu deinen Daten — behandle ihn wie ein Passwort. Nicht per WhatsApp verschicken, nicht in Screenshots zeigen, nicht in einen fremden Chat kopieren.

Weg A: Claude Desktop — der einfachste Weg

Empfohlen · 3 Klicks · kein Terminal

1. Öffne die Claude Desktop-App. Noch nicht installiert? Hier herunterladen.
2. Klicke unten links auf Customize ①, dann auf Connectors ②, dann auf das + ③.

3. Trage im Formular ein:
   • ① Name: immoJUMP
   • ② URL: https://mcp.immojump.de/sse
   • OAuth Client ID und Secret: leer lassen
4. Auf Add ③ klicken.

5. Es öffnet sich ein Browser-Fenster mit dem immoJUMP-Verbindungsformular. Trage dort Token und Organisation-ID aus Schritt 1 ein und klicke auf Verbinden.

Fertig. Claude zeigt den Connector jetzt in der Liste. Springe zu „Der erste Test“.

Weg B: Claude im Browser (claude.ai)

Wenn du lieber im Browser arbeitest, funktioniert derselbe Ablauf auf claude.ai:

1. Einstellungen → Connectors öffnen.
2. Add custom connector klicken.
3. Name immoJUMP, URL https://mcp.immojump.de/sse, hinzufügen.
4. Im Verbindungsformular Token und Organisation-ID eintragen, Verbinden.

Ein Connector, den du auf claude.ai einrichtest, hängt an deinem Konto — nicht an einem einzelnen Rechner. Genau das ist der Grund, warum sich dieser Weg lohnt, wenn du zwischen Büro-PC, Laptop und Handy wechselst.

Weg C: Claude Code im Terminal

Für Technikaffine

Variante 1: Setup-Assistent (schnellster Weg)

Claude Code richtet sich die Verbindung selbst ein. Drei Befehle im Chat:

/plugin marketplace add immoJUMP/immojump-marketplace
/plugin install immojump-setup@immojump
/immojump-setup

Der Assistent fragt nach Token und Organisation-ID, testet die Verbindung und schreibt die Konfiguration selbst. Falls das Plugin nach der Installation noch nicht erkannt wird: einmal /reload-plugins ausführen.

Variante 2: Ein Befehl

claude mcp add --transport http immojump https://mcp.immojump.de/mcp \
  --header "Authorization: Bearer DEIN_TOKEN" \
  --header "X-Organisation-Id: DEINE_ORG_ID" \
  --scope user

--scope user sorgt dafür, dass die Verbindung in jedem Projekt verfügbar ist, nicht nur im aktuellen Ordner.

Variante 3: Konfigurationsdatei

Lege eine .mcp.json im Projektordner an:

{
  "mcpServers": {
    "immojump": {
      "url": "https://mcp.immojump.de/sse",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN",
        "X-Organisation-Id": "DEINE_ORG_ID"
      }
    }
  }
}

Danach Claude Code neu starten. Mit /mcp prüfst du, ob der Server verbunden ist.

Weg D: OpenAI Codex

Trage den Server in ~/.codex/config.toml ein:

[mcp_servers.immojump]
url = "https://mcp.immojump.de/mcp"
env_http_headers = { "Authorization" = "IMMOJUMP_AUTH_HEADER", "X-Organisation-Id" = "IMMOJUMP_ORGANISATION_ID" }
tool_timeout_sec = 60

Die beiden Werte kommen aus Umgebungsvariablen — so steht dein Token nicht in der Konfigurationsdatei. In ~/.zshrc beziehungsweise ~/.bashrc:

export IMMOJUMP_AUTH_HEADER="Bearer DEIN_TOKEN"
export IMMOJUMP_ORGANISATION_ID="DEINE_ORG_ID"

Neues Terminal öffnen, codex starten — die immoJUMP-Werkzeuge stehen bereit.

Achtung, häufiger Fehler: Bei env_http_headers stehen rechts die Namen der Umgebungsvariablen, nicht deren Werte. Dein Token gehört in die export-Zeile, nicht in die config.toml.

Weg E: ChatGPT Desktop

Voraussetzung: ChatGPT Plus, Pro, Team oder Enterprise.

1. Unten links auf dein Profil → Settings.
2. Connectors → Advanced → Developer Mode aktivieren.
3. Zurück zu Connectors → Create.
4. URL eintragen: https://mcp.immojump.de/mcp, Authentication: OAuth, dann Create.
5. Im Browser-Fenster Token und Organisation-ID eintragen → Verbinden.
6. In jedem neuen Chat: + → More → immoJUMP aktivieren.

Ausführlicher, mit allen Zwischenschritten: immoJUMP mit KI verbinden — einfache Anleitung ohne Terminal.

Cursor, Windsurf, Gemini CLI und alle anderen

Jeder MCP-fähige Client versteht dieselben vier Angaben:

Für die Gemini CLI gehört das in ~/.gemini/settings.json, im selben Format wie die .mcp.json oben.

Funktioniert’s? Der erste Test

Öffne einen neuen Chat und schreib einfach los. Wenn die Verbindung steht, ruft die KI sichtbar ein immoJUMP-Werkzeug auf, bevor sie antwortet.

Die Zeile mit dem Werkzeugnamen ist dein Beweis, dass die Verbindung steht. Bleibt sie aus und die Antwort klingt allgemein, hat die KI geraten — dann weiter unten bei Probleme lösen.

Standard, Profi oder Full — welches Paket?

Es gibt drei Server-Varianten. Der Unterschied ist die Zahl der Werkzeuge, die die KI bekommt. Zum Wechseln änderst du einfach die URL — sonst nichts.

Starte mit Standard. Mehr Werkzeuge sind nicht automatisch besser: Jedes Werkzeug belegt Platz im Arbeitsspeicher der KI und macht die Auswahl unschärfer. Nimm Profi oder Full erst, wenn dir im Alltag konkret etwas fehlt.

Sicherheit: was die KI darf — und was du wissen solltest

• Der Zugang ist an eine Organisation gebunden. Die Organisation-ID entscheidet, welchen Datenbestand die KI sieht. Mehrere Organisationen bedeuten mehrere Verbindungen.
• Die Verbindung ist verschlüsselt und standardisiert. Der Server nutzt HTTPS und OAuth 2.1 mit PKCE — deshalb reicht in Claude Desktop und ChatGPT die URL, ohne dass du irgendwo einen Schlüssel hinterlegen musst.
• Die KI kann schreiben, nicht nur lesen. Sie legt Kontakte an, verschiebt Deals und ändert Aufgaben. Das ist der Sinn der Sache — aber lass dir bei größeren Aktionen („lösche alle Kontakte ohne E-Mail“) vorher zeigen, was passieren soll.
• Deine Daten verlassen dein System. Was die KI abruft, geht an deinen KI-Anbieter (Anthropic, OpenAI, Google). Wenn du personenbezogene Daten verarbeitest — und Mieter- und Interessentendaten sind genau das — prüfe den Auftragsverarbeitungsvertrag deines Anbieters und wähle einen Geschäftstarif.
• Behandle den Token wie ein Passwort. Nie in Screenshots, nie in geteilten Dokumenten, nie in einem fremden Chat. Wenn du unsicher bist, ob ein Token abhandengekommen ist: unter Einstellungen → Schnittstellen-Zugang einen neuen erzeugen — der alte wird dabei ersetzt.

Probleme lösen

Kommst du nicht weiter? Schreib uns mit einem Screenshot der Fehlermeldung an support@immojump.de — ohne deinen Token im Bild.

Häufige Fragen zum immoJUMP MCP Server

Wie es weitergeht

• immoJUMP mit KI verbinden — die ausführliche Klick-Anleitung ohne Terminal
• MCP Server für Profis — Claude Code, Codex und Gemini CLI im Terminal
• Was Claude und ChatGPT mit immoJUMP konkret machen können
• KI-Agenten in immoJUMP richtig einrichten — die 5 Bausteine
• MCP für Server-Agenten — eigene Identität, harte Rechtegrenzen, Limits
• Welches Claude-Abo brauche ich?

Quellcode und technische Details: github.com/immoJUMP/immojump-marketplace · Fragen: support@immojump.de · Stand: September 2026