Agents, API REST & MCP
Une clé pour tout : applications agent, API REST v1 et serveur MCP natif.
Créez une application agent, obtenez une clé, et appelez chaque outil CVAI en HTTP brut ou via le serveur Model Context Protocol — mêmes clés, mêmes plafonds de dépenses et mêmes journaux d'audit partout.
REST + JSON pur, plus un endpoint MCP natif — appelez depuis n'importe quel langage ou client MCP.
Clés cvai_ak_ par application avec limites de dépenses et de débit isolées.
Exécutions sync ou async, avec webhooks pour renvoyer les résultats à votre agent.
Idéal pour : Les équipes qui construisent leurs propres apps et les développeurs qui branchent CVAI dans des agents autonomes ou des assistants de code IA.
Mise en route
Suivez ces étapes pour être opérationnel.
Créez une application agent
Créez une app depuis votre tableau de bord développeur connecté — donnez-lui un nom et une description.
# Create your agent app in the dashboard:
# https://communityvision.ai/dashboard/developerGénérez une clé API
Depuis votre app dans le tableau de bord, générez une clé. La clé brute n'est affichée qu'une seule fois — stockez-la en lieu sûr.
# Generate a key for your app in the dashboard:
# https://communityvision.ai/dashboard/developer
#
# The raw key (cvai_ak_...) is shown only once — copy it now.Appelez un outil en HTTP
Authentifiez chaque requête avec votre clé en en-tête Bearer. Mode sync ou async.
curl -X POST https://communityvision.ai/api/v1/tools/epistemic_quality_audit/runs \
-H "Authorization: Bearer cvai_ak_your_key" \
-H "Content-Type: application/json" \
-d '{
"input": {
"sourceText": "# My PRD\n\nThis product will...",
"analysisDepth": "full"
},
"mode": "sync"
}'
# Poll an async run:
# GET https://communityvision.ai/api/v1/tool-runs/{runId}Ou branchez le serveur MCP
Dans Claude Desktop, Cursor ou tout client MCP, ajoutez le serveur CVAI avec la même clé.
{
"mcpServers": {
"cvai": {
"url": "https://communityvision.ai/api/mcp",
"headers": {
"Authorization": "Bearer cvai_ak_your_key"
}
}
}
}Réglez limites & webhooks
Dans le tableau de bord développeur, ouvrez votre application agent pour fixer les plafonds de dépenses, la limite de débit et l'URL de webhook (ces réglages se gèrent depuis le tableau de bord connecté, pas via la clé API).
# Manage daily/monthly spend caps, rate limit,
# and your webhook URL from your agent app:
# https://communityvision.ai/dashboard/developerAutres surfaces
CVAI vous rejoint partout où vous travaillez. Explorez les autres intégrations.
Auditez specs et plans en une seule commande, depuis votre terminal.
Auditez la spec ouverte dans l'éditeur et voyez les problèmes en soulignés inline.
Bloquez les PR sur un audit de qualité des specs et plans qu'elles touchent.
Mentionnez @CVAI dans un canal pour auditer un document, directement dans Slack.
Auditez n'importe quelle page en un clic, ou laissez les navigateurs IA appeler les outils CVAI dans la page.
Un bundle de tokens, assets et specs pour construire l'app mobile sans dérive de design.
Recevez les résultats par webhook signé, et intégrez vos rapports dans n'importe quelle page.
Agents, API REST & MCP — questions fréquentes
Comment appeler les outils CVAI depuis mon propre agent ou ma propre app ?
Créez une app d'agent dans le tableau de bord développeur, générez une clé cvai_ak_ par app, et envoyez une requête POST à l'API REST v1 (par exemple /api/v1/tools/epistemic_quality_audit/runs) avec la clé en en-tête Bearer. La même clé fonctionne aussi avec le serveur MCP natif sur /api/mcp depuis Claude Desktop, Cursor ou tout client MCP.
Les clés API d'agent CVAI ont-elles des limites de dépenses et de débit ?
Oui. Chaque app d'agent reçoit sa propre clé cvai_ak_ avec des plafonds de dépenses quotidiens et mensuels isolés, une limite de débit et une URL de webhook optionnelle — le tout géré depuis le tableau de bord développeur connecté, avec les mêmes plafonds de dépenses et la même journalisation d'audit appliqués sur REST et MCP.