Velocity

npx add-mcp 'https://velocity.quest/api/mcp'

Serveur MCP

Connectez les agents IA à Velocity via le protocole Model Context Protocol.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux agents IA d'interagir avec des outils externes via une interface unifiée. Velocity inclut un serveur MCP intégré avec 84 outils pour le suivi des problèmes, les PRD et user stories, le contexte projet, les événements d'espace de travail, la gestion des espaces de travail et des utilisateurs, la planification de feuille de route, les domaines personnalisés, la coordination des agents Claude, et plus encore.

Les agents IA comme Claude Code, Claude Desktop, Codex, Cursor et d'autres clients compatibles MCP peuvent se connecter à Velocity et créer des problèmes, rechercher des tâches, mettre à jour les statuts, gérer des projets, planifier des feuilles de route et configurer des domaines — le tout sans quitter leur flux de travail.

Disponibilité et accès

MCP est disponible pour les membres actuels des espaces de travail sur les offres Pro, Business ou Enterprise. Les espaces de travail gratuits ne peuvent pas utiliser MCP. Connectez-vous via OAuth navigateur ou un jeton de connexion d'espace de travail depuis Paramètres → MCP. Les clés API personnelles ne peuvent pas authentifier MCP. Voir configuration et dépannage.

La réponse tools/list du serveur connecté est le catalogue actuel des outils et schémas d'entrée. Un outil listé peut néanmoins nécessiter une portée d'écriture, un rôle de propriétaire/admin, un droit de fonctionnalité, une configuration d'intégration ou un bail de worker géré. L'accès à un outil seul ne démarre pas un worker ni ne garantit un codage, une revue, une fusion ou un déploiement autonomes.

Cas d'utilisation

• Assistants de codage IA — créer des rapports de bugs directement depuis les revues de code
• Tri automatisé — les agents catégorisent et priorisent les problèmes entrants
• Mises à jour de statut — les agents mettent à jour la progression des problèmes à mesure qu'ils terminent le travail
• Recherche et contexte — les agents trouvent des problèmes liés pour éclairer leur travail
• Gestion de projet — les agents lisent les projets, cycles et jalons
• Planification de feuille de route — les agents gèrent les éléments de feuille de route, versions et votes
• Gestion de domaine — les agents ajoutent et vérifient les domaines personnalisés
• Coordination des agents IA — les workers configurés traitent les problèmes, lient les commits et suivent la progression des sprints

Outils disponibles

Ces tableaux présentent une sélection d'outils. La référence des outils couvre également la planification PRD et user stories, les pièces jointes privées, les événements d'espace de travail, le suivi des problèmes/checklists et les profils de livraison. MCP lit actuellement le contexte projet/cycle ; utilisez l'API GraphQL pour créer des projets, cycles ou jalons de projet.

PRDs et user stories

Lire et modifier les PRDs, exigences et stories ; diviser les stories, lier les problèmes et créer des problèmes à partir de propositions de stories revues. Les outils de proposition IA nécessitent mcp:write, le droit de plan IA correspondant et des crédits disponibles. Les propositions nécessitent des actions de revue et de sauvegarde séparées ; l'approbation humaine des PRD reste dans Velocity. Voir De l'idée aux problèmes.

Suivi des problèmes

Outil	Portée	Description
list_issues	lecture	Lister les problèmes avec filtres par projet, statut, priorité, assigné, étiquette
get_issue	lecture	Obtenir les détails complets d'un problème par ID ou identifiant (ex. ENG-123)
create_issue	écriture	Créer un nouveau problème avec titre, description, priorité, statut
update_issue	écriture	Mettre à jour les champs d'un problème existant
search_issues	lecture	Recherche en texte intégral dans les titres et descriptions de problèmes
add_comment	écriture	Ajouter un commentaire à un problème
list_comments	lecture	Lister tous les commentaires sur un problème

Projets et cycles

Outil	Portée	Description
list_projects	lecture	Lister tous les projets avec filtre de statut optionnel
get_project	lecture	Obtenir les détails du projet, y compris jalons et nombre de problèmes
list_cycles	lecture	Lister les cycles de sprint avec filtre de statut optionnel
get_cycle	lecture	Obtenir les détails du cycle avec nombres de problèmes et progression

Métadonnées d'espace de travail

Outil	Portée	Description
list_teams	lecture	Lister toutes les équipes de l'espace de travail
list_labels	lecture	Lister toutes les étiquettes disponibles
list_statuses	lecture	Lister tous les statuts de problèmes dans les équipes
list_members	lecture	Lister les membres de l'espace de travail avec leurs rôles

Feuille de route

Outil	Portée	Description
list_roadmap_items	lecture	Lister les éléments de feuille de route avec filtres de statut, catégorie et version
create_roadmap_item	écriture	Créer un nouvel élément de feuille de route
update_roadmap_item	écriture	Mettre à jour un élément de feuille de route existant
delete_roadmap_item	écriture	Supprimer un élément de feuille de route
vote_roadmap_item	écriture	Basculer le vote sur un élément de feuille de route
list_roadmap_versions	lecture	Lister toutes les versions de feuille de route (versions)
create_roadmap_version	écriture	Créer une nouvelle version de feuille de route
get_roadmap_settings	lecture	Obtenir la visibilité de la feuille de route et les paramètres de vote
update_roadmap_settings	écriture	Mettre à jour les paramètres de feuille de route

Espace de travail et utilisateur

Outil	Portée	Description
list_workspaces	lecture	Lister les espaces de travail de l'utilisateur ; OAuth ne renvoie que l'espace de travail connecté
create_workspace	écriture	Créer un nouvel espace de travail (l'utilisateur devient propriétaire)
delete_workspace	écriture	Supprimer définitivement un espace de travail (propriétaire uniquement)
get_workspace	lecture	Obtenir les détails de l'espace de travail actuel (nom, plan, nombre de membres)
update_workspace	écriture	Mettre à jour le nom de l'espace de travail (la description n'est pas prise en charge)
get_current_user	lecture	Obtenir le profil de l'utilisateur authentifié
update_current_user	écriture	Mettre à jour le nom d'affichage ou l'avatar de l'utilisateur
list_user_api_keys	lecture	Lister les clés API personnelles (préfixe velu_)
create_user_api_key	écriture	Créer une clé API personnelle (renvoie la clé une seule fois)
revoke_user_api_key	écriture	Révoquer une clé API personnelle

Domaines personnalisés

Outil	Portée	Description
list_domains	lecture	Lister les domaines personnalisés avec statut de vérification
add_domain	écriture	Ajouter un domaine personnalisé avec instructions de configuration DNS
verify_domain	écriture	Vérifier le statut de vérification du domaine
remove_domain	écriture	Supprimer un domaine personnalisé

Flux de travail des agents

Outil	Portée	Description
transition_issue	écriture	Déplacer un problème vers un statut par nom (ex. « En cours ») au lieu d'un UUID
get_my_issues	lecture	Obtenir les problèmes assignés à l'utilisateur authentifié, filtrés par groupe de statut
get_active_sprint	lecture	Obtenir le cycle actif avec nombres de problèmes et progression
link_commit	écriture	Enregistrer un SHA de commit contre un problème
link_pr	écriture	Enregistrer une URL de pull request contre un problème
get_issue_context	lecture	Contexte riche du problème : commentaires, activités, étiquettes, événements liés
get_pending_agent_runs	lecture	Obtenir les exécutions API ou Claude Code en attente pour un worker local
update_agent_run	écriture	Mettre à jour le statut, les jetons et le résultat d'une exécution d'agent

Ressources

Le serveur MCP expose également ces ressources en lecture seule pour un contexte rapide :

URI	Description
velocity://workspace	Métadonnées de l'espace de travail (nom, slug, plan, nombres de membres/équipes)
velocity://issues	Problèmes récents (20 derniers, triés par heure de mise à jour)
velocity://projects	Tous les projets avec statut et progression
velocity://roadmap	Aperçu des éléments de feuille de route, versions et paramètres
velocity://domains	Domaines personnalisés avec statut de vérification

Limitations des identifiants

Les connexions OAuth ne peuvent pas lister, créer ou révoquer les clés API personnelles, même lorsque ces outils apparaissent dans le catalogue. Gérez les clés dans les paramètres Velocity ou utilisez un jeton de connexion pour ces outils. Les jetons de connexion ont des capacités de compte plus larges ; gardez-les privés et révoquez les connexions inutilisées.

Portées

Les octrois OAuth MCP utilisent ces portées. Les jetons de connexion depuis Paramètres → MCP incluent les deux :

• mcp:read — Outils et ressources en lecture, soumis aux restrictions d'identifiants et de fonctionnalités
• mcp:write — Outils en écriture, soumis aux contrôles de rôle, fonctionnalités et politiques de worker (demander avec mcp:read)

Prochaines étapes

• Configuration et authentification — se connecter ou créer un jeton de connexion et configurer votre client
• Référence des outils — documentation détaillée des paramètres pour chaque outil