ArcBox

Ein PayBox-artiger Remote-MCP-Server für ChatGPT: Jeder ChatGPT-Benutzer meldet sich mit OAuth an, erhält eine Circle-entwicklerkontrollierte Wallet auf Arc Testnet und kann USDC über Circle App Kit senden.

Was es tut

1. ChatGPT verbindet sich mit OAuth (nicht “No Auth”) mit https://<your-host>/mcp.

2. Der Benutzer erstellt ein ArcBox-Konto oder meldet sich an.

3. ArcBox erstellt für diesen Benutzer eine Circle-Wallet auf ARC-TESTNET (oder verwendet die vorhandene erneut).

4. ChatGPT kann dann Folgendes aufrufen:

   • get_wallet — Adresse, Explorer, Faucet

   • get_balance — USDC auf Arc Testnet

   • estimate_send_usdc — Gebührenvorschau

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

   • list_transfers — letzte Sendungen dieser App

Related MCP server: circle-agent-stack-mcp

Voraussetzungen

• Node.js 22+

• Ein Circle Console-Testnet-API-Schlüssel

• Ein registriertes Entity-Secret

• Eine öffentliche HTTPS-URL, damit ChatGPT diesen Server erreichen kann (Cloudflare Tunnel oder ngrok)

Einrichtung

cd arcbox
copy .env.example .env

Bearbeite .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

Öffne PUBLIC_URL in einem Browser und erstelle ein Konto. Bestätige, dass auf /dashboard eine Wallet-Adresse angezeigt wird. Lade Guthaben über den Circle-Faucet (Arc Testnet USDC) auf.

ChatGPT verbinden

1. Kopiere https://<your-host>/mcp

2. Öffne in ChatGPT Web die Einstellungen und aktiviere den Entwicklermodus

3. Plugins → Plugins durchsuchen → + → Neues Plugin

4. Name: ArcBox

5. Server-URL: die /mcp-URL

6. Authentifizierung: OAuth — lass nicht “No Auth” ausgewählt

7. Speichern, verbinden und den ArcBox-Login abschließen

Dann im Chat:

Wie lautet meine Wallet auf Arc Testnet und mein USDC-Guthaben?

Sende 1.00 USDC an 0x…

send_usdc gibt zuerst eine Vorschau zurück, außer ChatGPT übergibt confirm: true.

Authentifizierungsmodell

• OAuth 2.1 Autorisierungscode + PKCE (S256)

• Dynamische Client-Registrierung und Client-ID-Metadaten-Dokumente

• Refresh-Tokens (von ChatGPT benötigt)

• resource / Audience gebunden an /mcp

• Eine Circle-EOA pro ArcBox-Benutzer, innerhalb eines gemeinsamen Wallet-Sets

Dies ist eine entwicklerkontrollierte Verwahrung: Circle hält die Schlüssel, dein Server signiert mit dem Entity-Secret. Behandle dies nicht wie einen nicht-verwahrenden PayBox-Klon.

Auf Vercel bereitstellen

1. Schiebe dieses Repository auf GitHub.

2. Importiere das Repository in Vercel.

3. Lege diese Umgebungsvariablen im Vercel-Projekt fest:

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

PUBLIC_URL muss die Live-Origin https:// sein (ohne abschließenden Schrägstrich). Nach dem ersten Deployment kopiere die Vercel-URL in PUBLIC_URL und stelle bei Bedarf erneut bereit.

4. ChatGPT-Plugin-URL: https://your-project.vercel.app/mcp

Vercel-Funktionen sind zustandslos. Der lokale JSON-Benutzer-/Wallet-Speicher befindet sich dort in /tmp, daher überleben Konten keine Kaltstarts. Für einen Rauchtest in Ordnung; für den echten Einsatz füge als Nächstes eine Datenbank hinzu.

Hinweis: Nur lokal

ChatGPT wird nicht mit http://localhost kommunizieren. Verwende einen Tunnel oder die Vercel-HTTPS-URL und setze PUBLIC_URL auf diese Origin.

Sicherheit

• Nur Testnet

• Tägliche Sendebegrenzung über SEND_DAILY_LIMIT_USDC (Standard: 100)

• Sendungen erfordern ein explizites confirm: true-Toolargument.