Skip to content

docs(x402-mcp): README の x402 profile 設定例を keystore 方式へ - #546

Merged
cipherwebllc merged 1 commit into
mainfrom
docs/mcp-readme-keystore-first
Sep 21, 2026
Merged

cipherwebllc merged 1 commit into
mainfrom
docs/mcp-readme-keystore-first

Conversation

@cipherwebllc

Copy link
Copy Markdown
Owner

何を直すか

packages/x402-mcp/README.md の x402 profile の設定例 (Claude Desktop / Claude Code) が SIGNER_MODE=env-key + "BUYER_PRIVATE_KEY": "0x..." のままで、コピーすると MCP が起動時に停止する (#534#544 と同じ問題の最後の 1 箇所)。

  • 2 つの例を SIGNER_MODE=keystore に (秘密鍵の欄なし)
  • 例の直後に 1 段落: wallet_init で手元にウォレットを作る → 返ったアドレスへ入金・仮の鍵を書くと起動時に拒否される・env-key / steward は Signer Modes へ
  • 公開前の段取りメモ (「Publish SDK first, then MCP…」) は公開済みで古いので「Requires openpay-x402-mcp 0.15.0 or later (SDK 0.9.0). Keep the package version pinned.」に置き換え

変更なし: Signer Modes の説明・Environment 表・Local wallet threat model (ハッシュ固定のテストが通ることを確認)・コード。

公開文言 (要承認)

英語の追加 1 段落と置き換え 1 行は diff のとおり。merge は文言の承認後。npm 上の README は次回 publish で反映 (GitHub 上は merge で反映)。

検証

  • tests/packages/x402-mcp-wallet-docs.test.ts に回帰フェンスを追加 (x402 profile の JSON 例は keystore・BUYER_PRIVATE_KEY を含まない)・threat model のハッシュテストも pass
  • eslint OK・コード変更なし (README + test のみ)

🤖 Generated with Claude Code

https://claude.ai/code/session_01HeizmagJBgL5peL5mQpxkc

…する例をなくす)

x402 profile の Claude Desktop / Claude Code の例が env-key + BUYER_PRIVATE_KEY: "0x..." の
ままで、コピーすると MCP が起動時に停止する。/agent・/guide/ai-pay・agent-templates と同じ
keystore にそろえ、wallet_init の流れと「仮の鍵を書かない」を 1 段落で案内する。
env-key / steward の説明 (Signer Modes・Environment 表) と threat model は変更なし。

公開前の段取りメモ (SDK → MCP → Web の順に公開…) は公開済みで古いので 1 行に置き換え。
npm 上の README は次回 publish で反映される。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HeizmagJBgL5peL5mQpxkc
@vercel

vercel Bot commented Sep 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
openpay Ignored Ignored Preview Sep 21, 2026 7:39pm UTC

Request Review

@cipherwebllc
cipherwebllc merged commit 3381396 into main Sep 21, 2026
7 checks passed
@cipherwebllc
cipherwebllc deleted the docs/mcp-readme-keystore-first branch September 21, 2026 20:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant