LASS DIE KI FÜR DICH IN immoJUMP ARBEITEN

Voraussetzungen
Diese Anleitung ist für Profis die Claude Code, OpenAI Codex oder Gemini CLI im Terminal nutzen. Für die einfache Anleitung mit Desktop-Apps, siehe hier.
- immoJUMP-Konto mit API-Token (Profil → API-Zugang)
- Deine Organisation-ID (UUID aus der Home-URL)
- Ein MCP-fähiges CLI-Tool
MCP Server
MCP Server Details
| URL (SSE) | https://mcp.immojump.de/sse |
| URL (Streamable HTTP) | https://mcp.immojump.de/mcp |
| Auth | Authorization: Bearer <token> |
| Org Header | X-Organisation-Id: <uuid> |
| Tools | 195 (Immobilien, Kontakte, Deals, Pipeline, Docs, Email, Investor…) |
| Source | github.com/immoJUMP/mcp-immojump |
Claude Code
Option A: Plugin (SCHNELL START-empfohlen)
/plugin marketplace add immoJUMP/immojump-marketplace
/plugin install immojump-setup@immojump
/reload-plugins
/immojump-setup
Beispiel:

Weiter:
Welche Kontakte habe ich?

Der Setup-Wizard fragt nach Token und Org-ID und schreibt die Config automatisch.
Option B: Manuell
Erstelle .mcp.json im Projekt-Root:
{
"mcpServers": {
"immojump": {
"url": "https://mcp.immojump.de/sse",
"headers": {
"Authorization": "Bearer DEIN_TOKEN",
"X-Organisation-Id": "DEINE_ORG_ID"
}
}
}
}
Claude Code neu starten.
Option C: Lokale Server (Split)
Für weniger Context-Verbrauch gibt es 5 fokussierte Server:
pip install mcp-immojump
{
"mcpServers": {
"immojump-properties": {
"command": "mcp-immojump-properties",
"env": {"IMMOJUMP_MCP_TRANSPORT": "stdio", "IMMOJUMP_BASE_URL": "https://immojump.de",
"IMMOJUMP_TOKEN": "...", "IMMOJUMP_ORGANISATION_ID": "..."}
}
}
}
Verfügbar: mcp-immojump-properties (39), mcp-immojump-crm (36), mcp-immojump-pipeline (39), mcp-immojump-org (58), mcp-immojump-investor (27).
OpenAI Codex
In ~/.codex/config.toml:
[mcp_servers.immojump]
url = "https://mcp.immojump.de/mcp"
env_http_headers = { "Authorization" = "IMMOJUMP_AUTH", "X-Organisation-Id" = "IMMOJUMP_ORG" }
tool_timeout_sec = 60
Environment-Variablen setzen (~/.zshrc oder ~/.bashrc):
export IMMOJUMP_AUTH="Bearer DEIN_TOKEN"
export IMMOJUMP_ORG="DEINE_ORG_ID"
Neues Terminal → codex.
Gemini CLI
In ~/.gemini/settings.json:
{
"mcpServers": {
"immojump": {
"url": "https://mcp.immojump.de/mcp",
"headers": {
"Authorization": "Bearer DEIN_TOKEN",
"X-Organisation-Id": "DEINE_ORG_ID"
}
}
}
}
Cursor / Windsurf / Andere MCP-Clients
| Setting | Wert |
|---|---|
| Server URL | https://mcp.immojump.de/mcp |
| Transport | Streamable HTTP |
| Auth Header | Authorization: Bearer TOKEN |
| Org Header | X-Organisation-Id: ORG_UUID |
Testen
Schnelltest per curl:
curl -s -X POST https://mcp.immojump.de/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer DEIN_TOKEN" \
-H "X-Organisation-Id: DEINE_ORG_ID" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
Erwartete Antwort: {"serverInfo":{"name":"immojump"}}
Tool-Übersicht (195 Tools)
| Server | Tools | Domains |
|---|---|---|
properties | 39 | Immobilien, Units, Loans, Milestones, Documents, Valuation |
crm | 36 | Contacts, Activities, Tags |
pipeline | 39 | Pipelines, Statuses, Activity Templates, Deals, Tickets |
org | 58 | Organisation, Feed, Email, Custom Fields, User |
investor | 27 | Search Profiles, Assignments, Matching, Reporting |
