# 에이전트는 어떤 접근 경로를 써야 합니까 — MCP, A2A, REST, 아니면 Markdown 페이지?

접근 경로 · 세 개의 프로토콜 접근 경로와 페이지 변환본, 그 뒤의 하나의 데이터 집합

*에이전트용 · 5분 · 고급 · 개발자 · 접근 경로*

런타임에서 가장 쉬운 것을 고르십시오: 여덟 가지 기능은 MCP와 A2A에서 같고, REST는 그 상위 집합입니다. 이미 MCP를 쓰는 클라이언트는 한 줄로 서버를 추가하고, JSON-RPC 클라이언트는 /a2a에 POST하며, 스크립트는 /v1을 읽습니다. 페이지도 API입니다: 허브, 대시보드, `/stablecoin`, `/explorers`, `/transactions`, `/freezes` 색인, 피드, 동결 페이지, 모든 `/{network}/stablecoin/{symbol}` 페이지는 Markdown 쌍둥이를 제공하며, 주소, 거래, 블록 페이지는 HTML 전용입니다. /llms.txt에서 시작해 매뉴얼로 가십시오. 매뉴얼과 OpenAPI 명세가 모두 반복하는 두 규칙: 모든 호출에 `chain`을 명시적으로 전달하고, 응답으로 분기하기 전에 정직성 계약을 읽으십시오.

## 세 가지 진입 방법 — 그리고 페이지 변환본

