MetaMask Embedded Wallets (Web3Auth) MCP

MetaMask Embedded Wallets MCP サーバー

AI コーディングアシスタントがドキュメントや SDK の詳細な知識にリアルタイムでアクセスできるようにすることで、MetaMask Embedded Wallets のインテグレーションをより迅速に構築できます。

設定するものは 2 つあります。

1. スキル — SDK のアーキテクチャ、フレームワーク固有の注意点、鍵導出のルール、よくある間違いなど、SDK に対する考え方を AI アシスタントに教えます。スキルにはコードは含まれません。コードは MCP が提供します。
2. MCP サーバー — ドキュメントの検索、サンプルの取得、SDK の型の参照を、AI アシスタントがリアルタイムで行えるようにします。

---

MCP ツール

ツール	内容
search_docs	ドキュメントとサンプルプロジェクトを検索します
get_doc	任意のドキュメントページの全内容を取得します
get_example	インテグレーションサンプルのソースコード全体を取得します
get_sdk_reference	オープンソースリポジトリから SDK の型とフックを取得します
search_community	MetaMask Builder Hub で実際のユーザーの問題を検索します

---

スキル

このスキルは、MetaMask Embedded Wallets のメンタルモデルを AI アシスタントに教えます。SDK の選択ロジック、鍵導出のルール、認証の概念、プラットフォーム固有の注意点、ドキュメントだけでは分かりにくいよくある間違いなどが含まれます。

ヒント： 最適な利用体験を得るには、スキルと併せて MCP サーバーを使用してください。LLM が静的なテキストに頼らず、最新のドキュメントやサンプルを取得できます。

共通インストール（40 以上のエージェントに対応）

npx skills add web3auth/skill

Vercel の skills CLI は、アクティブな AI エージェントを検出して、適切なディレクトリに自動でインストールします。Cursor、Claude Code、Copilot、Kiro、Cline、Codex、Antigravity、その他40 以上に対応しています。

特定のエージェントを指定してインストールするには：

npx skills add web3auth/skill -a cursor     # Cursor only
npx skills add web3auth/skill -a claude-code # Claude Code only

---

MCP サーバーのセットアップ

Cursor

最も簡単なのは、ワンクリックでインストールする方法です。

または、Cursor Marketplace からインストールします。「MetaMask Embedded Wallets」を検索してください。

手動で追加することもできます。Cursor Settings → Tools & Integrations → MCP を開き、次を追加します。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

VS Code（GitHub Copilot）

Visual Studio Marketplace からインストールします。「MetaMask Embedded Wallets」を検索してください。または：

code --install-extension Web3Auth.metamask-embedded-wallets

ワンクリックインストール URL を使うこともできます。

vscode:mcp/install?{"name":"web3auth","url":"https://mcp.web3auth.io"}

または、ワークスペースの .vscode/mcp.json に手動で追加します。

{
  "servers": {
    "web3auth": {
      "type": "http",
      "url": "https://mcp.web3auth.io"
    }
  }
}

JetBrains（IntelliJ、PyCharm、WebStorm、Android Studio）

JetBrains Marketplace からインストールします。「MetaMask Embedded Wallets」を検索してください。

または、Settings → Tools → AI Assistant → Model Context Protocol (MCP) で手動で追加します。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io",
      "transport": "http"
    }
  }
}

Claude Code CLI

claude mcp add --transport http web3auth https://mcp.web3auth.io

または、プロジェクトの claude.json に手動で追加します。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Claude Desktop

Claude Desktop の設定ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServers セクションにサーバーを追加します。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Claude Desktop を再起動し、「MetaMask Embedded Wallets のドキュメントで React のクイックスタートを検索して」と尋ねて、接続を確認します。

ChatGPT Desktop

ChatGPT Desktop → Settings → Connections を開き、新しい MCP サーバーを追加します。

• 名前：web3auth
• URL：https://mcp.web3auth.io

Windsurf

Windsurf Settings → MCP を開き、次を追加します。

