MCP Questionnaire

Strukturierte Eingabeoberflächen innerhalb der Claude-Konversation — vorbefüllte Formulare, Annahmenverzeichnisse, Bewertungsmatrizen — statt klärender Fragen als Prosa-Aufzählungen. Der Agent schließt, was er kann, rendert ein Formular, das bereits mit Herkunftsnachweis für jeden Wert vorbefüllt ist, und Ihre Aufgabe ist es, einen Vorschlag zu prüfen, nicht einen zu verfassen. Antworten fließen direkt zurück in den Modellkontext.

DESIGN.html ist die maßgebliche Spezifikation (öffnen Sie es in einem Browser — die Mockups sind klickbar). Diese README erklärt nur, wie Sie installieren und ausführen.

Install (Claude Code)

Eine Installation gibt Ihnen den Connector und die Fähigkeit, die weiß, wann ein Formular der richtige Schritt ist:

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

oder aus einer Shell:

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

Related MCP server: Pane

Install (claude.ai / Claude Desktop — wo die Formulare gerendert werden)

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → fügen Sie die URL aus packages/plugin/.mcp.json ein. Claude sendet Sie zu GitHub, um sich anzumelden; wenn Ihr GitHub-Login auf der Zulassungsliste des Servers steht, kehren Sie verbunden zurück. Beim ersten Rendern wird eine einmalige Berechtigung „Immer erlauben“ angefragt. Fügen Sie zuerst im Web/Desktop hinzu — mobil wird es von dort übernommen.

Zugriffskontrolle

Die Connector-URL ist öffentlich und trägt nichts. Jede MCP-Anfrage benötigt ein OAuth-Token, und der einzige Weg, eines zu erhalten, ist die Anmeldung mit einem GitHub-Konto, dessen Login in GITHUB_ALLOWED_USERS in packages/worker/wrangler.jsonc erscheint — kommagetrennt, case-insensitiv abgeglichen. Alle anderen erhalten eine 403 und kein Token.

Teammitglied hinzufügen: Fügen Sie deren GitHub-Login zu GITHUB_ALLOWED_USERS hinzu und stellen Sie den Worker erneut bereit. Eines entfernen: Löschen Sie den Eintrag und stellen Sie erneut bereit; das blockiert sofort neue Autorisierungen, und jedes Token, das sie noch besitzen, läuft von selbst ab (oder löschen Sie ihre grant:/token:-Schlüssel aus dem OAUTH_KV-Namespace, um es abzukürzen).

Dies ist eine bewusste Umkehrung der ursprünglichen „Keine Authentifizierung“-Entscheidung (DESIGN.html §3): Der URL-Pfad war früher die Fähigkeit, was nur funktionierte, solange dieses Repository privat blieb, und das hörte auf, sobald der Connector über einen Plugin-Marktplatz installiert werden musste. Formular-IDs bleiben intern Fähigkeiten.

Repository-Übersicht

Entwickeln

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

Bereitstellung (packages/worker): pnpm exec wrangler deploy. Zwei Geheimnisse tragen die Anmeldeinformationen der GitHub-OAuth-App —

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET

— von einer GitHub-OAuth-App, deren Authorization callback URL https://mcp-questionnaire.<account>.workers.dev/callback ist. Leiten Sie Geheimnisse mit tr -d '\n' weiter: Ein nachgestellter Zeilenumbruch hat diese Bereitstellung schon einmal gebissen. Die Zulassungsliste (GITHUB_ALLOWED_USERS) ist ein vars-Eintrag, kein Geheimnis, also wird sie in wrangler.jsonc ausgeliefert und Änderungen sind in einem überprüfbaren Diff sichtbar. .dev.vars enthält offensichtliche Fälschungen für lokale Läufe.