Skip to main content
Glama
deenesjakoruzh
MagicDoorInc

MagicDoor MCP server

Official
by MagicDoorInc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

MagicDoor MCP 서버

AI 어시스턴트가 사용자가 생성하고 언제든지 취소할 수 있는 API 키를 사용하여 MagicDoor 포트폴리오(속성, 유닛, 임대, 세입자, 소유자 및 임대 갱신)를 읽을 수 있게 해줍니다.

자신의 기기에서 실행됩니다. 호스팅되는 것은 없으며, 키는 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

누가 어디에 살고 있나요? 누가 무엇을 소유하나요? 어떻게 연락하나요?

임대 — 여러 도구는 하나의 레코드에 대한 ID 또는 목록에 대한 필터를 사용합니다.

도구

다음과 같은 질문에 답변합니다

get_leases

누가 무엇을 임대하고 있나요? 어떤 임대에 잔액이 있나요? 하나의 임대 전체.

get_lease_ledger

그들이 얼마를 빚고, 얼마를 지불했나요 — 요금 또는 보증금.

get_lease_transaction

하나의 원장 항목: 요금, 지불, 크레딧, 연체료, 이체 또는 보증금.

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

무엇이 고장났나요? 이번 주에 접수된 것은? 하나의 요청 전체.

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분 전에 갱신합니다. 리프레시 토큰은 없습니다 — 키 자체가 지속적인 자격 증명입니다.

두 가지 결과가 따르며, 둘 다 의도적입니다:

  • 키를 취소하면 이 서버가 즉시 중지됩니다. 만료될 세션이 없습니다.

  • 자신의 MagicDoor 권한을 좁히면 키도 좁아집니다. 토큰이 발급될 때마다 권한이 다시 확인되므로 키는 현재 사용자가 할 수 있는 것 이상을 절대 수행할 수 없습니다.

릴리스

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

npm은 2차 인증 없이는 게시되지 않습니다. 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

서버는 stdio를 통해 MCP를 사용하므로 터미널이 아닌 반대쪽에 클라이언트가 있어야 합니다. 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