Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge TOPdesk mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Summary
TOPdesk ITSM: incidents, changes, assets, operators, persons and branches, with TOPdesk's FIQL query language for precise filtering. REST API, Basic auth with an application password.
Frag einfach
Beispiel-Prompts für TOPdesk
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → TOPdesk klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein
git clone, kein lokaler Server.
TOPdesk + Gemini
TOPdesk ITSM: incidents, changes, assets, operators, persons and branches, with TOPdesk's FIQL query language for precise filtering. REST API, Basic auth with an application password.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
TOPDESK_URL, TOPDESK_USERNAME, TOPDESK_APP_PASSWORD
Schritt 1 — Zugangsdaten holen
Use an application password, never the operator's own.
- In TOPdesk open Modules → Supporting Files → Operator Management, pick the operator the integration should act as, and on its card create an Application Password. TOPdesk shows it once.
- Give that operator exactly the permission groups the agent needs — TOPdesk enforces them per module, and a missing one produces a 403 rather than an empty list, which is at least honest.
- Set
TOPDESK_URLto your instance root (e.g.https://mycompany.topdesk.net, no trailing slash),TOPDESK_USERNAMEto the operator login name andTOPDESK_APP_PASSWORDto the generated value.
…(continued in the in-app connector instructions)
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Connector in Gemini hinzufügen
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (oder %APPDATA%\gemini\settings.json unter Windows). Hinzufügen:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
}
}
}
- Hole deinen MCP API Key aus AnythingMCP → Profil → MCP API Keys → Neuer Key.
- Speichern und
geminineu starten. /mcpin Gemini CLI ausführen —TOPdesksollte als verfügbar gelistet sein.- Vertex AI Studio:
https://cloud.anythingmcp.com/mcpimtools-Array der Anfrage mit demselben Bearer-Header übergeben.
Verfügbare Tools
| Tool | What it does |
|---|---|
topdesk_get_version | Read the TOPdesk version this instance runs |
topdesk_list_incidents | List incidents with FIQL filtering |
topdesk_get_incident | Read one incident by its TOPdesk number or UUID, with its caller, category, status, operator group, SLA target dates and request text |
topdesk_get_incident_progress | Read the progress trail of one incident: every action and memo in order, with author, timestamp and whether it is invisible to the caller |
topdesk_list_changes | List change activities with their number, requester, status, planned dates and change type |
topdesk_list_persons | List persons (the callers incidents are raised for) with their name, e-mail, branch and department |
topdesk_list_operators | List operators (the staff who work the queue) with their name, e-mail and the operator groups they belong to |
topdesk_list_branches | List branches — the sites or client organisations TOPdesk groups people and assets under — with their name, address and client reference num |
topdesk_search_assets | Search the asset management module for configuration items by name or type, returning their id, name, template and status |
topdesk_create_incident | Open a real incident in the live instance |
FAQ
Unterstützen Gemini 1.5 Pro oder 2.x MCP? Ja — Gemini CLI ≥ 0.4 und die Vertex AI Tools API akzeptieren MCP httpUrl-Connectors mit Bearer-Header.
Nächste Schritte
War dieser Guide hilfreich?
