ArcBox

Удаленный MCP-сервер в стиле PayBox для ChatGPT: каждый пользователь ChatGPT входит через OAuth, получает кошелек под управлением разработчика Circle в Arc Testnet и может отправлять USDC через Circle App Kit.

Что это делает

1. ChatGPT подключается к https://<your-host>/mcp с OAuth (не «No Auth»).

2. Пользователь создает учетную запись ArcBox или входит в систему.

3. ArcBox создает один кошелек Circle в ARC-TESTNET для этого пользователя (или использует существующий).

4. Затем ChatGPT может вызывать:

   • get_wallet — адрес, обозреватель, кран

   • get_balance — USDC в Arc Testnet

   • estimate_send_usdc — предварительный просмотр комиссии

   • send_usdc — App Kit kit.send() (требуется confirm: true)

   • list_transfers — недавние отправки из этого приложения

Related MCP server: circle-agent-stack-mcp

Предварительные требования

• Node.js 22+

• Тестовый API-ключ Circle Console

• Зарегистрированный секрет сущности

• Публичный HTTPS-URL, чтобы ChatGPT мог достичь этого сервера (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 web откройте Настройки и включите Режим разработчика

3. Плагины → Обзор плагинов → + → Новый плагин

4. Имя: ArcBox

5. URL сервера: URL /mcp

6. Аутентификация: OAuth — не оставляйте выбранным «No Auth»

7. Сохраните, подключитесь и завершите вход в ArcBox

Затем в чате:

Какой у меня кошелек Arc Testnet и баланс USDC?

Отправить 1.00 USDC на 0x…

send_usdc сначала возвращает предварительный просмотр, если только ChatGPT не передает confirm: true.

Модель аутентификации

• Код авторизации OAuth 2.1 + PKCE (S256)

• Динамическая регистрация клиента и документы метаданных идентификатора клиента

• Токены обновления (требуются ChatGPT)

• resource / audience привязаны к /mcp

• Один Circle EOA на пользователя ArcBox, внутри одного общего набора кошельков

Это хранение под управлением разработчика: 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:// (без завершающего слеша). После первого развертывания скопируйте URL Vercel в PUBLIC_URL и при необходимости выполните повторное развертывание.

4. URL плагина ChatGPT: https://your-project.vercel.app/mcp

Функции Vercel не имеют состояния. Локальное хранилище пользователей/кошельков в JSON находится в /tmp, поэтому учетные записи не сохраняются после холодного запуска. Подходит для тестового запуска; для реального использования добавьте базу данных.

Примечание о локальном использовании

ChatGPT не будет общаться с http://localhost. Используйте туннель или HTTPS-URL Vercel и установите PUBLIC_URL на этот источник.

Безопасность

• Только тестовая сеть

• Ежедневный лимит отправки через SEND_DAILY_LIMIT_USDC (по умолчанию 100)

• Отправки требуют явного аргумента инструмента confirm: true