# AI 연결(MCP)

여러분의 AI(Claude Desktop, Cursor, 직접 만든 에이전트)가 본인 토큰으로 게이트웨이에 직접 연결합니다. 도구 목록은 권한에 맞춰 제한되며, AI를 연결해도 권한이 커지지 않습니다.

## 원격 MCP

MCP 클라이언트 설정에 서버를 추가하세요: URL은 이 사이트의 `/mcp`, 헤더에 토큰을 넣습니다.

1. 채널 코드 + 시크릿으로 토큰을 교환합니다(`POST /api/v1/auth/token`).
2. 오른쪽 JSON을 클라이언트 설정에 붙여 넣고 토큰을 바꿉니다.
3. 연결되면 도구 목록이 자동으로 나타납니다. 호출 가능 범위는 역할과 창고 허용 목록에 따릅니다.

```json
{
  "mcpServers": {
    "ever-api": {
      "url": "https://connect.everugg.net.au/mcp",
      "headers": {
        "Authorization": "Bearer <내토큰>"
      }
    }
  }
}
```

MCP는 엔드포인트별로 나뉘지 않습니다. 연결되면 권한에 맞는 도구 목록이 제공되며, 이 설정은 모든 엔드포인트에 공통입니다.

## 명령을 실행하는 AI: CLI 사용

Claude Code, Cursor 같은 코딩 어시스턴트는 이미 터미널에서 동작합니다. `ever` 만 설치하면 MCP 설정 없이 스스로 재고를 조회하고 문서를 읽습니다. 도구 이름은 MCP 와 동일합니다(둘 다 기능 카탈로그에서 옵니다).

```bash
curl -fsSL https://connect.everugg.net.au/cli/install.sh | sh
ever login --sandbox
ever tools --json
```

문서도 AI 가 읽기 좋은 형태입니다: 모든 페이지에 Markdown 이 있고 색인은 https://connect.everugg.net.au/llms.txt?lang=ko

## 권한

모든 연결은 호출자 본인의 토큰을 사용합니다: 누구인지와 스코프를 확인한 뒤 도구를 제한하고, 모든 호출은 여전히 게이트웨이를 거칩니다(인증, 인가, 창고 허용 목록, 속도 제한). 쓰기는 자동으로 실행되지 않습니다.

## A2A(에이전트 간)

상대 에이전트는 A2A 프로토콜로 직접 대화할 수 있습니다: `POST https://connect.everugg.net.au/a2a` · https://connect.everugg.net.au/.well-known/agent-card.json

---
Markdown 원본: https://connect.everugg.net.au/reference/mcp.md?lang=ko · 웹 페이지: https://connect.everugg.net.au/reference?sec=mcp&lang=ko