mcpgate

자체 호스팅 MCP 게이트웨이 — 정책 훅을 사용하여 모든 AI를 회사 도구에 연결하세요.

웹사이트 · 문서 · 데모 · Docker Hub · 가격

이 저장소는 mcpgate의 자체 호스팅 배포판(Docker Compose, 구성 템플릿, 훅 및 운영 문서)을 포함합니다. 게시된 컨테이너 이미지는 이 저장소에 연결된 CI/CD 파이프라인을 통해 릴리스됩니다.

PM이 사용자 인터뷰를 마치고 Claude에게 Notion에 노트를 정리해달라고 요청합니다. (ChatGPT, Codex 또는 모든 MCP 호환 에이전트에서도 동일하게 작동합니다.) 내용을 검토한 후, 핵심 요약 내용을 인사이트 데이터베이스에 저장하고 다음 제품 회의를 위한 기회 요인을 구성합니다. 예전에는 하루 종일 걸리던 일이 15분 만에 끝납니다.

몇 주 후, 제품 팀은 해당 기회 요인을 우선순위에 두기로 결정합니다. PM은 AI에게 전체 맥락을 제공하고 제약 조건을 추가한 뒤 프로토타이핑을 시작합니다. AI는 코드베이스를 가져와 작동하는 프로토타입을 구축하고, PM은 도구 사용이 아닌 실제 문제 해결에 집중합니다. 몇 시간 후, AI가 올바르게 수행할 맥락을 가지고 있었기 때문에 프로토타입은 기존 앱 및 디자인 시스템과 통합됩니다. 변경 사항은 자동으로 Git 브랜치에 저장됩니다.

모든 맥락이 로드된 상태에서 AI는 개선 작업을 위한 Jira 티켓을 초안으로 작성합니다. 훅은 Markdown을 Jira의 ADF 형식으로 변환하고, 필수 필드를 강제하며, 실수로 덮어쓰는 것을 방지하는 등 지루한 작업을 처리합니다. 팀이 회의할 때, 그들은 작동하는 프로토타입을 검토하고, 격차를 식별하며, 실행 가능한 상태로 만듭니다. 디자인, 개발, QA 등 모든 사람이 전체 맥락을 유지한 채 이전 작업자가 중단한 지점부터 작업을 이어갑니다.

mcpgate는 Notion, Jira, GitLab, Figma 등 다양한 도구를 AI에 연결합니다. 22개의 통합이 내장되어 있으며, OpenAPI 가져오기를 통해 직접 추가할 수도 있습니다. 회사 훅은 정책을 강제하고, 사용자 훅은 개인이 AI 클라이언트에서 직접 규칙을 미세 조정할 수 있게 하며, 몇 초 만에 핫 리로드됩니다. mcpgate는 MCP 게이트웨이로 작동할 뿐만 아니라 게이트 역할도 수행합니다: 당신의 규칙, 당신의 데이터. 팀 간의 루프를 제거하고, 핸드오프 전반에서 맥락을 안전하게 관리하며, 팀이 구축에 집중할 수 있도록 하세요.

AI 전환이 일어나고 있습니다. 당신의 도구, 데이터, 맥락은 연결되어야 합니다. mcpgate는 당신의 조건에 맞춰 이를 수행하는 방법입니다.

빠른 시작

docker compose up -d
open http://localhost:8642

이것으로 끝입니다. .env 파일이 필요하지 않습니다. 설정 마법사가 로그인, 브랜딩, 팀 및 서비스 연결 과정을 안내합니다. 보안 정보는 첫 시작 시 자동으로 생성됩니다.

처음이신가요? 저장소를 복제하여 미리 구성된 docker-compose.yml을 가져오세요:

git clone https://gitlab.com/mcpgate/mcpgate.git && cd mcpgate

또는 mcpgate.de/docs/quickstart에서 docker-compose.yml을 복사하세요.

이미 .env 파일이 있나요? 여전히 작동합니다. 환경 변수가 마법사 설정보다 우선합니다.

Related MCP server: agenticflow

AI 연결

설정 후 대시보드에서 AI 클라이언트를 연결하세요:

Claude — 전사적 사용 (권장)

claude.ai/admin-settings/connectors에서 한 번만 구성하세요:

Name: mcpgate
URL:  https://your-gateway-url/mcp

Claude Code

claude mcp add mcpgate https://your-gateway-url/mcp -s user -t http

ChatGPT

설정 → 앱 → 앱 추가 → OAuth → MCP URL 입력.

Codex / Gemini CLI

codex mcp add mcpgate --url https://your-gateway-url/mcp
gemini mcp add --transport http mcpgate https://your-gateway-url/mcp

아키텍처

flowchart TB
    AI["Claude · ChatGPT · Codex · Gemini · Any MCP Agent"]
    
    AI -- "MCP Protocol (tool calls)" --> Auth

    subgraph GW["mcpgate"]
        Auth["Authentication — OAuth / OIDC"]
        Pre["Pre-Hooks — validate · inject · transform"]
        Exec["Action Executor — YAML-defined, per-service"]
        Post["Post-Hooks — instruct · notify"]

        Auth --> Pre --> Exec --> Post
    end

    Post --> Services

    Services["Slack · Jira · Confluence · GitLab · GitHub\nGoogle Workspace · Microsoft 365 · Notion · Figma\nGrafana · Sentry · Metabase · Amplitude\n+ 10 more"]

요청 흐름:

1. AI가 MCP를 통해 도구 호출을 보냅니다 (예: jira_write_actions → create_issue)

2. mcpgate가 OAuth/OIDC를 통해 사용자를 인증합니다

3. 사전 훅(Pre-hooks) 실행: 권한 검증, 파괴적 작업 차단, 데이터 변환 (예: Markdown → Jira ADF)

4. 사용자별 OAuth 토큰을 사용하여 서비스 API에 대해 작업 실행

5. 사후 훅(Post-hooks) 실행: 응답 크기 제한, 표시 힌트 추가 — 선택적으로 후속 작업 체인 연결 (예: Jira 이슈 생성 후 Slack 알림 게시)

6. 결과가 AI 클라이언트로 반환됩니다

인증

SSO 및 서비스 자격 증명은 설정 마법사나 .env를 통해 구성됩니다. 전체 참조는 .env.example을 확인하세요.

서비스

22개의 통합. 설정 마법사나 .env에 자격 증명을 입력하여 서비스를 활성화하세요. 구성된 서비스만 활성화됩니다.

추가로 자체 관리 도구(게이트웨이 구성, 이슈 보고) 및 기타 모든 것을 위한 OpenAPI 가져오기를 지원합니다.

규정 준수 및 안전

구성이 필요 없는 내장 안전 장치:

• 가명 재수화(Pseudonym Rehydration)를 통한 PII 삭제 — 민감한 데이터(이메일, 이름, 전화번호)는 LLM에 도달하기 전에 안정적인 가명으로 대체되며, 에이전트가 도구를 호출할 때 다시 원래대로 복원됩니다. 매핑은 온프레미스에 유지되고 저장 시 암호화되며 24시간 후 만료됩니다. 단순 삭제 시 깨질 수 있는 쓰기 흐름을 보존합니다.

• 쓰기 안전 기본값 — 파괴적인 작업(삭제, 보관, 대시보드 PUT)은 명시적인 confirmed=true 또는 force=true가 필요합니다. 응답 크기 제한은 대규모 작업을 실수로 수행하는 것을 방지합니다.

• 전송 중 데이터 저장 안 함 — mcpgate는 통과형 게이트웨이입니다. 도구 작업은 작업이 발생하는 실제 도구(Jira, GitLab, Slack)에서 감사 가능합니다. 우리가 보유하는 유일한 데이터는 PII 재수화를 위한 암호화된 가명 매핑이며, 24시간 TTL이 적용됩니다.

• 고가용성 — 로드 밸런서 뒤에서 여러 복제본으로 실행됩니다. 구성 변경 사항은 몇 초 내에 모든 복제본에 전파됩니다.

훅

config/tool_hooks.yaml의 정책 및 강화 훅:

• 정책 (검증): 파괴적 작업 확인, API 엔드포인트 가드, 전환 확인

• 강화 (변형): Markdown → ADF 변환, 텍스트 정규화, 자동 링크, 템플릿

• 사후 처리 (관측 가능성): 응답 제한, 서비스 간 자동화, 인증 오류 처리

훅은 형식 변환, 쓰기 안전, 감사, PII 처리와 같은 결정론적 보장을 처리합니다. 선호도 및 워크플로우 형태의 지침(팀 템플릿, 개인 스타일)의 경우, MCP 표준의 새로운 기술(Skills) 메커니즘(SKILL.md 형식)이 적합합니다. 훅은 강제하고, 기술은 개인화합니다.

참고: MCP 인터셉터 워킹 그룹(SEP-1763, 2026-04-21 헌장)은 현재 mcpgate가 훅이라고 부르는 것을 정확히 표준화하고 있습니다. 세 가지 인터셉터 유형(검증, 변형, 관측 가능성)은 우리의 정책/강화/사후 훅과 1:1로 매핑됩니다. SEP가 안정화되면 기존 훅 시스템 위에 얇은 어댑터로 interceptor/list 등을 노출할 예정입니다.

재시작 없는 핫 리로드:

curl -X POST http://localhost:8642/admin/reload

자세한 내용은 OPERATIONS.md를 참조하세요.

사용자 정의

브랜딩, 액세스 제어 및 훅은 설정 마법사나 구성 파일을 통해 구성할 수 있습니다. 회사 이름, 로고, 색상으로 대시보드를 화이트 라벨링하세요.

업데이트

docker compose pull
docker compose up -d

구성 참조

고급 구성을 위해 템플릿에서 .env 파일을 생성하세요:

cp .env.example .env

OIDC, 서비스 자격 증명, AI 기능 및 오류 보고를 포함한 모든 사용 가능한 옵션은 .env.example을 참조하세요.

운영

상태 확인, 메트릭, 핫 리로드, 확장 및 문제 해결은 OPERATIONS.md를 참조하세요.

지원

hello@mcpgate.de로 문의하세요.

라이선스

Business Source License 1.1. LICENSE를 참조하세요.

프로덕션을 포함한 개인 및 내부 비즈니스 용도로 허용됩니다. mcpgate를 호스팅 서비스로 제공하려면 상업용 라이선스가 필요합니다. COMMERCIAL.md를 참조하세요.