tendertool-mcp

Offizieller MCP-Server für TenderTool: Referenzen und Vault-Dokumente direkt aus KI-Assistenten wie Claude (Code/Desktop) verwalten.

Voraussetzungen

• Node.js ≥ 18 (inkl. npx)
• Ein TenderTool-API-Key — erstellen Sie ihn in TenderTool unter Profil → KI-Anbindung (der Key beginnt mit ttp_ und wird nur einmalig angezeigt)

Konfiguration

Umgebungsvariable	Zweck
TENDERTOOL_API_TOKEN	Erforderlich. Ihr TenderTool-API-Key (ttp_…)
TENDERTOOL_API_URL	Optional. Basis-URL des Backends — Standard: https://api.tendertool.de. Nur für Dev-/Staging-Umgebungen nötig.

Installation

Claude Code

claude mcp add tendertool \
  --env TENDERTOOL_API_TOKEN=ttp_... \
  -- npx -y github:tendertoolai/tendertool-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tendertool": {
      "command": "npx",
      "args": ["-y", "github:tendertoolai/tendertool-mcp"],
      "env": {
        "TENDERTOOL_API_TOKEN": "ttp_..."
      }
    }
  }
}

npx lädt und baut den Server beim ersten Start automatisch; danach wird der Cache verwendet.

Tools

Tool	Zweck
reference_list	Referenzen auflisten (optional type=project|person|asset|rate)
reference_create	Referenz anlegen
reference_update	Referenz aktualisieren (data ersetzt das komplette Objekt!)
reference_delete	Referenz löschen
vault_document_list	Vault-Dokumente inkl. Ablaufdaten und doc_types auflisten
vault_document_upload	Lokale Datei in den Vault hochladen (absoluter Pfad)
vault_document_update	Metadaten (Typ, Daten, Notizen) ändern
vault_document_delete	Dokument inkl. Datei löschen

Die Mandanten-Trennung erzwingt das TenderTool-Backend serverseitig — der API-Key bestimmt Benutzer und Organisation.

Entwicklung

git clone https://github.com/tendertoolai/tendertool-mcp.git
cd tendertool-mcp
pnpm install
pnpm run build
TENDERTOOL_API_URL=https://tendertool-backend.ddev.site \
TENDERTOOL_API_TOKEN=ttp_... \
TENDERTOOL_INSECURE_TLS=1 \
node dist/index.js

TENDERTOOL_INSECURE_TLS=1 akzeptiert selbstsignierte Zertifikate lokaler Instanzen (z.B. DDEV) — es deaktiviert die TLS-Prüfung prozessweit und darf niemals gegen Produktion gesetzt werden.

Lizenz

MIT — © 2026 Die Lobby GmbH