Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

Wait, I should double check: in the last paragraph, the link text is `docs/security.md`. The link text and link target are the same. Since it's a file path, I keep it verbatim as link text.

Also note the title "# External AI Ecosystem Gateway" - I'm keeping it in English as it's a project name Mendham. Good.

Let me double-check all headings and structure elements are preserved:
- `#` heading - yes
- `>` blockquote - yes, with two paragraphs inside
- `## Architecture` - yes, translated to "## 아키텍처"
- GXP1, GXP2, GXP3 - preserved
- `List tools:` - translated
- `## Security properties` with 6 bullets
- Last paragraph with link
- `## License` with MIT

Everything looks good. Let me finalize.# External AI Ecosystem Gateway

보안 중심의 Python 게이트웨이로, Slack과 같은 외부 시스템에 대한 액세스를 중재하면서 MCP 호환 어시스턴트 클라이언트에 권한 범위가 지정된 도구를 노출합니다. 테넌트 격리, 위임된 권한 부여, 민감한 쓰기에 대한 인간 확인, 멱등 실행, 서명된 웹훅 검증, 철회 가능한 권한 부여 저장소, 그리고 해시 체인 감사 추적을 보여줍니다.

> 이는 포트폴리오/참조 구현이지, 프로덕션 ID 공급자가 아닙니다. 배포 전에 헤더 기반 개발 인증 어댑터는 `docs/security.md`에 설명된 OIDC 검증 미들웨어로 교체되어야 합니다.

## 아키텍처

GXP1

## 빠른 시작

GXP2

도구 나열:

GXP3

`pytest`로 테스트 스위트를 실행하세요. Slack 토큰이 구성되지 않으면 커넥터는 안전한 샌드박스 모드로 실행되어 발행할 요청을 반환합니다.

## 보안 속성

* 모든 멱등성 키와 테넌트는 네임스페이스로 구분됩니다.
* 도구 정책은 최소 권한 역할과 위임된 범위를 결합합니다.
* 민감한 쓰기 작업에는 도구, 인수, 테넌트 및 주체에 바인딩된 단기 토큰이 필요합니다.
* 웹훅 서명은 상수 시간 비교를 사용하며 만료된 요청은 거부됩니다.
* 감사 추적은 SHA-256 체인을 형성하여 조작을 감지합니다.
* 권한 부여 저장소는 철회를 지원하며 리프레시 토큰을 도구 결과로 노출하지 않습니다.

프로덕션 강화 체크리스트와 위협 모델은 [docs/security.md](docs/security.md)를 참조하세요.

## 라이선스

MIT