{
  "mcpServers": {
    "web3auth": {
      "serverUrl": "https://mcp.web3auth.io"
    }
  }
}

または、~/.codeium/windsurf/mcp_config.json を直接編集します。

Kiro（AWS）

プロジェクトの .kiro/settings/mcp.json に追加します。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Warp Terminal

Warp で Settings → AI → MCP Servers を開き、Add Server をクリックします。

• 名前：web3auth
• URL：https://mcp.web3auth.io

または、お使いのバージョンで利用できる場合は、Warp のワンクリック MCP インストールを使用します。

Cline（VS Code）

Cline の MCP 設定に追加します（Ctrl+Shift+P →「Cline: Open MCP Settings」）。

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io",
      "transport": "http"
    }
  }
}

Continue.dev

Continue の config.json に追加します（Ctrl+Shift+P →「Continue: Open config.json」で開きます）：

{
  "mcpServers": [
    {
      "name": "web3auth",
      "url": "https://mcp.web3auth.io"
    }
  ]
}

Zed

Zed の settings.json に追加します（Cmd+, で開きます）：

{
  "context_servers": {
    "web3auth": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]
      }
    }
  }
}

または、Zed Extensions から「MetaMask Embedded Wallets」を検索してインストールします。

Antigravity

MCP 設定ファイルを開きます：

• macOS/Linux：~/.config/antigravity/mcp.json
• Windows：%APPDATA%\antigravity\mcp.json

mcpServers セクションにサーバーを追加します：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Antigravity は MCP 設定の変更をホットリロードするため、再起動は不要です。

Xcode（GitHub Copilot 経由）

Xcode 26.3+ は GitHub Copilot 経由で MCP をサポートしています。Copilot の MCP 設定にサーバーを追加するか、上記の VS Code 拡張機能の設定を使用してください（Copilot の MCP レジストリは共有されています）。

または、「設定」→「Copilot」→「MCP Servers」から、Xcode のエージェントツールが https://mcp.web3auth.io を直接参照するように設定できます。

Eclipse（GitHub Copilot 経由）

GitHub Copilot を搭載した Eclipse は MCP をサポートしています。Eclipse → Preferences → GitHub Copilot → MCP Servers → Add Server から追加します：

• 名前：web3auth
• URL：https://mcp.web3auth.io

Neovim（avante.nvim）

Lua 設定に mcphub.nvim 経由で追加します：

require("mcphub").setup({
  servers = {
    web3auth = {
      url = "https://mcp.web3auth.io",
      transport = "streamable-http",
    },
  },
})

または、互換性のために mcp-remote を使用します：

require("avante").setup({
  mcp = {
    servers = {
      web3auth = {
        command = "npx",
        args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },
      },
    },
  },
})

Neovim（codecompanion.nvim）

require("codecompanion").setup({
  extensions = {
    mcp = {
      servers = {
        web3auth = {
          command = "npx",
          args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },
        },
      },
    },
  },
})

Amp（Sourcegraph）

Amp の MCP 設定に追加します：

{
  "mcpServers": {
    "web3auth": {
      "url": "https://mcp.web3auth.io"
    }
  }
}

Goose

~/.config/goose/config.yaml に追加します：

extensions:
  - name: web3auth
    type: http
    url: https://mcp.web3auth.io

5ire

5ire の「設定」→「MCP Servers」→「追加」で設定します：

• 名前：web3auth
• URL：https://mcp.web3auth.io

Aider

Aider は LiteLLM ブリッジ経由で MCP をサポートしています。Aider の設定に追加します：

mcp_servers:
  web3auth:
    command: npx
    args: ["-y", "mcp-remote", "https://mcp.web3auth.io"]

Codex CLI

Codex CLI や stdio のみをサポートするエージェントでは、mcp-remote を使用して HTTP エンドポイントに接続します：

npm install -g mcp-remote

続いて、~/.codex/config.toml に追加します：

[mcp_servers.web3auth]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.web3auth.io"]