스캐너는 스스로를 *온체인 달러 관측: 사람을 위한 웹 UI, 기계를 위한 에이전트용 API(MCP/A2A)*라고 부르며, [`/agents.md`](https://stablescan.achivx.com/agents.md) §1에 이들을 나열합니다 — *런타임에서 가장 쉬운 것을 고르십시오*:

| 접근 경로 | 위치 | 무엇인가 |
|---|---|---|
| **REST** | `/v1/*` | JSON, ETag 캐시. 피드는 `next_cursor`로 페이지를 나누고, 문서 엔드포인트는 문서 전체를 반환합니다. *REST는 스킬의 상위 집합입니다 — 일부 데이터는 여기에만 있습니다*(잔액, 거래량, 휴리스틱, [거래 상대 그래프](https://achivx.kr/academy/guides/counterparty-graph/) — 기본 [홉](https://achivx.kr/academy/reference/glossary/#g-hop) 1개 — , 기록 원장, 시장 문서) |
| **A2A** | `POST /a2a` | JSON-RPC 2.0, A2A 1.0: 데이터 파트 `{"skill": "<id>", "params": {…}}`를 담은 `SendMessage`, 또는 모든 스킬을 자체 메서드로 |
| **MCP** | [/mcp](https://stablescan.achivx.com/mcp) | 같은 여덟 가지 스킬을 도구로, `-`를 `_`로 바꾼 이름(`get-address-risk` → `get_address_risk`) |
| **페이지** | `/{page}.md` | 허브, 대시보드, `/stablecoin`, [`/explorers`](https://stablescan.achivx.com/explorers), [`/transactions`](https://stablescan.achivx.com/transactions), [`/freezes`](https://stablescan.achivx.com/freezes) 색인, 피드, [동결 페이지](https://achivx.kr/academy/guides/issuer-freezes/), 모든 `/{network}/stablecoin/{symbol}` 페이지는 `Accept: text/markdown`에 답하고 `.md` 쌍둥이를 제공합니다. 주소, 거래, [블록 페이지](https://achivx.kr/academy/guides/settlement-tables/#a-block-page-the-same-rows-one-block)는 HTML 전용이며 그 헤더에 200 HTML로 답합니다 |

어떤 접근 경로도 키가 필요 없습니다 — *텔레메트리는 공개되어 있고, 읽기 전용이며, 인증이 필요 없습니다*. 매뉴얼의 *부트스트랩 없음* 항목: *이 매뉴얼의 어떤 것도 등록/토큰 단계가 필요 없습니다 — 요청을 보내십시오*. 유일한 예외는 [관심 목록](https://achivx.kr/academy/for-agents/watching-an-address-from-a-script/)으로, 매뉴얼이 설명하는 베어러 등급이며 이 섹션의 별도 페이지에서 다룹니다.

## 어떻게 고릅니까

여덟 가지 기능 — 위험, 컴플라이언스, 노출, 승인(approval), 제재 상태, 동기화 상태, 최근 거래, 그래프 [탐색](https://achivx.kr/academy/reference/glossary/#g-walk) — 은 [MCP](https://stablescan.achivx.com/mcp)와 A2A에서 같게 답하며, REST는 이를 그대로 반영하되 의도적인 차이가 하나 있습니다: 스킬은 `token` 없는 탐색을 거부하지만, REST의 walk와 graph는 네트워크의 기본 스테이블코인으로 대체하고 `token`에 그 이름을 밝힙니다 — `/walk`는 `token_source`에도 그렇다고 밝히지만 `/graph`는 그렇지 않으므로, 둘 다에 `token`을 전달하십시오. 에이전트 카드는 *스키마와 한도에 대한 권위 있는 기준*이며, 매뉴얼은 스스로를 *서술*이라고 부릅니다. 따라서 선택은 런타임에 달려 있습니다: MCP 클라이언트는 주석이 붙은 도구를 얻습니다(여덟 개 모두 `readOnlyHint`와 `idempotentHint`가 true). JSON-RPC를 쓰는 오케스트레이터는 `/a2a`에 POST하며 세션이 필요 없습니다. 기록 원장, 시장 문서, 주소의 잔액이 필요한 스크립트는 REST로 갑니다. REST에만 그것들이 있기 때문입니다.

모든 접근 경로에 적용되는 두 규칙이 있으며, 매뉴얼과 [OpenAPI 명세](https://stablescan.achivx.com/openapi.json)가 이를 반복합니다: **`chain`을 명시적으로 전달하십시오** — 그 명세의 표현으로 *없으면 대부분의 조회가 베이스(Base) 기준으로 답하며, 잘못된 네트워크에 대한 응답은 정확히 정상 응답처럼 보입니다* — 그리고 **응답으로 분기하기 전에 정직성 계약을 읽으십시오**: `unknown`은 `none`이 아니고, 빈 목록은 깨끗하다는 증명이 아니며, `null`인 `chains_with_data`, 또는 체인 맥락·라벨 조회·새 거래 상대 조회가 끝나지 않아 `no-store`로 제공된 주소 응답은 그렇다고 밝힙니다: 다시 요청하십시오(`null`인 `freshness_seconds`는 체인에 아직 인덱싱된 전송이 없다는 뜻일 수도 있으며, 솔라나(Solana) 주소 응답은 설계상 `no-store`입니다: 판정이 호출마다 계산되고 채우기가 진행되는 동안 `coverage_status`가 바뀝니다 — 그 필드를 읽으십시오, 그것은 `unknown`의 형제입니다).

## 어디서 시작합니까

[`/llms.txt`](https://stablescan.achivx.com/llms.txt)는 안내판입니다: 일곱 개 네트워크와 그 슬러그, URL 문법, 모든 기계용 파일을 각각 한 줄로. 매뉴얼 [`/agents.md`](https://stablescan.achivx.com/agents.md)는 서술입니다(2026-10-13 기준 16,540단어, 버전이 있으며, 파서를 대조할 변경 이력이 있음). 별도 페이지에서 다루는 API 카탈로그와 AI 카탈로그를 이용하면 클라이언트는 둘 중 어느 것도 읽지 않고 세 접근 경로를 찾을 수 있습니다.

## Stablecoin scanner ACHIVX에서

[Stablecoin scanner ACHIVX에서 llms.txt 열기 ↗](https://stablescan.achivx.com/llms.txt)

- 지도: [/llms.txt](https://stablescan.achivx.com/llms.txt). 매뉴얼: [/agents.md](https://stablescan.achivx.com/agents.md) — §1이 세 접근 경로를 나열합니다.
- 권위 있는 스키마와 한도: [/.well-known/agent-card.json](https://stablescan.achivx.com/.well-known/agent-card.json).
- 모든 REST 경로: [/openapi.json](https://stablescan.achivx.com/openapi.json).

## 출처

- [llms.txt — 호스트의 한 페이지 지도](https://stablescan.achivx.com/llms.txt)
- [에이전트 매뉴얼 — agents.md (버전 2026-10-05)](https://stablescan.achivx.com/agents.md)
- [A2A 에이전트 카드 (1.4.0)](https://stablescan.achivx.com/.well-known/agent-card.json)

## 더 알아보기

- [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/)
- [레슨: 접근 경로, 카드, 카탈로그](https://achivx.kr/academy/courses/the-scanner-for-agents/the-scanner-for-agents-01-the-doors-and-the-cards/)

## 관련 질문

- [Stablecoin scanner ACHIVX MCP 서버는 어떻게 연결합니까?](https://achivx.kr/academy/for-agents/how-to-connect-the-mcp-server/)
- [에이전트 카드는 무엇을 선언하며, A2A로 스킬을 어떻게 호출합니까?](https://achivx.kr/academy/for-agents/what-the-agent-card-declares/)
- [REST API는 어떻게 구성되어 있습니까?](https://achivx.kr/academy/for-agents/how-the-rest-api-is-organised/)

접근 경로 · 접근 경로 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다.

---

출처: https://achivx.kr/academy/for-agents/which-door-for-an-agent/ · 영어 원문: https://achivx.com/academy/for-agents/which-door-for-an-agent.html