Skip to main content
Glama
deenesjakoruzh
MagicDoorInc

MagicDoor MCP server

Official
by MagicDoorInc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

MagicDoor MCP サーバー

AI アシスタントがあなたの MagicDoor ポートフォリオ（物件、ユニット、賃貸契約、テナント、オーナー、賃貸契約の更新）を読み取れるようにします。あなたが作成し、いつでも取り消せる API キーを使用します。

これはあなた自身のマシン上で動作します。何もホストされておらず、あなたのキーは MagicDoor 自体以外のコンピュータからは決して離れません。

セットアップ

1. API キーを作成します MagicDoor の 設定 → API キー で行います。アシスタントに持たせる権限を選択してください — properties:read、units:read、leases:read、tenants:read、owners:read でここにあるすべての機能は十分です。キーは一度だけ表示されます。コピーしてください。

2. サーバーを追加します アシスタントの MCP 設定に追加します。

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

Claude Code の場合、claude mcp add magicdoor -e MAGICDOOR_API_KEY=magic_… -- npx -y @magicdoor/mcp でも同じことができます。

3. アシスタントを再起動します。 「Oak Street 物件にはユニットがいくつありますか？」などと質問してみてください。

Related MCP server: Lanten MCP Server

ツール

ポートフォリオ

ツール

回答できる質問の例

list_properties / list_units

ポートフォリオには何がありますか？この物件にはユニットがいくつありますか？

list_tenants / list_owners

誰がどこに住んでいますか？誰が何を所有していますか？どうやって連絡しますか？

賃貸契約 — いくつかのツールは、1つのレコードのID、またはリストのフィルターを受け取ります。

ツール

回答できる質問の例

get_leases

誰が何を借りていますか？どの賃貸契約に残高がありますか？1つの賃貸契約の詳細。

get_lease_ledger

彼らは何を支払うべきで、何を支払いましたか — 請求または保証金。

get_lease_transaction

1つの元帳エントリ：請求、支払い、クレジット、延滞料、振替、または保証金。

list_lease_recurring_items

計上されたものではなく、各期間に請求またはクレジットされるもの。

list_lease_related

自動支払い、更新オファー、退去、補助金、ファイル、または賃貸契約のカスタムフィールド。

list_expiring_leases / list_move_outs / list_lease_renewals

何が終了するのか、誰が退去するのか、何が更新されたのか。

list_lease_documents

賃貸契約は署名されましたか？

会話

ツール

回答できる質問の例

list_chats / get_chat / get_chat_messages

人々は何について尋ねていますか、そして何が言われましたか？

list_unread_messages / search_chat_messages

返信が必要なものはありますか？誰かがボイラーについて言及しましたか？

会計

ツール

回答できる質問の例

get_bank_accounts / get_chart_of_accounts

どの口座を保有していますか？帳簿はどのように構成されていますか？

get_transaction / get_bank_ledger_transfers / get_manual_journal_entries

これは何でしたか？何が移動しましたか？手動で調整されたものは何ですか？

list_deposit_slips

どの支払いが一緒に銀行に入金されましたか？

get_financial_report

貸借対照表、損益計算書、キャッシュフロー、または総勘定元帳。

get_rent_payments_report / get_owner_statement

どの家賃が入金されましたか？このオーナーにはいくら支払われますか？

get_accounting_summary

期日通りの家賃、オンライン支払い、日々の資金移動、返金、異議申し立て。

メンテナンス

ツール

回答できる質問の例

get_maintenance_requests

何が壊れていますか？今週何が入ってきましたか？1つのリクエストの詳細。

get_work_orders / get_work_order_schedule

どの作業が進行中ですか？火曜日に何が予定されていますか？

get_maintenance_history

これに何が起こりましたか、そしてなぜこんなに時間がかかっていますか？

get_recurring_work_orders / get_recurring_work_order_stats

何が繰り返されますか、どのくらいの頻度で、いくらの費用で？

get_vendors / get_vendor_detail

配管工事は誰に依頼していますか？彼らにいくら支払っていますか？

list_maintenance_categories / get_run_books

作業はどのように分類されていますか？私たちのプロセスは何ですか？

get_maintenance_request_stats

未処理の量はどれくらいですか？

すべてのツールは読み取り専用です。 このサーバーを通じて MagicDoor 内で何かを作成、変更、または削除する方法は、設計上ありません。

設定

変数

必須

デフォルト

目的

MAGICDOOR_API_KEY

はい

—

MagicDoor で作成したキー。

MAGICDOOR_ENV

いいえ

production

production、staging、demo、または development。

MAGICDOOR_AUTH_URL

いいえ

MAGICDOOR_ENV から

ローカル開発用に認証ホストを上書きします。

MAGICDOOR_API_URL

いいえ

MAGICDOOR_ENV から

ローカル開発用にポータル API ホストを上書きします。

MAGICDOOR_ACCOUNTING_URL

いいえ

MAGICDOOR_ENV から

ローカル開発用に会計ホストを上書きします。

MAGICDOOR_MAINTENANCE_URL

いいえ

MAGICDOOR_ENV から

ローカル開発用にメンテナンスホストを上書きします。

アクセスの仕組み

API キーは長期有効です。キーが生成するトークンはそうではありません。最初のツール呼び出しで、サーバーはあなたのキーを15分間のアクセストークンと交換し、メモリに保持し、期限切れの1分前に更新します。リフレッシュトークンはありません — キー自体が永続的な認証情報です。

これにより2つのことが起こり、どちらも意図的です。

  • キーを取り消すと、このサーバーは即座に停止します。 期限切れになるセッションはありません。

  • あなた自身の MagicDoor 権限を狭めると、キーの権限も狭まります。 権限はトークンが発行されるたびに再チェックされるため、キーはあなたが現在できること以上を行うことは決してできません。

リリース

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

npm は第二要素なしでは公開しません。npmjs.com → Access Tokens → Generate New Token → Granular Access Token で、Bypass 2FA にチェックを入れ、読み取り/書き込みを @magicdoor スコープに限定した、きめ細かなアクセストークンを作成し、それを NPM_TOKEN として渡します。たとえ漏洩しても、そのスコープ外のものには触れられません。代わりに 2FA を設定している場合は、コードを渡します：./publish.sh 123456。

publish.sh は、ダーティなツリーや既に npm 上にあるバージョンでの実行を拒否し、型をチェックし、テストを実行した後、公開します。

開発

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

サーバーは MCP over stdio で通信するため、ターミナルではなく、もう一方の端にクライアントが必要です。npx @modelcontextprotocol/inspector node dist/index.js で、それを操作するためのクライアントを入手できます。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • aluseg-mcp

    peltierclem
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to securely interact with rental management data (leases, rent status, tenant records, tax filings) through a per-user OAuth 2.0 authenticated MCP server, with human-in-the-loop for sensitive actions.
    5
    AGPL 3.0