Diese Anleitung ist für Entwickler die Claude Code, OpenAI Codex oder Gemini CLI im Terminal nutzen. Für die einfache Anleitung mit Desktop-Apps, siehe hier.

Voraussetzungen

immoJUMP-Konto mit API-Token (Profil → API-Zugang)
Deine Organisation-ID (UUID aus der Home-URL)
- z.B. `https://immojump.de/ng/o/555ac240-6324-4af4-9d01-429189e17472/start` -> 555ac240-6324-4af4-9d01-429189e17472
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
/immojump-setup

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

immoJUMP MCP Server – Anleitung für technisch Versierte (Claude Code & Terminal)