whollycrypto.
한국어

AI 연결 · MCP

AI 도우미를 연결하세요.

내 Wholly Crypto 설치에서 결제를 찾고 잔액을 확인하고 청구서를 만드세요.

내 서버, 하나의 MCP URL.

판매자 버전에 포함: 5.0.0+. 별도 데몬, Node.js 런타임, 호스팅 릴레이는 필요 없어요. 설치에 설정된 API 도메인을 사용하세요. 예: https://api.example.com/mcp.

  1. 열기 설정 → API 접근. 전용 인증 정보를 만들고 도우미에게 필요한 프로젝트를 지정하세요. 읽기 전용으로 시작하세요.
  2. 다음에서: AI 연결 · MCP, MCP를 켜세요. 인증 정보를 고르고 다음을 선택하세요: 읽기 전용 하고 저장하세요.
  3. 표시된 URL을 도우미의 원격 HTTP/MCP 설정에 추가하세요.
  4. OAuth를 쓰려면 판매자 콘솔에 로그인하세요. 클라이언트 이름, 반환 주소, 인증 정보 권한을 확인한 뒤 승인하세요. 기존 Basic Auth와 TOTP도 계속 적용돼요.
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

예제 도메인을 바꾸세요. 설정 형식은 클라이언트마다 달라요. 로컬 명령이나 이전 SSE URL이 아닌 Streamable HTTP를 선택하세요.

결제에 대해 물어보세요.

  • “내 스토어의 최근 미결제 청구서를 보여줘.”
  • “이 스토어에서 어떤 자산을 받을 수 있어?”
  • “지갑 잔액과 실패한 웹훅 전송을 확인해 줘.”
  • “주문 1042에 대해 25 EUR 청구서를 만들어 줘.” 청구서 생성 권한이 필요해요.

읽기 도구 8개로 프로젝트, 스토어, 결제 수단, 지갑, 청구서, 전송 내역, 캐시된 환산을 다뤄요. 선택 가능한 아홉 번째 도구는 기존 API 규칙에 따라 청구서를 만들어요.

결과에는 프로젝트와 스토어 ID가 포함돼요. 금액은 십진수 문자열로 유지돼요. 캐시된 환율과 잔액은 최신성 정보를 유지하며 환산은 보장된 청구서 견적이 아니에요.

도우미가 접근할 대상을 선택하세요.

MCP는 업그레이드 후에도 기본적으로 꺼져 있어요. 기존 API 키에 접근 권한이 자동 추가되지 않아요. 도우미는 승인한 프로젝트만 볼 수 있고 IP 제한과 인증 정보의 REST 요청 제한도 MCP에 적용돼요.

청구서를 만들려면 읽기·쓰기 인증 정보와 다음을 선택하세요: 읽기 + 청구서 생성. OAuth 클라이언트는 다음을 요청해야 해요: mcp:invoice:create, 그리고 다음을 선택해야 해요: 청구서 생성도 허용 를 승인할 때 선택하세요.

같은 항목을 다시 사용하세요: idempotency_key 와 청구서 본문을 시간 초과 후에도 그대로 사용하세요. 새 키는 새 청구서를 만들어요. 일반 스프레드, 허용 오차, 결제, 크레딧 규칙은 계속 적용돼요.

키 내보내기나 송금 도구는 없어요. MCP는 복구 구문 공개, 송금, 자금 모으기, 환불, 콜백 재전송, 계정·도메인·청구 변경을 할 수 없어요.

OAuth, Bearer 키, 접근 철회

OAuth 접근 토큰은 15분 동안 유효해요. 갱신 토큰은 교체되며 연결은 최대 30일 유지돼요. 이전 갱신 토큰을 재사용하면 연결이 철회돼요. 등록된 HTTPS 또는 루프백 반환 URL만 허용해요.

사용 연결된 클라이언트 → 철회 로 접근을 해제하세요. MCP를 끄면 OAuth 연결도 철회돼요. 인증 정보 교체, MCP 정책 변경, 기본 API 도메인 변경 시 새 연결이 필요해요.

사용자 지정 헤더를 지원하는 클라이언트는 MCP가 활성화된 API 키를 다음에 사용할 수 있어요: Authorization: Bearer …. 해당 키는 별도의 REST 권한을 유지하므로 MCP 전용 접근에는 OAuth를 권장해요. 비밀 정보를 채팅, URL, 소스 코드에 붙여 넣지 마세요.

아는 클라이언트만 승인하세요. 클라이언트 이름은 검증되지 않아요. AI 제공업체는 청구서 도구가 반환한 고객 데이터를 포함해 읽기를 허용한 정보를 받게 돼요.

연결이 실패한다면.

  • 404: MCP를 켜고 콘솔이나 결제 호스트가 아닌 API 호스트를 사용하세요.
  • 401: OAuth로 다시 연결하거나 Bearer 인증 정보가 유효한지 확인하세요.
  • 403: 인증 정보 접근 권한, 승인한 프로젝트, 오리진, 원본 IP 제한을 확인하세요.
  • GET 요청에 405: 정상이에요. 이 무상태 엔드포인트는 POST와 종료되는 JSON 응답을 사용하며 별도 SSE 스트림은 없어요.
  • 429: 다음을 기다리세요: Retry-After. MCP와 REST는 인증 정보의 할당량을 공유해요.
  • 청구서 생성 불가: 모든 쓰기 권한, 프로젝트·스토어 상태, 결제 준비 상태, 크레딧 계정 검증을 확인하세요.

다음 경로에는 Cloudflare 캐시와 대화형 인증을 끄세요: /mcp, /mcp/oauth/* 및 OAuth 검색 경로에 적용하세요. IP 허용 목록에는 도우미 서비스가 문서에 명시한 송신 주소를 포함해야 해요.

지원 프로토콜 버전: 2025-11-25, 2025-06-18 및 2025-03-26. 클라이언트는 이 중 하나를 지원해야 해요. 다음을 참고하세요: API 레퍼런스 에서 모든 도구, 엔드포인트, 오류 형식을 확인하세요.

청구서별로 결제 수단을 선택하세요.

사용 invoice.payment_methods 및 chain_slug: "ethereum" 및 asset_tickers: ["USDC", "USDT"]. 스토어의 결제 수단 또는 다음으로 슬러그와 티커를 찾으세요: list_payment_methods.

판매자 버전 5.4.0+는 비활성 또는 허용되지 않은 선택지를 무시해요. 일치 항목이 없으면 스토어 기본값을 사용해요. 체인만 지정하면 활성화된 수락 자산이 모두 포함돼요. 티커가 같다면 정확한 다음 값이 필요해요: asset_ids. 준비 상태와 환율 검사는 그대로 적용되며 체인별 오류를 반환해요. Lightning은 별도이며 빈 선택 배열은 유효하지 않아요. 요청 형식 →