FogBugz MCP Server

A Model Context Protocol (MCP)-Server für die Interaktion mit FogBugz über LLMs wie Claude. Unterstützt sowohl die XML-API (/api.asp) als auch die JSON-API (/f/api/0/jsonapi) mit automatischer Versionserkennung beim Start. Funktioniert mit On-Premise- und On-Demand-FogBugz-Installationen.

Übersicht

Ermöglicht LLMs die Durchführung von FogBugz-Operationen:

Erstellen, Aktualisieren, Auflösen, Wiedereröffnen und Schließen von Fällen
Zuweisen von Fällen an bestimmte Benutzer
Suchen und Auflisten von Fällen mit vollständigem Ereignis-/Kommentarverlauf
Auflisten von Benutzern, Kategorien, Projekten und Bereichen
Erstellen neuer Projekte
Generische API-Anfragen für fortgeschrittene Anwendungsfälle

API-Automatische Erkennung

Beim Start wählt der Server automatisch den richtigen API-Client für Ihre FogBugz-Instanz aus:

Prüft /api.xml, um die FogBugz-Versionsnummer zu lesen.
Wenn Version ≥ 9, wird versucht, die JSON-API (/f/api/0/jsonapi) zu erreichen – bei Erfolg wird FogBugzJsonClient verwendet.
Fällt auf FogBugzXmlClient (XML-API über /api.asp) zurück, wenn die Version < 9 ist oder der JSON-Endpunkt nicht erreichbar ist.

Es ist keine Konfiguration erforderlich – der korrekte Client wird automatisch ausgewählt.

FogBugz-Version	Verwendete API
≥ 9 (JSON-API verfügbar)	JSON-API (`/f/api/0/jsonapi`)
< 9 oder JSON-API nicht erreichbar	XML-API (`/api.asp`)

Hinweis zur Textformatierung: Bei der Verbindung mit FogBugz 8.x über die XML-API wird in Beschreibungen und Kommentaren nur reiner Text unterstützt. HTML und Markdown werden wörtlich gespeichert und angezeigt.

Abrufen eines FogBugz-API-Tokens

Sie benötigen ein API-Token, um den MCP-Server bei FogBugz zu authentifizieren. Es gibt zwei Möglichkeiten, eines zu erhalten:

1. Über die Web-Benutzeroberfläche

Gehen Sie zu Account & Settings → User Options und klicken Sie auf den Link Create API Token.

Siehe die offizielle Anleitung: Create API Token using the FogBugz UI

2. Über eine API-Anfrage

Senden Sie die folgende Anfrage (ersetzen Sie die Platzhalter durch Ihre Werte):

https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]

Die Antwort enthält Ihr API-Token.

Siehe die offizielle Anleitung: Get an API Token using FogBugz API commands

Installation

Ein-Klick-Installation (Claude Desktop)

Laden Sie das neueste .mcpb-Paket von der Releases-Seite herunter und öffnen Sie es – Claude Desktop installiert und konfiguriert den Server automatisch und fragt Sie nach Ihrer FogBugz-URL und Ihrem API-Schlüssel.

Manuelle Installation

git clone https://github.com/todevelopers/fogbugz-mcp.git
cd fogbugz-mcp
npm install
npm run build

MCP-Client-Konfiguration

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": ["/absolute/path/to/fogbugz-mcp/dist/index.js"],
      "env": {
        "FOGBUGZ_URL": "https://your-fogbugz-server.com",
        "FOGBUGZ_API_KEY": "your-api-token"
      }
    }
  }
}

Alternativ können Sie Anmeldedaten als Befehlszeilenargumente übergeben:

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": [
        "/absolute/path/to/fogbugz-mcp/dist/index.js",
        "https://your-fogbugz-server.com",
        "your-api-token"
      ]
    }
  }
}

Manuelles Ausführen

# With command-line arguments
node dist/index.js https://your-fogbugz-server.com your-api-token

# With environment variables
FOGBUGZ_URL=https://your-fogbugz-server.com FOGBUGZ_API_KEY=your-api-token npm start

# With a .env file
cp .env.example .env   # fill in FOGBUGZ_URL and FOGBUGZ_API_KEY
npm start

Entwicklung

npm run dev    # run via ts-node (no build needed)
npm run build  # compile TypeScript to dist/
npm test       # run all Jest tests

MCP-Tools

Fallverwaltung

Tool	Beschreibung
`create_case`	Erstellen eines neuen Falls
`update_case`	Aktualisieren eines bestehenden Falls (Titel, Kommentar, Projekt, Bereich, Meilenstein, Priorität)
`assign_case`	Zuweisen eines Falls an einen Benutzer
`resolve_case`	Auflösen (als behoben/abgeschlossen markieren) eines Falls
`reopen_case`	Wiedereröffnen eines aufgelösten oder geschlossenen Falls
`close_case`	Schließen eines Falls

Suchen & Anzeigen

Tool	Beschreibung
`search_cases`	Suchen mit der FogBugz-Abfragesyntax (z. B. `project:Website status:Active`)
`list_my_cases`	Auflisten der einem Benutzer zugewiesenen Fälle (standardmäßig der aktuelle Benutzer)
`get_case`	Abrufen detaillierter Fallinformationen einschließlich vollständigem Ereignis-/Kommentarverlauf
`get_case_link`	Abrufen einer direkten URL zu einem Fall

Referenzdaten

Tool	Beschreibung
`list_people`	Auflisten aller Benutzer mit IDs, Namen und E-Mails
`list_categories`	Auflisten von Fallkategorien (Bug, Feature Request, etc.)
`list_projects`	Auflisten aller aktiven Projekte mit IDs und Namen
`list_milestones`	Auflisten von Meilensteinen/Fix-fors, optional nach Projekt
`list_statuses`	Auflisten von Fallstatus mit Auflösungs-Flags, optional nach Kategorie
`view_project`	Abrufen detaillierter Projektinformationen
`view_area`	Abrufen detaillierter Bereichsinformationen
`create_project`	Erstellen eines neuen Projekts

Fortgeschritten

Tool

Beschreibung

api_request

Generischer XML-API-Ausweg für Befehle, die nicht durch dedizierte Tools abgedeckt sind.

⚠️ WARNUNG: kann jeden API-Befehl ausführen, den der konfigurierte Schlüssel zulässt, einschließlich destruktiver Operationen (Löschen, Bearbeiten von Benutzern, Massenänderungen).

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`FOGBUGZ_URL`	Ja	Basis-URL Ihrer FogBugz-Instanz (z. B. `https://company.fogbugz.com`)
`FOGBUGZ_API_KEY`	Ja	FogBugz-API-Token

Kompatibilität

Getestet mit FogBugz 8.8.53 (XML-API). Die Unterstützung der JSON-API ist gemäß Spezifikation implementiert. Der Server erkennt beim Start automatisch, welche API verwendet werden soll.

Danksagungen

Dieses Projekt basiert auf der ursprünglichen Arbeit von Sarasvati Akari Lara-Almeida – vielen Dank für die Grundlage.

FogBugz