immojump-setup

immoJUMP MCP Setup

You are helping the user connect their AI coding assistant (Claude Code or OpenAI Codex) to the immoJUMP real estate platform via MCP (Model Context Protocol).

Setup Flow

Step 1: Detect the environment

Check which tool the user is running in:

• Claude Code: Look for .mcp.json or .claude/ directory
• OpenAI Codex: Look for ~/.codex/config.toml

If unclear, ask:

Nutzt du Claude Code oder OpenAI Codex?

Step 2: Ask for API token

Um immoJUMP zu verbinden, brauche ich deinen API-Token. Du findest ihn unter: immoJUMP → Einstellungen → API-Zugang

Bitte gib mir den Token (beginnt mit eyJ...).

Step 3: Test the connection

Once you have the token, test it by calling:

curl -s -X POST https://mcp.immojump.de/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer TOKEN_HERE" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"setup","version":"1.0"}}}'

If it returns "serverInfo":{"name":"immojump"} → token works. If it returns an error → ask user to check their token.

Step 4: Get the organisation ID

After successful connection test, call the user endpoint to find their organisations:

# Use the session from Step 3 to call user_me
curl -s -X POST https://mcp.immojump.de/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer TOKEN_HERE" \
  -H "Mcp-Session-Id: SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"user_me","arguments":{}}}'

If the user has multiple organisations, list them and ask which one to use:

Du hast Zugang zu diesen Organisationen:

1. Org Name A (ID: ...)
2. Org Name B (ID: ...)

Welche soll ich konfigurieren?

Step 5: Write the configuration

For Claude Code (.mcp.json)

Write to the project root .mcp.json:

{
  "mcpServers": {
    "immojump": {
      "url": "https://mcp.immojump.de/sse",
      "headers": {
        "Authorization": "Bearer <TOKEN>",
        "X-Organisation-Id": "<ORG_ID>"
      }
    }
  }
}

For OpenAI Codex (~/.codex/config.toml)

Add to ~/.codex/config.toml:

[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

And add to ~/.zshrc (or ~/.bashrc):

export IMMOJUMP_AUTH_HEADER="Bearer <TOKEN>"
export IMMOJUMP_ORGANISATION_ID="<ORG_ID>"

Step 6: Confirm and instruct restart

immoJUMP MCP ist konfiguriert!

Nächster Schritt: Starte eine neue Session (Claude Code oder Codex neu starten). Danach kannst du z.B. fragen:

• "Wie viele Immobilien habe ich?"
• "Liste meine Kontakte"
• "Erstelle eine Aktivität: Besichtigung morgen um 14 Uhr"

195 Tools stehen zur Verfügung: Immobilien, Kontakte, Deals, Pipelines, Tickets, Dokumente, E-Mail, Feed, und mehr.

Important Notes

• The MCP server runs at https://mcp.immojump.de
• It supports both SSE (/sse) and Streamable HTTP (/mcp) transports
• Claude Code uses SSE, Codex uses Streamable HTTP
• All 195 tools accept optional token and organisation_id parameters as fallback
• If headers are configured, credentials are automatic — no per-call params needed
• The server is stateless — credentials are not stored server-side