본문으로 건너뛰기

MCP 에이전트 설정

프로필 DM_TOKEN으로 AI 클라이언트를 Domestic Monero 호스팅 MCP 엔드포인트에 연결합니다. 이 페이지는 설치만 다룹니다.

MCP 엔드포인트(이 URL을 붙여 넣으세요): https://mcp.domesticmonero.com/mcp

호스트 루트 https://mcp.domesticmonero.com은 MCP 경로가 아닙니다. 클라이언트는 /mcp를 써야 합니다.

준비물​

  1. 공식 봇에서 미니앱을 엽니다.
  2. 미니앱에서 프로필에 들어갈 수 있어야 합니다.

공식 봇: @domestic_monero_bot — 미니앱 열기

텔레그램에서 열기
공식 채널만 이용하세요

Domestic Monero에는 별도 지원 계정, 헬프데스크 채팅, 제3자 복구 서비스가 없습니다. 공식 봇에만 메시지를 보내세요.

공식 봇: @domestic_monero_bot — 미니앱 열기

프로필에서 토큰 발행​

  1. 미니앱 → 프로필을 엽니다.
  2. MCP access를 엽니다.
  3. 토큰을 발행합니다. 전체 값은 한 번만 보이니, 나타났을 때 복사하세요. 토큰은 dm_로 시작합니다.
  4. DM_TOKEN으로 저장합니다. 클라이언트는 Authorization: Bearer <DM_TOKEN>을 보냅니다.

활성 토큰은 하나만 둘 수 있습니다. 교체하려면 현재 토큰을 Revoke한 뒤 다시 발행하세요.

텔레그램 미니앱 프로필 MCP token ready 모달(라이트) — 토큰 값은 흐림. MCP URL과 Setup guide(Archive) 링크 표시.텔레그램 미니앱 프로필 MCP token ready 모달(다크) — 토큰 값은 흐림. MCP URL과 Setup guide(Archive) 링크 표시.
프로필 → MCP access에서 발행 후 — 토큰을 한 번만 복사하고, MCP URL을 확인한 뒤 Setup guide를 엽니다.

계약​

설정값
URLhttps://mcp.domesticmonero.com/mcp
AuthAuthorization: Bearer <DM_TOKEN>

dm_YOUR_TOKEN_HERE를 발행한 토큰으로 바꾸세요. 실제 토큰을 커밋하지 마세요.

Cursor​

프로젝트 파일: .cursor/mcp.json — 또는 전역 ~/.cursor/mcp.json.

{
  "mcpServers": {
    "domestic-monero": {
      "url": "https://mcp.domesticmonero.com/mcp",
      "headers": {
        "Authorization": "Bearer dm_YOUR_TOKEN_HERE"
      }
    }
  }
}

사용 필드: url, headers.Authorization(Cursor 원격 MCP 형식). 선택: 환경 변수에 토큰이 있으면 Bearer ${env:DM_TOKEN}.

Cursor에서 MCP 서버를 다시 로드한 뒤(Customize → MCP) 아래 확인을 실행하세요.

Claude Desktop​

Claude Desktop의 claude_desktop_config.json은 원격 url + headers 블록을 받지 않습니다. 커스텀 커넥터(Claude Desktop / claude.ai)에서 다음 필드를 쓰세요.

필드값
MCP server URLhttps://mcp.domesticmonero.com/mcp
AuthenticationNo sign-in
Request headers → header nameAuthorization
Request headers → valueBearer dm_YOUR_TOKEN_HERE (Bearer 접두사 포함)

순서: Customize → Connectors → Add custom connector → URL 붙여 넣기 → No sign-in 선택 → Authorization 요청 헤더 추가 → 저장. 채팅에서 커넥터를 켠 뒤 아래 확인을 실행하세요.

플랜이 claude_desktop_config.json에서 로컬 stdio만 지원하면 mcp-remote로 연결하세요.

{
  "mcpServers": {
    "domestic-monero": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.domesticmonero.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer dm_YOUR_TOKEN_HERE"
      }
    }
  }
}

사용 필드: command, args(mcp-remote + --header), env.AUTH_HEADER. Authorization:${AUTH_HEADER} 형식에서 : 앞뒤에 공백을 넣지 마세요.

일반 HTTP​

Bearer 토큰 없이 요청하면 서버는 401과 다음 JSON-RPC 오류를 반환합니다.

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authorization Bearer required (DM_TOKEN)"
  },
  "id": null
}
curl -sS -X POST 'https://mcp.domesticmonero.com/mcp' \
  -H 'Authorization: Bearer dm_YOUR_TOKEN_HERE' \
  -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": "curl", "version": "0" }
    }
  }'

유효한 Bearer 형식이면 MCP 세션에 도달합니다(SSE event: message, serverInfo.name = domesticmonero). 도구 호출에는 유효한 프로필 토큰이 필요합니다.

확인​

클라이언트가 연결된 뒤 **auth_whoami**를 호출하세요(인자 없음).

성공: 토큰을 발행한 내 미니앱 프로필 JSON — 빈 껍데기나 다른 사용자 데이터가 아님.

도구가 없거나 인증이 실패하면: URL이 /mcp로 끝나는지, 헤더가 Authorization: Bearer …인지, 토큰이 폐기되지 않았는지 확인하세요. 더 많은 경우: MCP 도구 → 문제 해결.

안전하게 쓰기​

  • DM_TOKEN을 채팅, 그룹 메시지, 스크린샷에 붙여 넣지 마세요.
  • 토큰이 새어 나갔다면 프로필 → MCP access에서 Revoke한 뒤 새로 발행하세요.
  • https://mcp.domesticmonero.com/mcp와 공식 봇 딥 링크만 쓰세요.
  • 호스트가 지원하면 도구 승인/허용 목록을 쓰세요 — 에이전트는 노출된 모든 도구를 호출할 수 있습니다.
  • 사람의 도움이 필요하면 공식 봇에 /support를 보내고, 거래가 걸려 있으면 Trade #ref를 함께 적으세요. 거래 취소, 오퍼 취소, /support를 보세요.

다음​

공식 봇: @domestic_monero_bot — 미니앱 열기

텔레그램에서 열기
최종 수정: 에