Shelter MCP 서버

Claude, Codex, Cursor 및 기타 MCP 호환 에이전트를 사용자 본인의 Shelter 계정의 범위가 제한된 재무 컨텍스트에 연결합니다.

이 서버는 읽기 전용입니다. 예측, 실행 가능 기간(runway), 알림, 기회 및 주택 구입 가능성 가이드를 검색할 수 있지만, 자금을 이동하거나 Plaid 자격 증명에 접근할 수는 없습니다.

요구 사항

• Node.js 20 이상

• 재무 데이터가 연결된 Shelter 계정

• shelter.money/developer에서 발급한 범위가 제한된 API 키

Plaid 개발자 계정은 필요하지 않습니다.

Related MCP server: toshl-mcp-server

빠른 시작

API 키를 생성한 후, MCP 클라이언트가 다음을 실행하도록 구성합니다:

npx -y @shelter.money/mcp

서버 환경에 SHELTER_API_KEY를 설정합니다.

Claude Desktop

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": ["-y", "@shelter.money/mcp"],
      "env": {
        "SHELTER_API_KEY": "wv_your_key_here"
      }
    }
  }
}

구성 저장 후 Claude Desktop을 다시 시작합니다.

Codex

codex mcp add shelter --env SHELTER_API_KEY=wv_your_key_here -- npx -y @shelter.money/mcp

Cursor

Cursor의 MCP 설정에 이 서버를 추가합니다:

{
  "shelter": {
    "command": "npx",
    "args": ["-y", "@shelter.money/mcp"],
    "env": {
      "SHELTER_API_KEY": "wv_your_key_here"
    }
  }
}

사용 가능한 도구

• shelter_status — 연결 상태 및 권한 상태

• shelter_runway — 안전한 지출 가능 기간 및 예정된 재정 압박

• shelter_forecast — 명시된 현금 흐름 예측

• shelter_alerts — 현재 재무 알림

• shelter_opportunities — 실행 가능한 절약 기회

• shelter_context — 에이전트 추론을 위한 범위가 제한된 재무 컨텍스트

• shelter_affordability — 구매 가능성 시뮬레이션

• shelter_coach_daily — 일일 코칭 요약

• shelter_coach_advice — 요청된 주제에 대한 코칭 조언

• shelter_ask — Guardian에게 재무 질문하기

이 패키지는 또한 재무 점검, 지출 검토 및 구매 계획 프롬프트를 제공합니다.

환경 변수

SHELTER_API_KEY가 없으면 서버는 여전히 도구 정의를 노출하지만, 재무 값이 없는 차단된 응답을 반환합니다. 사용자의 실제 재무 상태를 샘플 데이터로 대체하지 않습니다.

보안 모델

• 최종 사용자 신원은 범위가 제한된 Shelter API 키에서만 비롯됩니다.

• 키는 Shelter에 SHA-256 해시로 저장되며 생성 시 한 번만 표시됩니다.

• 키는 Shelter 개발자 페이지에서 범위를 제한하고 폐기할 수 있습니다.

• 호스팅된 Agent API는 인증, 권한 부여, 속도 제한 및 감사 로깅을 적용합니다.

• MCP 패키지에는 Shelter 백엔드 코드, 배포 비밀, Plaid 토큰 또는 은행 자격 증명이 포함되지 않습니다.

• 신뢰할 수 있는 데이터를 사용할 수 없을 때 재무 응답은 차단됩니다(fail closed).

API 키를 비밀번호처럼 취급하세요. 커밋하거나 공유 머신의 명령 기록에 남기지 마세요. 취약점 보고는 SECURITY.md를 참조하세요.

개발

npm ci
npm run typecheck
npm run build

빌드된 패키지에서 stdio 서버를 실행합니다:

SHELTER_API_KEY=wv_your_key_here node dist/bin/shelter-mcp.js

무상태(stateless) Streamable HTTP 엔드포인트도 호스팅용으로 빌드됩니다:

SHELTER_API_KEY=wv_your_key_here npm start

HTTP 엔드포인트는 0.0.0.0에 바인딩되며 개인 클라이언트 설정에는 권장되지 않습니다. 직접 운영하고 보안을 관리하지 않는 한 stdio를 사용하세요.

아키텍처

이 공개 저장소에는 MCP 어댑터만 포함되어 있습니다. Shelter의 호스팅된 읽기 전용 Agent API를 호출합니다. Shelter의 비공개 재무 계산, 인증 게이트웨이, 데이터베이스 스키마 및 서비스 자격 증명은 이 패키지에 포함되지 않습니다.

라이선스

MIT