Velocity

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

MCP-Server

Verbinde KI-Agenten über das Model Context Protocol mit Velocity.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Agenten die Interaktion mit externen Tools über eine einheitliche Schnittstelle ermöglicht. Velocity enthält einen integrierten MCP-Server mit 84 Tools für Issue-Tracking, PRDs und User Stories, Projektkontext, Workspace-Events, Workspace- und Benutzerverwaltung, Roadmap-Planung, benutzerdefinierte Domains, Claude-Agenten-Koordination und mehr.

KI-Agenten wie Claude Code, Claude Desktop, Codex, Cursor und andere MCP-kompatible Clients können sich mit Velocity verbinden und Issues erstellen, Aufgaben durchsuchen, Status aktualisieren, Projekte verwalten, Roadmaps planen und Domains konfigurieren – alles, ohne ihren Workflow zu verlassen.

Verfügbarkeit und Zugriff

MCP ist für aktuelle Mitglieder von Workspaces in den Tarifen Pro, Business oder Enterprise verfügbar. Free-Workspaces können MCP nicht nutzen. Stelle die Verbindung über Browser-OAuth oder ein Workspace-Verbindungstoken unter Einstellungen → MCP her. Persönliche API-Schlüssel können MCP nicht authentifizieren. Siehe Einrichtung und Fehlerbehebung.

Die tools/list-Antwort des verbundenen Servers ist der aktuelle Katalog der Tools und Eingabeschemata. Ein aufgeführtes Tool kann dennoch einen Schreib-Scope, eine Owner-/Admin-Rolle, eine Feature-Berechtigung, eine Integrationskonfiguration oder ein verwaltetes Worker-Lease erfordern. Tool-Zugriff allein startet keinen Worker und garantiert kein autonomes Codieren, Reviewen, Mergen oder Deployment.

Anwendungsfälle

• KI-Coding-Assistenten — Fehlerberichte direkt aus Code-Reviews erstellen
• Automatisierte Triage — Agenten kategorisieren und priorisieren eingehende Issues
• Statusaktualisierungen — Agenten aktualisieren den Issue-Fortschritt, während sie ihre Arbeit abschließen
• Suche & Kontext — Agenten finden verwandte Issues, um ihre Arbeit zu informieren
• Projektmanagement — Agenten lesen Projekte, Zyklen und Meilensteine
• Roadmap-Planung — Agenten verwalten Roadmap-Einträge, Versionen und Abstimmungen
• Domain-Verwaltung — Agenten fügen benutzerdefinierte Domains hinzu und verifizieren sie
• KI-Agenten-Koordination — konfigurierte Worker bearbeiten Issues, verknüpfen Commits und verfolgen den Sprint-Fortschritt

Verfügbare Tools

Diese Tabellen zeigen ausgewählte Tools. Die Tool-Referenz behandelt außerdem PRD- und Story-Planung, private Anhänge, Workspace-Events, Issue-/Check-Überwachung und Delivery-Profile. MCP liest derzeit Projekt-/Zykluskontext; verwende die GraphQL-API, um Projekte, Zyklen oder Projektmeilensteine zu erstellen.

PRDs und User Stories

PRDs, Anforderungen und Stories lesen und bearbeiten; Stories aufteilen, Issues verknüpfen und Issues aus überprüften Story-Vorschlägen erstellen. KI-Vorschlags-Tools erfordern mcp:write, die entsprechende KI-Plan-Berechtigung und verfügbare Credits. Vorschläge erfordern separate Review- und Speicheraktionen; die menschliche PRD-Genehmigung bleibt in Velocity. Siehe Von der Idee zu Issues.

Issue-Tracking

Tool	Scope	Beschreibung
list_issues	read	Issues mit Filtern für Projekt, Status, Priorität, Zugewiesenen, Label auflisten
get_issue	read	Vollständige Details eines Issues nach ID oder Identifier abrufen (z. B. ENG-123)
create_issue	write	Ein neues Issue mit Titel, Beschreibung, Priorität, Status erstellen
update_issue	write	Felder eines bestehenden Issues aktualisieren
search_issues	read	Volltextsuche über Issue-Titel und -Beschreibungen
add_comment	write	Einen Kommentar zu einem Issue hinzufügen
list_comments	read	Alle Kommentare zu einem Issue auflisten

Projekte & Zyklen

Tool	Scope	Beschreibung
list_projects	read	Alle Projekte mit optionalem Statusfilter auflisten
get_project	read	Projektdetails einschließlich Meilensteinen und Issue-Anzahl abrufen
list_cycles	read	Sprint-Zyklen mit optionalem Statusfilter auflisten
get_cycle	read	Zyklusdetails mit Issue-Anzahlen und Fortschritt abrufen

Workspace-Metadaten

Tool	Scope	Beschreibung
list_teams	read	Alle Teams im Workspace auflisten
list_labels	read	Alle verfügbaren Labels auflisten
list_statuses	read	Alle Issue-Status über Teams hinweg auflisten
list_members	read	Workspace-Mitglieder mit Rollen auflisten

