# Agent Store (에이전트 스토어)

> 기업용 MCP 앱스토어 · 게이트웨이. 한국 공공·금융·법령·기업 데이터를 비롯한
> 엄선된 MCP 에이전트를, 단 하나의 안전한 주소로 연결합니다. 모든 호출은 하나의
> 게이트웨이를 지나며, 기본값은 모두 꺼짐 — 조직이 켠 에이전트만 작동합니다.

- 연결 주소(MCP 엔드포인트): https://agent.store/mcp
- 인증: OAuth 2.1(웹·데스크톱 커넥터) 또는 API 키(X-API-Key 헤더) 또는 1회용 연결 토큰(OTT) 교환(헤드리스·외부 에이전트)
- 데이터 무보존(ZDR): 요청·응답 원문은 기본적으로 저장하지 않습니다. 과금에 필요한 메타데이터만 남으며, 원문 감사 기록은 조직 관리자가 켤 때만 보관됩니다.

## 연결 방법 요약

- ChatGPT: 설정 → 커넥터 → (고급) 개발자 모드 → 새 MCP 서버 등록 → URL `https://agent.store/mcp` → OAuth 로그인·승인.
- Claude 데스크톱: 설정 → 커넥터 → "+" → 맞춤 커넥터 추가 → 원격 MCP 서버 주소 `https://agent.store/mcp` → 추가 → 로그인·승인. (Claude 웹 공식 커넥터는 승인 심사 중 — 곧 지원.)
- mcp-remote(개발자): `npx mcp-remote https://agent.store/mcp --header "X-API-Key: <키>"`
- 외부·자동화 에이전트(Hermes·OpenClaw 등): 아래 "외부 에이전트용 MCP-GATEWAY 연결 가이드" 참고.

## 외부 에이전트용 MCP-GATEWAY 연결 가이드

이 섹션은 화면 없이 동작하는 외부·자동화 AI 에이전트(예: Hermes, OpenClaw)가 Agent Store의
mcp-gateway MCP 서버에 연결하기 위한 단계별 가이드입니다. 에이전트는 사용자가 붙여넣은
연결 프롬프트의 oneTimeToken(OTT)을 가지고 아래 절차를 그대로 수행하면 됩니다.

전제: 사용자가 Agent Store 콘솔에서 "연결 프롬프트 생성"으로 발급한 1회용 연결 토큰(oneTimeToken)을
이미 가지고 있습니다. 이 토큰은 한 번만 쓸 수 있고, 발급 후 짧은 시간(기본 30분) 안에 교환해야 합니다.

MCP 서버 정보
- 이름(권장): agent-store
- MCP 엔드포인트: https://agent.store/mcp
- 전송 방식: Streamable HTTP (remote MCP)
- 인증 헤더: `Authorization: Bearer <access_token>`

단계
1) 1회용 연결 토큰(OTT)을 접속용 토큰으로 교환합니다.

   요청:
   POST https://agent.store/api/v1/auths/otts:exchange
   Content-Type: application/json

   {
     "tokenValue": "<oneTimeToken>"
   }

   예시(curl):
   curl -X POST https://agent.store/api/v1/auths/otts:exchange \
     -H "Content-Type: application/json" \
     -d '{"tokenValue":"<oneTimeToken>"}'

2) 응답에서 access_token을 꺼냅니다. 응답 형식:

   {
     "access_token": "...",
     "refresh_token": "...",
     "token_type": "Bearer",
     "expires_in": 3600,
     "scope": "mcp offline_access"
   }

   - access_token: 이후 모든 MCP 호출에 Bearer 토큰으로 사용합니다.
   - refresh_token: access_token이 만료되면 토큰을 재발급할 때 사용합니다.
   - expires_in: access_token의 유효 시간(초). 기본 3600초(1시간).

3) mcp-gateway MCP 서버에 연결합니다. 다음 중 에이전트 환경에 맞는 방식을 쓰세요.

   (a) 원격 MCP를 직접 지원하는 경우 — 엔드포인트와 헤더만 등록:
       url:    https://agent.store/mcp
       header: Authorization: Bearer <access_token>

   (b) stdio만 지원하는 경우 — mcp-remote로 브리지:
       npx mcp-remote https://agent.store/mcp \
         --header "Authorization: Bearer <access_token>"

4) 토큰 만료 시 재발급(OAuth 2.1 refresh_token grant):
   POST https://agent.store/oauth/token
   Content-Type: application/x-www-form-urlencoded

   grant_type=refresh_token&refresh_token=<refresh_token>

   응답은 1단계와 동일한 형식으로 새 access_token을 돌려줍니다.

5) 연결 확인: tools/list를 호출하면 조직이 켜 둔 에이전트의 도구 목록이 반환됩니다.
   도구가 비어 있으면, 콘솔에서 에이전트가 켜져 있는지 확인하세요(기본은 모두 꺼짐).

주의
- access_token·refresh_token은 비밀 값입니다. 로그·코드·프롬프트에 남기지 마세요.
- oneTimeToken은 1회용이며 만료가 짧습니다. 교환에 실패하면 콘솔에서 새로 발급받으세요.
- 호출 가능한 도구·한도는 조직 정책(서버/사용자/키별 허용·차단·한도)에 따릅니다.

## 더 보기

- 연결 가이드(사람용): https://agent.store/docs/connect/
- 보안·데이터 무보존(ZDR): https://agent.store/security/
- 에이전트 목록: https://agent.store/servers/
- 요금: https://agent.store/pricing/