MCP Questionnaire

Claude の会話内に構造化された入力面を提供します。散文の箇条書きで明確化の質問をする代わりに、事前入力済みのフォーム、前提台帳、レビューマトリクスを表示します。エージェントは可能な限り推論し、すべての値に来歴が付いた事前入力済みフォームをレンダリングします。あなたの仕事は提案を監査することであり、作成することではありません。回答はそのままモデルコンテキストに戻ります。

DESIGN.html が正規の仕様です（ブラウザで開いてください。モックアップはクリック可能です）。この README はインストールと実行方法のみを説明します。

インストール (Claude Code)

1回のインストールで、コネクタ と スキルの両方が得られます。スキルはフォームが適切なタイミングを認識します:

/plugin marketplace add JakubMMazurek/MCP-Questionnaire
/plugin install mcp-questionnaire@mcp-questionnaire

またはシェルから:

claude plugin marketplace add JakubMMazurek/MCP-Questionnaire
claude plugin install mcp-questionnaire@mcp-questionnaire

Related MCP server: chimeralang-mcp

インストール (claude.ai / Claude Desktop — フォームがレンダリングされる場所)

設定 → コネクタ → カスタムコネクタを追加 → packages/plugin/.mcp.json から URL を貼り付けます。Claude は GitHub へのサインインに送ります。GitHub ログインがサーバーの許可リストに載っていれば、接続された状態で戻ります。最初のレンダリングでは、一度だけ「常に許可」の権限が求められます。最初に Web/デスクトップで追加してください。モバイルはそこから取得します。

アクセス制御

コネクタ URL は公開されており、何も保持しません。すべての MCP リクエストには OAuth トークンが必要で、トークンを取得する唯一の方法は、packages/worker/wrangler.jsonc の GITHUB_ALLOWED_USERS に記載されている GitHub アカウントでサインインすることです。カンマ区切りで、大文字小文字を区別しません。それ以外の人は 403 を受け取り、トークンはありません。

チームメイトを追加する: その GitHub ログインを GITHUB_ALLOWED_USERS に追加し、Worker を再デプロイします。削除する: エントリを削除して再デプロイします。これにより、新しい認可は即座にブロックされ、保持しているトークンは自動的に期限切れになります（または OAUTH_KV 名前空間から grant:/token: キーを削除して短縮することもできます）。

これは、当初の「認証なし」という決定（DESIGN.html §3）を意図的に覆したものです。URL パスがかつては能力そのものでしたが、それはこのリポジトリが非公開の間だけ機能し、コネクタをプラグインマーケットプレイスからインストールする必要が生じた時点で、その前提は崩れました。フォーム ID は内部的には能力として残ります。

リポジトリマップ

開発

pnpm install
pnpm -r test            # 359 tests
pnpm --filter @mcpq/ui dev    # offline host harness at localhost:5173/dev/
pnpm build              # single-file renderer bundle, verified self-contained

デプロイ (packages/worker): pnpm exec wrangler deploy。GitHub OAuth アプリの認証情報を保持する2つのシークレット —

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET

— GitHub OAuth アプリの Authorization callback URL が https://mcp-questionnaire.<account>.workers.dev/callback である必要があります。シークレットは tr -d '\n' でパイプします。末尾の改行は以前このデプロイで問題を起こしました。許可リスト (GITHUB_ALLOWED_USERS) はシークレットではなく vars エントリなので、wrangler.jsonc に含まれ、レビュー可能な差分で変更されます。.dev.vars にはローカル実行用の明らかなダミーが入っています。