> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aeolo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 연결

> 원격 에이전트에서 Aeolo 도구를 사용합니다.

## 연결 주소

기본 도구는 `https://mcp.aeolo.io/mcp`에서 제공됩니다. CLI 명령 게이트웨이까지 필요하면 `https://mcp.aeolo.io/mcp?surface=full`을 사용합니다. 인증은 동일합니다.

## 요청 헤더

```http theme={null}
Authorization: Bearer atok_...
Content-Type: application/json
Accept: application/json, text/event-stream
```

Streamable HTTP 전송을 사용하므로 `Accept`에 JSON과 event-stream을 모두 포함합니다.

## 초기화와 도구 목록

```bash theme={null}
curl -sS https://mcp.aeolo.io/mcp \
  -H "Authorization: Bearer $AEOLO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "example-agent", "version": "0.1.0" }
    }
  }'
```

```bash theme={null}
curl -sS https://mcp.aeolo.io/mcp \
  -H "Authorization: Bearer $AEOLO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'
```

기본 주소에서는 `aeo_get_brand_context`, `aeo_get_content` 등 작업별 도구를 사용합니다. `aeo_read`와 `aeo_execute_command`는 전체 명령 주소에 추가로 제공됩니다.

## 전체 명령 주소에서 읽기

```bash theme={null}
curl -sS "https://mcp.aeolo.io/mcp?surface=full" \
  -H "Authorization: Bearer $AEOLO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "aeo_read",
      "arguments": {
        "command": "agent context",
        "domainId": "brand.com"
      }
    }
  }'
```

`domainId`에는 ID, 호스트 또는 브랜드 이름을 넣습니다. 도메인이 하나뿐이면 생략할 수 있습니다. 자세한 계약은 [MCP 도구](/ko/mcp/tools)를 확인합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.