Persqo
Run Persqo persona tests on a public URL and return findings and a fix prompt.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http persqo 'https://persqo.com/api/mcp' --header 'Authorization: <Persqo API key sent as a Bearer token>'{
"mcpServers": {
"persqo": {
"type": "http",
"url": "https://persqo.com/api/mcp",
"headers": {
"Authorization": "<Persqo API key sent as a Bearer token>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Persqo MCP Server
AI personas test your web app like real users, then hand your coding agent ready-to-paste fix prompts.
Persqo runs AI personas (first-time visitor, impatient mobile user, accessibility-dependent user and more) through your live or preview site in a real browser. Every run gives you step-by-step recordings, screenshots and prioritized findings. This MCP server lets Claude Code, Cursor, Codex and any MCP client start a test, wait for it, read findings and pull a fix prompt straight into the session.
Get an API key
Sign up at https://persqo.com and create an API key (pq_live_...) in the dashboard.
Option A: remote server (no install)
{
"mcpServers": {
"persqo": {
"url": "https://persqo.com/api/mcp",
"headers": { "Authorization": "Bearer pq_live_YOUR_KEY" }
}
}
}Claude Code:
claude mcp add --transport http persqo https://persqo.com/api/mcp --header "Authorization: Bearer pq_live_YOUR_KEY"Option B: local stdio from GitHub
persqo-mcp is not on npm. Install and run the stdio server from this repository. package.json maps the persqo-mcp command to bin.js, which is what npx executes:
npx -y github:YaakovTzedek/persqo-mcp{
"mcpServers": {
"persqo": {
"command": "npx",
"args": ["-y", "github:YaakovTzedek/persqo-mcp"],
"env": { "PERSQO_API_KEY": "pq_live_YOUR_KEY" }
}
}
}Optional PERSQO_API_BASE (default https://persqo.com).
Tools
| Tool | What it does |
|---|---|
run_test | Start persona testers against a public https URL. wait true polls until the test finishes and returns a summary plus the fix prompt. Persqo's browser runs in the cloud and cannot open localhost. Deploy a preview (Vercel or Netlify) or tunnel your machine with ngrok or cloudflared, then pass that https URL. timeout_ms default 120000, max 600000. Requires url. |
get_test_status | Read status, personas, findings, cost, and the report URL. Requires test_id. |
get_findings | Findings with severity, screenshots, and fix_prompt. Requires test_id. |
get_fix_prompt | One combined fix prompt for a finished test. Requires test_id. |
generate_personas | Suggest personas for a URL. Does not spend a session. Requires url. |
list_tests | List recent tests. Optional limit. |
Notes
The Persqo browser cannot open localhost. Use a Vercel/Netlify preview URL or an ngrok / cloudflared tunnel.
License
MIT
Questions fréquentes
Qu'est-ce que Persqo ?
Run Persqo persona tests on a public URL and return findings and a fix prompt.
Comment installer Persqo ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http persqo 'https://persqo.com/api/mcp' --header 'Authorization: <Persqo API key sent as a Bearer token>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Persqo ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
Persqo est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Persqo ?
Il est publié par YaakovTzedek. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.