Skip to main content
Glama
MagicDoorInc

MagicDoor MCP server

Official
by MagicDoorInc

MagicDoor MCP Server

Ermöglicht einem KI-Assistenten, Ihr MagicDoor-Portfolio zu lesen – Immobilien, Einheiten, Mietverträge, Mieter, Eigentümer und Mietverlängerungen – mithilfe eines API-Schlüssels, den Sie erstellen und jederzeit widerrufen können.

Es läuft auf Ihrem eigenen Rechner. Nichts wird gehostet, und Ihr Schlüssel verlässt Ihren Computer nur zu MagicDoor selbst.

Setup

1. Erstellen Sie einen API-Schlüssel in MagicDoor unter Einstellungen → API-Schlüssel. Wählen Sie die Berechtigungen, die der Assistent haben soll – properties:read, units:read, leases:read, tenants:read und owners:read reichen für alles hier aus. Der Schlüssel wird einmal angezeigt; kopieren Sie ihn.

2. Fügen Sie den Server zur MCP-Konfiguration Ihres Assistenten hinzu:

{
  "mcpServers": {
    "magicdoor": {
      "command": "npx",
      "args": ["-y", "@magicdoor/mcp"],
      "env": { "MAGICDOOR_API_KEY": "magic_0_EXAMPLE-NOT-A-REAL-KEY" }
    }
  }
}

Für Claude Code bewirkt claude mcp add magicdoor -e MAGICDOOR_API_KEY=magic_… -- npx -y @magicdoor/mcp dasselbe.

3. Starten Sie den Assistenten neu. Fragen Sie ihn etwas wie „Wie viele Einheiten haben wir in der Oak Street Immobilie?“

Tools

Portfolio

Tool

Beantwortet Fragen wie

list_properties / list_units

Was ist im Portfolio? Wie viele Einheiten hat diese Immobilie?

list_tenants / list_owners

Wer wohnt wo? Wer besitzt was? Wie erreiche ich sie?

Mietverträge – mehrere Tools akzeptieren eine ID für einen einzelnen Datensatz oder Filter für eine Liste.

Tool

Beantwortet Fragen wie

get_leases

Wer mietet was? Welche Mietverträge haben einen Saldo? Ein Mietvertrag vollständig.

get_lease_ledger

Was schulden sie, was haben sie bezahlt – Gebühren oder Kautionen.

get_lease_transaction

Ein Buchungseintrag: Gebühr, Zahlung, Gutschrift, Mahngebühr, Überweisung oder Anzahlung.

list_lease_recurring_items

Was pro Periode abgerechnet oder gutgeschrieben wird, nicht was bereits gebucht wurde.

list_lease_related

Automatische Zahlung, Verlängerungsangebote, Auszüge, Zuschüsse, Dateien oder benutzerdefinierte Felder für einen Mietvertrag.

list_expiring_leases / list_move_outs / list_lease_renewals

Was endet, wer geht, was wurde verlängert.

list_lease_documents

Wurde der Mietvertrag unterschrieben?

Gespräche

Tool

Beantwortet Fragen wie

list_chats / get_chat / get_chat_messages

Wonach fragen die Leute, und was wurde gesagt?

list_unread_messages / search_chat_messages

Was benötigt eine Antwort? Hat jemand den Heizkessel erwähnt?

Buchhaltung

Tool

Beantwortet Fragen wie

get_bank_accounts / get_chart_of_accounts

Welche Konten führen wir? Wie sind die Bücher strukturiert?

get_transaction / get_bank_ledger_transfers / get_manual_journal_entries

Was war das? Was wurde bewegt? Was wurde manuell angepasst?

list_deposit_slips

Welche Zahlungen wurden zusammen eingezahlt?

get_financial_report

Bilanz, Gewinn- und Verlustrechnung, Cashflow oder Hauptbuch.

get_rent_payments_report / get_owner_statement

Welche Miete ist eingegangen? Was bekommt dieser Eigentümer?

get_accounting_summary

Pünktliche Miete, Online-Zahlungen, tägliche Geldbewegungen, Rückgaben und Streitfälle.

Wartung

Tool

Beantwortet Fragen wie

get_maintenance_requests

Was ist kaputt? Was kam diese Woche rein? Ein Antrag vollständig.

