prime-agent-stripe-mcp

Официальная Stripe MCP-интеграция для Prime Agent.

Prime Agent подключается к официальному удалённому MCP-серверу Stripe по адресу https://mcp.stripe.com. Затем агент может просматривать и управлять ресурсами Stripe через тот же API-интерфейс, что и другие MCP-клиенты.

[!NOTE] MCP-сервер Stripe находится в публичной предварительной версии. Он предоставляет как инструменты чтения, так и записи. Держите подключение в тестовом режиме во время разработки.

┌─────────────────────────────────┐                      ┌─────────────────────────────────┐
│ │ from stripe import         │  │                      │ │ mcp.stripe.com              │ │
│ │   stripe                   │  │                      │ │ API · billing · reporting   │ │
│ │ await stripe.list_tools()  │──┼   OAuth 2.1 + PKCE   │ │ products · customers        │ │
│ │ await stripe.call_tool(    │  │                      │ │ subscriptions · events      │ │
│ auth.json: mcp:stripe           │                      │ │ documentation search        │ │
└─────────────────────────────────┘                      └─────────────────────────────────┘

Зачем эта интеграция

• Сервер, размещённый на Stripe — без самостоятельного прокси и без ключа Stripe API в этом репозитории.

• Нативный для Prime Agent — модуль расширяет McpIntegration и предоставляет живой список инструментов из ядра Python.

• OAuth 2.1 с PKCE — одобрение в браузере хранится только в приватном auth.json Prime Agent в разделе mcp:stripe.

• Удобно для тестового режима — авторизуйте аккаунт Liminal Stripe и используйте только ресурсы тестового режима во время разработки.

Related MCP server: stripe-mcp

Установка

Требуется Prime Agent с его ядром Python и Python 3.10 или новее.

1. Клонируйте репозиторий и свяжите навык на место:

   git clone https://github.com/gbrlpzz/prime-agent-stripe-mcp.git ~/prime-agent-stripe-mcp
   rm -rf ~/.agents/skills/stripe
   ln -s ~/prime-agent-stripe-mcp ~/.agents/skills/stripe

2. Установите редактируемый пакет в среду ядра Prime Agent:

   uv pip install --python ~/.prime/agent/kernel-venv/bin/python -e ~/prime-agent-stripe-mcp

3. Добавьте удалённый сервер в настройки MCP Prime Agent один раз:

   {
     "mcpServers": {
       "stripe": {
         "type": "http",
         "url": "https://mcp.stripe.com",
         "oauth": true
       }
     }
   }

4. Перезагрузите Prime Agent и авторизуйте аккаунт Stripe:

   /reload
   /mcp login stripe

Одобрите аккаунт Liminal Stripe, а не личный или производственный аккаунт, который должен оставаться вне этого рабочего процесса разработки. Prime Agent хранит учётные данные как mcp:stripe. Они никогда не записываются в этот репозиторий.

Использование

from stripe import stripe, auth_status

print(auth_status())               # credential state, no token values
tools = await stripe.list_tools()  # live Stripe MCP inventory
# Inspect the live schema before calling a read or write tool.
result = await stripe.call_tool("<live-tool-name>", {"<live-argument>": "..."})

auth_status() возвращает небольшой словарь без секретов:

{"enabled": True, "expires_fresh": True, "type": "oauth"}

Имена инструментов и параметры принадлежат Stripe и могут меняться во время публичной предварительной версии. Сначала вызовите list_tools() или используйте методы, автоматически привязанные из живого списка.

Сервер включает инструменты для обнаружения Stripe API, чтения и записи API, информации об аккаунте, биллинговых ресурсов, документации и отчётности. Операции записи изменяют данные Stripe. Запрашивайте подтверждение человека перед созданием, обновлением, отменой, возвратом или удалением чего-либо.

Запасной вариант обновления токена

Prime Agent автоматически обновляет сохранённый токен. На хостах, где это недоступно, вызовите запасной вариант на уровне модуля:

from stripe import refresh

refresh()  # exchanges the stored refresh token; rewrites auth.json with mode 600

Рабочий процесс разработки Liminal

1. Добавьте своего личного пользователя как участника команды аккаунта Liminal Stripe.

2. Авторизуйте эту интеграцию от имени этого пользователя.

3. Убедитесь, что панель Stripe находится в тестовом режиме.

4. Создавайте только тестовые продукты, цены, клиентов и подписки.

5. Настройте функцию Supabase stripe-webhook с полученным тестовым секретом подписи вебхука отдельно. Учётные данные MCP не заменяют серверные STRIPE_SECRET_KEY или STRIPE_WEBHOOK_SECRET.

Устранение неполадок

Разработка

python3 tests/test_skill.py                             # standalone suite, no Prime Agent needed
~/.prime/agent/kernel-venv/bin/python -m pytest tests/  # inside Prime Agent's kernel

CI запускает автономный набор тестов при каждом push в main.

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

• В этом репозитории или его истории Git нет учётных данных.

• OAuth-токены хранятся только в приватном auth.json Prime Agent.

• Модуль взаимодействует только с https://mcp.stripe.com и сервером авторизации OAuth Stripe.

• Держите все изменения при разработке в тестовом режиме Stripe.

• Никогда не помещайте секретные значения Stripe или материалы закрытых ключей в исходный код, тесты, документацию или историю Git.

Лицензия

MIT — см. LICENSE. Stripe является товарным знаком Stripe, Inc.; это независимая клиентская интеграция для официального MCP-сервера Stripe (см. NOTICE).