または、エージェントの JSON 設定に追加します：

{
  "mcpServers": {
    "web3auth": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]
    }
  }
}

---

静的ドキュメント（llms.txt）

AI ツールがまだ MCP をサポートしていない場合は、代わりに静的ドキュメントファイルを使用します：

https://docs.metamask.io/llms-full.txt

llms.txt 仕様に対応し、ドキュメントを自動的にインデックス化できるツールの場合：

https://docs.metamask.io/llms.txt

警告： 静的ファイルはスナップショットであり、最新の更新が含まれていない場合があります。常に最新のドキュメントを利用するには、可能な限り MCP サーバーを使用してください。

---

開発を始める

スキルと MCP の設定が完了したら、AI アシスタントに直接依頼してください。最初のプロンプトの例：

• 「Google ログインを使って、React アプリに MetaMask Embedded Wallets を追加して。」
• 「Wagmi を使って、Next.js アプリにソーシャルログインウォレットを設定して。」
• 「Flutter アプリに埋め込みウォレットを統合して。」
• 「ログイン方法を変更した後、ユーザーごとにウォレットアドレスが異なるのはなぜ？」

ヒント： 最初のプロンプトには、利用できる場合はプランニングモードを使用してください。コードを生成する前にプランを確認すると、アーキテクチャ上のミスを早期に発見でき、本番環境でウォレットアドレスが変わるような設定ミスを防げます。

---

配布

このリポジトリでは、主要な開発者向けプラットフォームごとに成果物を提供しています：

プラットフォーム	種類	場所
Cursor Marketplace	プラグイン	.cursor-plugin/ + mcp.json
VS Code Marketplace	拡張機能	plugins/vscode/
JetBrains Marketplace	プラグイン	plugins/jetbrains/
Zed Extensions	拡張機能	plugins/zed/
Claude Agent SDK	プラグイン	plugins/claude/
Raycast Store	拡張機能	plugins/raycast/
ChatGPT GPT Store	カスタム GPT	openai/
Official MCP Registry	server.json	server.json
Glama	glama.json	glama.json
Smithery	サーバーカード	app/.well-known/mcp/server-card.json/route.ts
Vercel skills.sh	スキル	Web3Auth/skill
agentskill.sh	スキル	Web3Auth/skill

---

環境変数

変数	必須	説明
GITHUB_TOKEN	はい（ホスト型）／推奨（ローカル）	GitHub の個人用アクセストークンです。Vercel のデプロイ（mcp.web3auth.io）では必須です。get_example と get_sdk_reference は GitHub API を頻繁に呼び出します。トークンがない場合、共有 IP は未認証時の 60 リクエスト／時間の上限にすぐ達します。ローカルの stdio での使用では省略可能です。
DISCOURSE_API_KEY	いいえ	search_community 用の Discourse API キーです（省略可能です。公開検索はキーなしでも利用できます）
DISCOURSE_API_USERNAME	いいえ	DISCOURSE_API_KEY を使用する場合の Discourse API ユーザー名です

---

開発

npm install
npm run build
npm test           # Handler smoke tests (mocked fetch)
npm start          # Run via stdio
npm run dev        # Watch mode

コンテンツの更新

変更内容	更新箇所
SDK のアーキテクチャ、プラットフォーム固有の注意点、キー導出、ワークフロー	Web3Auth/skill（SKILL.md）
新しいサンプルリポジトリまたはスキャン対象のルート（例：新しいプラットフォーム）	src/content/example-catalog.ts
新しい SDK のリポジトリまたは検出ルール（例：新しいプラットフォーム）	src/content/sdk-catalog.ts
新しいツールまたはパラメーターの変更	src/tools/register.ts
既存のリポジトリ内のサンプルフォルダー／SDK ファイルの構成	なし（GitHub からリアルタイムで検出し、4 時間キャッシュします）
ドキュメントページのコンテンツ	なし（Algolia／llms.txt／GitHub 経由でリアルタイムに取得します）

ライセンス

MIT