Roadmap

Tool	Scope	Beschreibung
list_roadmap_items	read	Roadmap-Einträge mit Status-, Kategorie- und Versionsfiltern auflisten
create_roadmap_item	write	Einen neuen Roadmap-Eintrag erstellen
update_roadmap_item	write	Einen bestehenden Roadmap-Eintrag aktualisieren
delete_roadmap_item	write	Einen Roadmap-Eintrag löschen
vote_roadmap_item	write	Abstimmung für einen Roadmap-Eintrag umschalten
list_roadmap_versions	read	Alle Roadmap-Versionen (Releases) auflisten
create_roadmap_version	write	Eine neue Roadmap-Version erstellen
get_roadmap_settings	read	Roadmap-Sichtbarkeits- und Abstimmungseinstellungen abrufen
update_roadmap_settings	write	Roadmap-Einstellungen aktualisieren

Workspace & Benutzer

Tool	Scope	Beschreibung
list_workspaces	read	Benutzer-Workspaces auflisten; OAuth gibt nur den verbundenen Workspace zurück
create_workspace	write	Einen neuen Workspace erstellen (Benutzer wird Owner)
delete_workspace	write	Einen Workspace dauerhaft löschen (nur Owner)
get_workspace	read	Details des aktuellen Workspace abrufen (Name, Tarif, Mitgliederanzahl)
update_workspace	write	Workspace-Namen aktualisieren (Beschreibung wird nicht unterstützt)
get_current_user	read	Profil des authentifizierten Benutzers abrufen
update_current_user	write	Anzeigenamen oder Avatar des Benutzers aktualisieren
list_user_api_keys	read	Persönliche API-Schlüssel auflisten (Präfix velu_)
create_user_api_key	write	Einen persönlichen API-Schlüssel erstellen (gibt den Schlüssel einmalig zurück)
revoke_user_api_key	write	Einen persönlichen API-Schlüssel widerrufen

Benutzerdefinierte Domains

Tool	Scope	Beschreibung
list_domains	read	Benutzerdefinierte Domains mit Verifizierungsstatus auflisten
add_domain	write	Eine benutzerdefinierte Domain mit DNS-Einrichtungsanweisungen hinzufügen
verify_domain	write	Den Domain-Verifizierungsstatus prüfen
remove_domain	write	Eine benutzerdefinierte Domain entfernen

Agenten-Workflow

Tool	Scope	Beschreibung
transition_issue	write	Issue per Statusname (z. B. "In Progress") statt UUID in einen Status verschieben
get_my_issues	read	Dem authentifizierten Benutzer zugewiesene Issues abrufen, gefiltert nach Statusgruppe
get_active_sprint	read	Den aktiven Zyklus mit Issue-Anzahlen und Fortschritt abrufen
link_commit	write	Einen Commit-SHA zu einem Issue erfassen
link_pr	write	Eine Pull-Request-URL zu einem Issue erfassen
get_issue_context	read	Umfangreicher Issue-Kontext: Kommentare, Aktivitäten, Labels, verknüpfte Events
get_pending_agent_runs	read	Ausstehende API- oder Claude-Code-Läufe für einen lokalen Worker abrufen
update_agent_run	write	Status, Tokens und Ergebnis eines Agenten-Laufs aktualisieren

Ressourcen

Der MCP-Server stellt außerdem diese schreibgeschützten Ressourcen für schnellen Kontext bereit:

URI	Beschreibung
velocity://workspace	Workspace-Metadaten (Name, Slug, Tarif, Mitglieder-/Team-Anzahlen)
velocity://issues	Aktuelle Issues (letzte 20, sortiert nach Aktualisierungszeit)
velocity://projects	Alle Projekte mit Status und Fortschritt
velocity://roadmap	Übersicht über Roadmap-Einträge, Versionen und Einstellungen
velocity://domains	Benutzerdefinierte Domains mit Verifizierungsstatus

Einschränkungen bei Anmeldedaten

OAuth-Verbindungen können persönliche API-Schlüssel nicht auflisten, erstellen oder widerrufen, selbst wenn diese Tools im Katalog erscheinen. Verwalte Schlüssel in den Velocity-Einstellungen oder verwende für diese Tools ein Verbindungstoken. Verbindungstoken haben umfassendere Kontofähigkeiten; halte sie privat und widerrufe ungenutzte Verbindungen.

Scopes

MCP-OAuth-Grants verwenden diese Scopes. Verbindungstoken aus Einstellungen → MCP enthalten beide:

• mcp:read — Lese-Tools und -Ressourcen, vorbehaltlich Einschränkungen bei Anmeldedaten und Features
• mcp:write — Schreib-Tools, vorbehaltlich Prüfungen von Rolle, Feature und Worker-Richtlinie (mit mcp:read anfordern)

Nächste Schritte

• Einrichtung & Authentifizierung — anmelden oder ein Verbindungstoken erstellen und deinen Client konfigurieren
• Tool-Referenz — detaillierte Parameterdokumentation für jedes Tool