From immojump-setup
Set up the immoJUMP MCP server connection for Claude Code or OpenAI Codex. Use when the user says "immojump setup", "connect to immojump", "MCP einrichten", "immoJUMP konfigurieren", or needs to configure their API access to the immoJUMP real estate platform.
How this skill is triggered — by the user, by Claude, or both
Slash command
/immojump-setup:immojump-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
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).
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).
Check which tool the user is running in:
.mcp.json or .claude/ directory~/.codex/config.tomlIf unclear, ask:
Nutzt du Claude Code oder OpenAI Codex?
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...).
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.
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:
- Org Name A (ID: ...)
- Org Name B (ID: ...)
Welche soll ich konfigurieren?
Write to the project root .mcp.json:
{
"mcpServers": {
"immojump": {
"url": "https://mcp.immojump.de/sse",
"headers": {
"Authorization": "Bearer <TOKEN>",
"X-Organisation-Id": "<ORG_ID>"
}
}
}
}
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>"
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.
https://mcp.immojump.de/sse) and Streamable HTTP (/mcp) transportstoken and organisation_id parameters as fallbackGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub immojump/immojump-marketplace --plugin immojump-setup