Vault MCP

zerocreds-mcp

ZeroCreds 用 MCP サーバーです。LLM に公開せずにユーザーから認証情報を収集できます。

仕組み

Claude                    ZeroCreds Server            User
  │                            │                        │
  ├─zerocreds_create_session──►│                        │
  │◄─{ token, url }────────────┤                        │
  │                            │                        │
  │  "Please fill: <url>"──────────────────────────────►│
  │                            │◄──── form submit ───────┤
  │                            │  (credentials saved)    │
  │                            │                        │
  ├─zerocreds_check_status─────►│                        │
  │◄─{ status: "done" }────────┤                        │
  │                            │                        │
  │  (proceeds — never saw the credentials)

セットアップ

npm install -g zerocreds-mcp

~/.claude/mcp.json（Claude Code）または Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "zerocreds": {
      "command": "zerocreds-mcp",
      "env": {
        "ZEROCREDS_URL": "https://zerocreds.ru",
        "ZEROCREDS_TOKEN": "your-admin-or-integrator-token",
        "ZEROCREDS_DEFAULT_DESTINATION": "local-dev",
        "ZEROCREDS_TG_BOT_TOKEN": "optional — sends link via Telegram",
        "ZEROCREDS_TG_CHAT_ID": "optional"
      }
    }
  }
}

環境変数

変数	必須	説明
ZEROCREDS_URL	いいえ	サーバー URL（デフォルト：https://zerocreds.ru）
ZEROCREDS_TOKEN	はい	管理者またはインテグレーターのトークン
ZEROCREDS_DEFAULT_DESTINATION	いいえ	デフォルトの宛先名（デフォルト：local-dev）
ZEROCREDS_TG_BOT_TOKEN	いいえ	Telegram ボットのトークン — リンクを自動送信します
ZEROCREDS_TG_CHAT_ID	いいえ	Telegram のチャット ID

ツール

zerocreds_create_session

1 回限りのフォームセッションを作成します。{ token, url, expires_at } を返します。

Claude はユーザーに url を表示し、その後 5～10 秒ごとに zerocreds_check_status をポーリングします。

パラメーター：

• title（必須）— フォームの見出し
• fields（必須）— { name, label, type?, placeholder?, required?, level? } の配列
• description — 任意の補足テキスト
• destination — サーバー設定で指定した宛先名。環境変数のデフォルト値を上書きします
• ttl_minutes — リンクの有効期限（デフォルト：30）

フィールドの種類： text、password、email、tel、number、textarea、url

フィールドレベル（任意。プライバシー指標としてユーザーに表示されます）： secret · pii · attribute · credential

zerocreds_check_status

セッションのステータスをポーリングします。{ status: "pending" | "done" | "expired" } を返します。

エージェントのフロー例

User: "Log me into GitHub"

Claude: [zerocreds_create_session]
  title: "Connect GitHub"
  fields: [
    { name: "token", label: "Personal Access Token", type: "password" }
  ]
→ { token: "abc123", url: "https://zerocreds.ru/f/abc123" }

Claude: "Please fill in your token here: https://zerocreds.ru/f/abc123"

[polls zerocreds_check_status every 5s]
→ { status: "done" }

Claude: "GitHub connected! Proceeding..."
[reads token from secret store via configured destination]

セルフホスト

独自のインスタンスの実行方法については、zerocreds-server をご覧ください。

ライセンス

MIT