# Stablecoin scanner ACHIVX MCP 서버는 어떻게 연결합니까?

접근 경로 · 연결 명령 한 줄, 읽기 전용 도구 여덟 개, 모든 호출에 세션 id

*에이전트용 · 5분 · 고급 · 개발자 · MCP*

한 줄이면 됩니다: `claude mcp add stablescan --transport http https://stablescan.achivx.com/mcp`. 서버는 스트리밍 가능한 HTTP를 사용하고, 프로토콜 버전 2024-11-05부터 2025-11-25까지를 받으며, 키가 필요 없고, 스킬 이름을 밑줄로 바꾼 여덟 개의 도구를 나열합니다. 클라이언트 없이 하려면 `initialize`를 POST하고, 반환된 `Mcp-Session-Id` 헤더를 보관해 이후 모든 호출에 보내십시오 — 이 헤더가 없는 호출은 세션 초기화 중에 한 것으로 간주되어 거부됩니다.

## 서버 카드

[MCP 서버 카드](https://stablescan.achivx.com/mcp/server-card)는 `/mcp/server-card`(`application/mcp-server-card+json`)에서 제공됩니다. 2026-10-13 기준 내용: 이름 `com.achivx/stablescan`, `https://stablescan.achivx.com/mcp`에 있는 `streamable-http` 유형의 원격 하나, 지원 프로토콜 버전 `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`, 그리고 `_meta` 아래 연결 명령, 매뉴얼, 에이전트 카드. 설명: *Stablecoin Scanner — MCP를 통한 온체인 달러 관측. 주소별 컴플라이언스 사실(발행사 동결/소각, OFAC), 오염/노출과 통합 위험 판정, 열린 허용량 위험, 최근 전송, 지갑 그래프 탐색, 제재 목록 집계 범위, 일곱 개 네트워크에 걸친 인덱서 최신성. 읽기 전용, 무료, 인증 없음.* 카드에는 도구 목록이 없습니다 — 그것은 `tools/list`입니다.

## 클라이언트로 연결하기

```
claude mcp add stablescan --transport http https://stablescan.achivx.com/mcp
```

이 명령은 서버 카드, 에이전트 카드의 `x-mcp` 블록, 매뉴얼(§1)에 있습니다. 도구는 여덟 개의 스킬에서 `-`를 `_`로 바꾼 것입니다: `get_address_risk`, `get_address_compliance`, `get_address_exposure`, `get_address_approvals`, `get_sanctions_status`, `get_sync_status`, `get_recent_transactions`, `get_wallet_graph_walk`. 모든 도구에는 주석이 있으며 — `readOnlyHint`와 `idempotentHint`는 true, `destructiveHint`는 false, `openWorldHint`는 true(2026-10-13 `tools/list`에서 조회) — 언제 쓰는지, 대신 어떤 형제 도구를 쓸지, 부하가 걸릴 때 어떻게 동작하는지를 밝히는 설명이 있습니다.

## 클라이언트 없이 원시 스트리밍 HTTP로

매뉴얼의 세 단계로, 2026-10-13에 확인했습니다:

1. `Content-Type: application/json`과 `Accept: application/json, text/event-stream`으로 `initialize` 요청을 `POST /mcp`합니다. 응답은 이벤트 스트림이며, 그 `result`에는 `protocolVersion` — 요청한 버전, 우리 호출에서는 `2025-06-18` — 과 이름 `stablescan`, 버전 `1.4.0`의 `serverInfo`가 있습니다.
2. `Mcp-Session-Id` 응답 헤더를 저장합니다.
3. 이후 모든 호출에 그 헤더를 보냅니다. 헤더 없는 `tools/list`는 `code`가 `0`이고 메시지가 `method "tools/list" is invalid during session initialization`인 `error`로 답합니다 — HTTP `200` 이벤트 스트림 안에서이므로, 상태가 아니라 본문에 `error` 키가 있는지 검사하십시오(코드는 0입니다). 이것이 매뉴얼이 약속한 유형화된 응답이며, 조용히 비어 있는 목록이 아닙니다.

서버 카드에 나열된 네 가지 프로토콜 버전 중 하나를 요청하십시오. 응답의 `protocolVersion`이 세션이 실행되는 버전입니다.

세션 없는 `GET /mcp`에는 두 가지 응답이 있습니다: 브라우저는 클라이언트를 연결하는 방법을 보여 주는 페이지를 받습니다(매뉴얼 변경 이력, 2026-09-30). 2026-10-13 아무 옵션 없는 `curl`은 `Bad Request: GET requires an Mcp-Session-Id header`와 함께 `400`을 받았습니다 — `GET`은 열린 세션의 스트림이지, 들어가는 방법이 아닙니다.

## 부하가 걸릴 때

모든 `tools/call`은 REST, A2A와 같은 요청 마감 시간 아래에서 실행됩니다. 무거운 도구 여섯 개 — `get_address_risk`, `get_address_exposure`, `get_address_compliance`, `get_address_approvals`, `get_wallet_graph_walk`, `get_recent_transactions` — 는 *서버당 고정된 수의 슬롯을 공유합니다*(매뉴얼, §6). 잠시 안에 빈 슬롯을 찾지 못한 호출은 아무것도 읽지 않고 `busy: too many concurrent reads on this server; retry shortly`로 답합니다. 마감 시간을 넘긴 읽기는 `timeout: the read did not finish within the deadline; retrying may succeed`로 답합니다. 둘 다 텍스트가 `busy:` 또는 `timeout:`으로 시작하는 `isError: true` 도구 결과로 도착합니다 — JSON-RPC `error`가 아니라 `result`입니다. 매뉴얼은 주소, 체인, 토큰 또는 기간 형식이 잘못된 호출은 *슬롯을 기다리기 전에 입력 오류로 거부된다고* 덧붙입니다. 간격을 두고 재시도하되, 반복하지 마십시오.

## Stablecoin scanner ACHIVX에서

[MCP 서버 카드 열기 ↗](https://stablescan.achivx.com/mcp/server-card)

- 엔드포인트: [/mcp](https://stablescan.achivx.com/mcp) — 브라우저로 열면 연결 방법이 표시되고, 클라이언트는 그곳에 `initialize`를 `POST`합니다.
- 카드: [/mcp/server-card](https://stablescan.achivx.com/mcp/server-card) — 연결 명령은 그 `_meta`에 있습니다.
- 에이전트 카드의 `x-mcp`에 있는 같은 명령: [/.well-known/agent-card.json](https://stablescan.achivx.com/.well-known/agent-card.json).
- [MCP](https://stablescan.achivx.com/mcp), 세션, `busy`, `timeout`에 관한 매뉴얼 §1과 §6: [/agents.md](https://stablescan.achivx.com/agents.md).

## 출처

- [MCP 서버 카드](https://stablescan.achivx.com/mcp/server-card)
- [에이전트 매뉴얼 — 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/courses/the-scanner-for-agents/the-scanner-for-agents-02-one-question-three-doors/)
- [한도](https://achivx.kr/academy/reference/limits/)

## 관련 질문

- [에이전트는 어떤 접근 경로를 써야 합니까 — MCP, A2A, REST, 아니면 Markdown 페이지?](https://achivx.kr/academy/for-agents/which-door-for-an-agent/)
- [한도는 무엇이며, 거부는 어떤 모습입니까?](https://achivx.kr/academy/for-agents/what-are-the-limits-and-refusals/)
- [get-address-risk는 무엇을 반환하며, 언제 호출합니까?](https://achivx.kr/academy/for-agents/get-address-risk/)

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

---

출처: https://achivx.kr/academy/for-agents/how-to-connect-the-mcp-server/ · 영어 원문: https://achivx.com/academy/for-agents/how-to-connect-the-mcp-server.html