ArcBox

Un servidor MCP remoto estilo PayBox para ChatGPT: cada usuario de ChatGPT inicia sesión con OAuth, obtiene una billetera controlada por el desarrollador de Circle en Arc Testnet y puede enviar USDC a través de Circle App Kit.

Qué hace

1. ChatGPT se conecta a https://<your-host>/mcp con OAuth (no "Sin autenticación").

2. El usuario crea una cuenta de ArcBox o inicia sesión.

3. ArcBox crea una billetera de Circle en ARC-TESTNET para ese usuario (o reutiliza la existente).

4. ChatGPT puede entonces llamar a:

   • get_wallet — dirección, explorador, faucet

   • get_balance — USDC en Arc Testnet

   • estimate_send_usdc — vista previa de comisión

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

   • list_transfers — envíos recientes de esta aplicación

Related MCP server: circle-agent-stack-mcp

Requisitos previos

• Node.js 22+

• Una clave de API de testnet de Circle Console

• Un secreto de entidad registrado

• Una URL HTTPS pública para que ChatGPT pueda alcanzar este servidor (Cloudflare Tunnel o ngrok)

Configuración

cd arcbox
copy .env.example .env

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

Abre PUBLIC_URL en un navegador y crea una cuenta. Confirma que aparece una dirección de billetera en /dashboard. Fínciala desde el faucet de Circle (Arc Testnet USDC).

Conectar ChatGPT

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

2. En ChatGPT web, abre Ajustes y activa el Modo desarrollador

3. Plugins → Explorar plugins → + → Nuevo plugin

4. Nombre: ArcBox

5. URL del servidor: la URL /mcp

6. Autenticación: OAuth — no dejes seleccionado "Sin autenticación"

7. Guarda, conecta y completa el inicio de sesión de ArcBox

Luego en el chat:

¿Cuál es mi billetera de Arc Testnet y mi saldo de USDC?

Enviar 1.00 USDC a 0x…

send_usdc primero devuelve una vista previa a menos que ChatGPT pase confirm: true.

Modelo de autenticación

• Código de autorización OAuth 2.1 + PKCE (S256)

• Registro dinámico de cliente y Documentos de metadatos de ID de cliente

• Tokens de actualización (requeridos por ChatGPT)

• resource / audiencia vinculada a /mcp

• Una EOA de Circle por usuario de ArcBox, dentro de un conjunto de billeteras compartido

Esto es custodia controlada por el desarrollador: Circle tiene las claves, tu servidor firma con el secreto de entidad. No lo trates como un clon no custodio de PayBox.

Desplegar en Vercel

1. Sube este repositorio a GitHub.

2. Importa el repositorio en Vercel.

3. Establece estas variables de entorno en el proyecto de 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 debe ser el origen https:// en vivo (sin barra inclinada final). Después del primer despliegue, copia la URL de Vercel en PUBLIC_URL y redepliega si es necesario.

4. URL del plugin de ChatGPT: https://your-project.vercel.app/mcp

Las funciones de Vercel no tienen estado. El almacén local de usuarios/billeteras en JSON reside en /tmp allí, por lo que las cuentas no sobreviven a arranques en frío. Aceptable para una prueba rápida; para uso real añade una base de datos después.

Nota solo local

ChatGPT no hablará con http://localhost. Usa un túnel, o la URL HTTPS de Vercel, y establece PUBLIC_URL a ese origen.

Seguridad

• Solo testnet

• Límite diario de envío mediante SEND_DAILY_LIMIT_USDC (por defecto 100)

• Los envíos requieren un argumento de herramienta explícito confirm: true