Dify 1.13 HTTP MCP 회의실 예약 목업

인증 서버 없이 Dify 1.13의 정적 Authorization 헤더로 회의실 예약 MCP를 검증하는 프로젝트입니다.

Dify 1.13 ── Bearer <고정 JWT> ──> MCP 서버 ── 내부 API 키 ──> 회의실 API

현재 범위에서는 JWT의 name=dify가 실제 사용자 이름이 아니라 고정 서비스 식별자 역할만 합니다. 각 환경에서 토큰을 직접 발급하고, 동일한 토큰을 Dify 헤더와 MCP 서버의 MCP_STATIC_TOKEN에 등록해야 합니다.

자세한 절차는 정적 토큰 연동 가이드를 참고하세요.

제공 기능

• 회의실 목록 조회

• 회의실 예약 및 시간 중복 방지

• 고정 서비스의 예약 목록 조회

• 토큰 없음·불일치·만료·name 누락 시 HTTP 401

• 예약 성공 시 dify님 예약이 완료되었습니다. 반환

Related MCP server: Boma MCP

빠른 실행

Docker 설치 과정은 이 문서에서 다루지 않습니다.

cp .env.example .env

docker compose run --rm --no-deps mcp-server \
  python scripts/mint_dev_token.py

출력된 JWT를 .env에 등록합니다.

MCP_STATIC_TOKEN=eyJ...

서버를 실행합니다.

docker compose up -d --build --force-recreate
docker compose ps

서비스 주소:

• MCP: http://localhost:8001/mcp

• 회의실 API 상태: http://localhost:8000/health

Dify가 다른 서버에 있다면 localhost 대신 Dify에서 접근 가능한 HTTPS URL을 MCP_PUBLIC_URL과 Dify MCP 설정에 동일하게 등록합니다.

Dify 1.13 설정

정적 헤더이므로 Dify 사용자가 달라져도 JWT와 name=dify는 바뀌지 않습니다.

주요 파일

테스트

PYTHONPATH=. uv run --isolated --extra test pytest -q

Docker E2E:

docker compose up -d --build --force-recreate
docker compose exec -T mcp-server python scripts/e2e_dify_legacy_client.py

목업 한계

• JWT 서명을 인증 서버 공개키로 검증하지 않습니다.

• MCP 서버의 .env에 고정된 토큰 문자열 하나만 허용합니다.

• 사용자별 신원을 구분할 수 없습니다.

• 예약 데이터는 컨테이너 재생성 시 초기화됩니다.

• 운영 전환 시 인증 서버, 서명 검증, 짧은 만료, 키 회전, 사용자별 토큰 전달이 필요합니다.