ArcBox

ChatGPT용 PayBox 스타일 원격 MCP 서버: 각 ChatGPT 사용자가 OAuth로 로그인하면 Arc Testnet에서 Circle 개발자 제어 지갑을 받고, Circle App Kit을 통해 USDC를 보낼 수 있습니다.

기능

1. ChatGPT가 OAuth를 사용하여 https://<your-host>/mcp에 연결합니다("No Auth" 아님).

2. 사용자가 ArcBox 계정을 만들거나 로그인합니다.

3. ArcBox가 해당 사용자를 위해 ARC-TESTNET에 하나의 Circle 지갑을 생성합니다(또는 기존 지갑을 재사용합니다).

4. ChatGPT가 다음을 호출할 수 있습니다:

   • get_wallet — 주소, 탐색기, 수도꼭지

   • get_balance — Arc Testnet의 USDC

   • estimate_send_usdc — 수수료 미리보기

   • send_usdc — App Kit kit.send() (confirm: true 필요)

   • list_transfers — 이 앱의 최근 전송 내역

Related MCP server: circle-agent-stack-mcp

사전 요구 사항

• Node.js 22+

• Circle Console 테스트넷 API 키

• 등록된 엔터티 시크릿

• ChatGPT가 이 서버에 접근할 수 있는 공개 HTTPS URL (Cloudflare Tunnel 또는 ngrok)

설정

cd arcbox
copy .env.example .env

.env 편집:

PUBLIC_URL=https://your-tunnel-host
PORT=8787
COOKIE_SECRET=a-long-random-string
CIRCLE_API_KEY=TEST_API_KEY:...
CIRCLE_ENTITY_SECRET=your-64-char-entity-secret

npm install
npm run dev

브라우저에서 PUBLIC_URL을 열고 계정을 만드세요. /dashboard에 지갑 주소가 표시되는지 확인하세요. Circle 수도꼭지(Arc Testnet USDC)에서 자금을 조달하세요.

ChatGPT 연결

1. https://<your-host>/mcp 복사

2. ChatGPT 웹에서 설정을 열고 개발자 모드를 켜세요

3. 플러그인 → 플러그인 찾아보기 → + → 새 플러그인

4. 이름: ArcBox

5. 서버 URL: /mcp URL

6. 인증: OAuth — No Auth를 선택하지 마세요

7. 저장, 연결, ArcBox 로그인 완료

그런 다음 채팅에서:

내 Arc Testnet 지갑과 USDC 잔액은 무엇인가요?

1.00 USDC를 0x…로 보내기

send_usdc는 ChatGPT가 confirm: true를 전달하지 않으면 먼저 미리보기를 반환합니다.

인증 모델

• OAuth 2.1 인가 코드 + PKCE (S256)

• 동적 클라이언트 등록 및 클라이언트 ID 메타데이터 문서

• 리프레시 토큰 (ChatGPT 필수)

• resource / 대상이 /mcp에 바인딩됨

• ArcBox 사용자당 하나의 Circle EOA, 하나의 공유 지갑 세트 내

이는 개발자 제어 수탁입니다: Circle이 키를 보유하고, 서버가 엔터티 시크릿으로 서명합니다. 이를 비수탁형 PayBox 클론으로 취급하지 마세요.

Vercel에 배포

1. 이 저장소를 GitHub에 푸시하세요.

2. Vercel에서 저장소를 가져오세요.

3. Vercel 프로젝트에서 다음 환경 변수를 설정하세요:

PUBLIC_URL=https://your-project.vercel.app
COOKIE_SECRET=
CIRCLE_API_KEY=
CIRCLE_ENTITY_SECRET=
MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL=false

PUBLIC_URL은 실제 https:// 출처여야 합니다(후행 슬래시 없음). 첫 배포 후 Vercel URL을 PUBLIC_URL에 복사하고 필요한 경우 재배포하세요.

4. ChatGPT 플러그인 URL: https://your-project.vercel.app/mcp

Vercel 함수는 상태 비저장입니다. 로컬 JSON 사용자/지갑 저장소는 /tmp에 있으므로 계정이 콜드 스타트에서 유지되지 않습니다. 간단한 테스트에는 괜찮지만 실제 사용을 위해서는 데이터베이스를 추가하세요.

로컬 전용 참고 사항

ChatGPT는 http://localhost와 통신하지 않습니다. 터널 또는 Vercel HTTPS URL을 사용하고 PUBLIC_URL을 해당 출처로 설정하세요.

안전

• 테스트넷 전용

• SEND_DAILY_LIMIT_USDC를 통한 일일 전송 한도 (기본값 100)

• 전송에는 명시적인 confirm: true 도구 인수가 필요합니다