prime-agent-stripe-mcp

Prime Agent용 공식 Stripe MCP 통합.

Prime Agent는 https://mcp.stripe.com에서 Stripe의 공식 원격 MCP 서버에 연결합니다. 그러면 에이전트는 다른 MCP 클라이언트와 동일한 API 표면을 통해 Stripe 리소스를 검사하고 관리할 수 있습니다.

[!NOTE] Stripe의 MCP 서버는 공개 미리보기 상태입니다. 읽기 및 쓰기 도구를 모두 노출합니다. 개발 중에는 연결을 테스트 모드로 유지하세요.

┌─────────────────────────────────┐                      ┌─────────────────────────────────┐
│ │ 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 커널에서 실시간 도구 인벤토리를 노출합니다.

• PKCE가 포함된 OAuth 2.1 — 브라우저 승인은 mcp:stripe 아래 Prime Agent의 비공개 auth.json에만 저장됩니다.

• 테스트 모드 친화적 — Liminal Stripe 계정을 승인하고 개발 중에는 테스트 모드 리소스만 사용하세요.

Related MCP server: stripe-mcp

설치

Python 커널과 Python 3.10 이상이 포함된 Prime Agent가 필요합니다.

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. 원격 서버를 Prime Agent의 MCP 설정에 한 번 추가합니다:

   {
     "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()는 비밀 정보 없이 작은 dict를 반환합니다:

{"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는 main에 대한 모든 푸시에서 독립 실행형 스위트를 실행합니다.

보안

• 이 저장소 또는 Git 기록에는 자격 증명이 없습니다.

• OAuth 토큰은 Prime Agent의 비공개 auth.json에만 있습니다.

• 모듈은 https://mcp.stripe.com 및 Stripe의 OAuth 권한 부여 서버와만 통신합니다.

• 모든 개발 변경 사항을 Stripe 테스트 모드로 유지하세요.

• Stripe 비밀 값이나 개인 키 자료를 소스, 테스트, 문서 또는 Git 기록에 절대 넣지 마세요.

라이선스

MIT — LICENSE를 참조하세요. Stripe는 Stripe, Inc.의 상표입니다. 이는 Stripe 공식 MCP 서버에 대한 독립적인 클라이언트 통합입니다 (NOTICE 참조).