MCP Questionnaire

Superficies de entrada estructuradas dentro de la conversación de Claude — formularios prellenados, registros de supuestos, matrices de revisión — en lugar de preguntas aclaratorias como viñetas de prosa. El agente infiere lo que puede, renderiza un formulario ya prellenado con procedencia en cada valor, y tu trabajo es auditar una propuesta, no redactar una. Las respuestas fluyen directamente de vuelta al contexto del modelo.

DESIGN.html es la especificación canónica (ábrelo en un navegador — los mockups son clicables). Este README solo te dice cómo instalar y ejecutar.

Instalación (Claude Code)

Una instalación te da el conector y la habilidad que sabe cuándo un formulario es la jugada correcta:

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

o desde una shell:

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

Related MCP server: Pane

Instalación (claude.ai / Claude Desktop — donde se renderizan los formularios)

Configuración → Conectores → Añadir conector personalizado → pega la URL de packages/plugin/.mcp.json. Claude te enviará a GitHub para iniciar sesión; si tu inicio de sesión de GitHub está en la lista de permitidos del servidor, vuelves conectado. El primer renderizado pide un permiso único de "Permitir siempre". Añádelo primero en web/escritorio — el móvil lo recoge desde allí.

Control de acceso

La URL del conector es pública y no lleva nada. Cada solicitud MCP necesita un token OAuth, y la única forma de obtener uno es iniciar sesión con una cuenta de GitHub cuyo inicio de sesión aparezca en GITHUB_ALLOWED_USERS en packages/worker/wrangler.jsonc — separado por comas, coincidencia sin distinción de mayúsculas. Cualquier otra persona recibe un 403 y ningún token.

Añadir un compañero: añade su inicio de sesión de GitHub a GITHUB_ALLOWED_USERS y vuelve a desplegar el Worker. Eliminar uno: borra la entrada y vuelve a desplegar; eso bloquea nuevas autorizaciones de inmediato, y cualquier token que aún tengan expira por sí solo (o borra sus claves grant:/token: del espacio de nombres OAUTH_KV para acortarlo).

Esto es una reversión deliberada de la decisión original de "sin autenticación" (DESIGN.html §3): la ruta URL solía ser la capacidad, que solo funcionaba mientras este repositorio permaneciera privado, y eso dejó de ser cierto una vez que el conector tuvo que instalarse desde un marketplace de plugins. Los ids de formulario siguen siendo capacidades internamente.

Mapa del repositorio

Desarrollo

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

Despliegue (packages/worker): pnpm exec wrangler deploy. Dos secretos llevan las credenciales de la app OAuth de GitHub —

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET

— de una app OAuth de GitHub cuya URL de callback de autorización es https://mcp-questionnaire.<account>.workers.dev/callback. Pasa los secretos con tr -d '\n': una nueva línea final ha mordido este despliegue antes. La lista de permitidos (GITHUB_ALLOWED_USERS) es una entrada de vars, no un secreto, por lo que viaja en wrangler.jsonc y los cambios se ven en un diff revisable. .dev.vars contiene falsos obvios para ejecuciones locales.