Coding Tools
Öffne Tickets direkt in Claude Code, Cursor, Devin oder deinem bevorzugten KI-Coding-Assistenten.
Das Coding-Tools-Feature verbindet Spedy-Tickets mit externen KI-Coding-Assistenten. Statt Kontext manuell zu kopieren, übergibst du ihn mit einem Klick.
Voraussetzungen
- Das Org-Feature AI Coding Tools muss in den Einstellungen unter Features aktiviert sein (standardmäßig aktiv, alle Pläne).
- Jeder User wählt seine eigenen Tools unter Konto → Coding Tools.
Tools einrichten
- Gehe zu Konto → Coding Tools.
- Aktiviere die Tools, die du nutzt, über den Schalter neben jedem Eintrag. Kein Tool ist standardmäßig aktiv.
- Für das Custom-Tool: Aktiviere es und trage deine eigene URL-Vorlage ein. Verfügbare Platzhalter:
{{prompt}},{{context}},{{issue.identifier}},{{issue.branchName}}.
Unterstützte Tools
Web-basiert: Claude Code, Codex, Devin, Lovable, Replit, v0, Netlify Agents.
Desktop (Deep-Link): Cursor, Windsurf, Zed, GitHub Copilot, Codex Desktop, Conductor, Factory, Warp.
CLI: OpenCode (kopiert den Shell-Befehl in die Zwischenablage).
Custom: Frei konfigurierbare URL-Vorlage.
Ticket-Header-Menü
Im Header jedes Tickets erscheint ein Split-Button:
- Linke Seite (Hauptaktion): Führt die zuletzt verwendete Aktion aus. Standard: Als Prompt kopieren -- kopiert den Ticket-Kontext in die Zwischenablage.
- Rechte Seite (Dropdown): Öffnet das Menü mit allen aktivierten Tools und einem Link zu den Einstellungen.
Klickst du ein Tool im Dropdown, wird es als neue Hauptaktion gespeichert. Beim nächsten Ticket reicht ein Klick auf die linke Seite.
Prompt-Vorlage anpassen
Unter Konto → Coding Tools findest du die Prompt-Vorlage als bearbeitbares Textfeld. Klicke auf die Variablen-Chips, um sie an der Cursor-Position einzufügen.
Verfügbare Variablen
| Variable | Beschreibung |
|---|---|
{{identifier}} | Ticket-ID, z. B. ACME-42 |
{{title}} | Ticket-Titel |
{{context}} | Voller Ticket-Kontext als Markdown (Beschreibung, Kommentare, Subtickets, Verknüpfungen) |
{{branchName}} | Vorgeschlagener Git-Branch-Name |
Die Standard-Vorlage enthält einen MCP-Hinweis, der das Tool anweist, Spedy per MCP-Server direkt abzufragen und zu aktualisieren (z. B. tickets_get, tickets_update, tickets_add_comment, knowledge_search). Wenn du lieber eine rein statische Übergabe möchtest, lösche diesen Absatz aus der Vorlage.
Vorlage zurücksetzen
Klicke auf Auf Standard zurücksetzen, um zur mitgelieferten Vorlage zurückzukehren.
MCP-Tools für Ticket-Verwaltung
Wenn ein KI-Coding-Assistent per MCP mit Spedy verbunden ist, kann er Tickets programmatisch lesen und schreiben. Der MCP-Server stellt Tools für den gesamten Ticket-Lebenszyklus bereit.
Tickets erstellen und bearbeiten
tickets_create und tickets_update akzeptieren den vollständigen Eigenschaftssatz:
| Eigenschaft | Beschreibung |
|---|---|
title, description | Grundlegende Ticket-Inhalte |
assigneeId | Teammitglied zuweisen (null zum Entfernen) |
statusId | Ticket in eine Board-Spalte verschieben |
typeId | Ticket-Typ setzen |
priority | low, medium, high oder critical |
estimatedHours | Zeitschätzung (0–1000 Stunden) |
dueDate, plannedStartDate | Datum im ISO-8601-Format |
storyPoints | Komplexitätsschätzung (1–1000) |
externalReference | Kundenseitige Kennung |
targetEnvironment | z. B. production oder staging |
impactLevel | low, medium, high oder critical |
labelIds | Array von Label-IDs (ersetzt den Satz; [] löscht alle) |
milestoneId | Meilenstein zuweisen (null zum Entfernen) |
Benutzerdefinierte Felder
Mit tickets_set_custom_fields setzt du organisationsweite benutzerdefinierte Felder auf einem Ticket. Unterstützte Typen: Text, Zahl, Datum, Auswahl und Checkbox. Werte werden gegen die Felddefinition validiert.
Discovery-Tools
Um die nötigen IDs zu ermitteln, nutze diese Abfrage-Tools:
labels_list— alle Organisations-Labels mit ID, Name, Farbe und Ticket-Anzahlmilestones_list— Board-Meilensteine mit ID, Name, Fälligkeitsdatum und Fortschrittcustom_fields_list— benutzerdefinierte Felddefinitionen mit ID, Typ, Pflichtfeld-Status und Auswahloptionen
Tickets lesen
tickets_get gibt den vollständigen Eigenschaftssatz zurück, inklusive Labels, Meilenstein und benutzerdefinierter Felder — so bleiben Lese- und Schreibzugriffe konsistent.
MCP-Tools für Pull Requests und Pipelines
KI-Agenten können auch Pull-Request- und CI/CD-Pipeline-Daten per MCP abfragen — dieselben Daten, die die Pull-Requests- und Pipelines-Ansichten im Browser antreiben.
Pull Requests auflisten
pull_requests_list liefert eine paginierte Übersicht aller Pull- und Merge-Requests über alle verbundenen Provider (GitHub, GitLab, Bitbucket), beschränkt auf die Boards, auf die du Zugriff hast.
| Parameter | Beschreibung |
|---|---|
provider | Filtern nach GITHUB, GITLAB oder BITBUCKET |
state | OPEN, DRAFT, MERGED oder CLOSED |
boardId | Auf ein einzelnes Board beschränken |
repository | Nach Repository-Name filtern (enthält) |
author | Nach Autor filtern (enthält) |
branch | Nach Quell- oder Ziel-Branch filtern (enthält) |
search | Freitextsuche über Titel, Repo, Branch, Autor oder PR-Nummer |
onlyOpen | Kurzform für state=OPEN |
onlyFailed | Nur PRs mit aktuell fehlgeschlagener Pipeline |
limit, page | Paginierung (Standard: 25 pro Seite, max. 100) |
Pull-Request-Details abrufen
pull_requests_get gibt die vollständigen Details eines einzelnen Pull Requests anhand seiner Spedy-Aggregate-ID (aus pull_requests_list) zurück, inklusive:
- CI-Pipeline-Steps mit Status, Typ und Dauer
- Reviews mit Reviewer-Name, Status und Kommentar
- Letzte Events mit Typ und Zeitstempel
Pipeline-Läufe auflisten
pipelines_list zeigt CI/CD-Pipeline-Läufe gruppiert nach Status-Bucket, analog zur Pipelines-Ansicht:
| Parameter | Beschreibung |
|---|---|
status | needs-attention (Standard), running, failed, success oder all |
provider | Filtern nach GITHUB, GITLAB oder BITBUCKET |
boardId | Auf ein einzelnes Board beschränken |
limit, page | Paginierung (Standard: 25 pro Seite, max. 100) |
Die Ergebnisse enthalten Zähler pro Bucket (needsAttention, running, failed, success, total), sodass der Agent den CI-Gesamtzustand auf einen Blick erfassen kann.
Alle drei Tools sind schreibgeschützt (Risikostufe SAFE), erfordern den mcp:read-Scope und sind auf die Boards beschränkt, auf die der verbundene User Zugriff hat.
Tipps
- Aktiviere nur die Tools, die du tatsächlich nutzt -- das Dropdown bleibt übersichtlich.
- Richte die MCP-Integration unter Konto → MCP ein, damit Tools per MCP auf Live-Daten zugreifen können.
- Nutze das Custom-Tool, wenn dein bevorzugtes Tool nicht in der Liste steht.