get_work_orders / get_work_order_schedule

Welche Arbeiten sind offen? Was passiert am Dienstag?

get_maintenance_history

Was ist damit passiert, und warum dauert es so lange?

get_recurring_work_orders / get_recurring_work_order_stats

Was wiederholt sich, wie oft, zu welchen Kosten?

get_vendors / get_vendor_detail

Wen nutzen wir für Sanitär? Wie viel geben wir bei ihnen aus?

list_maintenance_categories / get_run_books

Wie werden Arbeiten klassifiziert? Was ist unser Prozess?

get_maintenance_request_stats

Wie viel ist ausstehend?

Jedes Tool ist schreibgeschützt. Es gibt keine Möglichkeit, über diesen Server etwas in MagicDoor zu erstellen, zu ändern oder zu löschen – absichtlich.

Konfiguration

Variable

Erforderlich

Standard

Zweck

MAGICDOOR_API_KEY

ja

Der Schlüssel, den Sie in MagicDoor erstellt haben.

MAGICDOOR_ENV

nein

production

production, staging, demo oder development.

MAGICDOOR_AUTH_URL

nein

von MAGICDOOR_ENV

Überschreibt den Auth-Host für die lokale Entwicklung.

MAGICDOOR_API_URL

nein

von MAGICDOOR_ENV

Überschreibt den Portal-API-Host für die lokale Entwicklung.

MAGICDOOR_ACCOUNTING_URL

nein

von MAGICDOOR_ENV

Überschreibt den Buchhaltungs-Host für die lokale Entwicklung.

MAGICDOOR_MAINTENANCE_URL

nein

von MAGICDOOR_ENV

Überschreibt den Wartungs-Host für die lokale Entwicklung.

Wie der Zugriff funktioniert

Der API-Schlüssel ist langlebig; die von ihm erzeugten Token sind es nicht. Beim ersten Tool-Aufruf tauscht der Server Ihren Schlüssel gegen ein 15-minütiges Zugriffstoken ein, behält es im Speicher und erneuert es eine Minute vor Ablauf. Es gibt kein Refresh-Token – der Schlüssel selbst ist die dauerhafte Anmeldeinformation.

Zwei Dinge folgen daraus, und beide sind beabsichtigt:

  • Das Widerrufen des Schlüssels stoppt diesen Server sofort. Es gibt keine Sitzung, die ablaufen könnte.

  • Das Einschränken Ihrer eigenen MagicDoor-Berechtigungen schränkt auch den Schlüssel ein. Berechtigungen werden jedes Mal neu überprüft, wenn ein Token ausgestellt wird, sodass ein Schlüssel niemals mehr tun kann, als Sie gerade können.

Veröffentlichung

npm version patch                  # or minor, or major
NPM_TOKEN=npm_xxx ./publish.sh

npm veröffentlicht nicht ohne einen zweiten Faktor. Erstellen Sie ein granularen Zugriffstoken unter npmjs.com → Access Tokens → Generate New Token → Granular Access Token, mit aktiviertem Bypass 2FA und Lese-/Schreibzugriff beschränkt auf den @magicdoor-Bereich, und übergeben Sie es als NPM_TOKEN. Es kann nichts außerhalb dieses Bereichs berühren, selbst wenn es durchsickert. Wenn Sie stattdessen 2FA eingerichtet haben, übergeben Sie den Code: ./publish.sh 123456.

publish.sh weigert sich, auf einem nicht bereinigten Baum oder einer bereits auf npm vorhandenen Version ausgeführt zu werden, überprüft Typen, führt die Tests aus und veröffentlicht dann.

Entwicklung

npm install
npm run build
MAGICDOOR_API_KEY=magic_… MAGICDOOR_ENV=development node dist/index.js

Der Server spricht MCP über stdio, erwartet also einen Client am anderen Ende und kein Terminal. npx @modelcontextprotocol/inspector node dist/index.js gibt Ihnen einen, mit dem Sie herumspielen können.

-
license - not tested
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Connect AI agents to bank accounts, transactions, balances, and investments.

  • Read-only bank access for your AI agent. Connects Claude, ChatGPT, Cursor, Gemini, Codex.

  • Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MagicDoorInc/magicdoor-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server