Connector guide3-minute read10 MCP toolsEN · DE · IT

Come collegare TOPdesk a ChatGPT — via MCP

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.

HCBy HelpCode teamAggiornato 3 min read Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

TOPdesk

TOPdesk

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.

tool

10

Regione

NL

Categoria

IT Service Management

Autenticazione

Basic Auth

Env vars richieste

TOPDESK_URLTOPDESK_USERNAMETOPDESK_APP_PASSWORD
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

Salta l'installazione. Attivo in meno di 2 minuti.

Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi TOPdesk con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.

Inizia la prova gratuita

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.

Prova a chiedere

Prompt di esempio per TOPdesk

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

TOPdesk · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → TOPdesk, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

TOPdesk + ChatGPT

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TOPDESK_URL, TOPDESK_USERNAME, TOPDESK_APP_PASSWORD

Step 1 — Ottieni le credenziali

Use an application password, never the operator's own.

  1. 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.
  2. 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.
  3. Set TOPDESK_URL to your instance root (e.g. https://mycompany.topdesk.net, no trailing slash), TOPDESK_USERNAME to the operator login name and TOPDESK_APP_PASSWORD to the generated value.

…(continued in the in-app connector instructions)

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in ChatGPT

ChatGPT supporta server MCP tramite la funzione Connectors (piani Plus / Pro / Team / Enterprise). Il piano gratuito non supporta connettori personalizzati.

  1. Apri ChatGPT → Impostazioni → Connectors (o clicca l'icona 🔧 nel composer → Manage connectors).
  2. Clicca "Add custom connector".
  3. Compila:
    • Name: TOPdesk
    • MCP server URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → incolla la tua MCP API key (da AnythingMCP → Profile → MCP API Keys → New Key)
  4. Clicca Connect per autorizzare.

Tool disponibili

ToolWhat it does
topdesk_get_versionRead the TOPdesk version this instance runs
topdesk_list_incidentsList incidents with FIQL filtering
topdesk_get_incidentRead one incident by its TOPdesk number or UUID, with its caller, category, status, operator group, SLA target dates and request text
topdesk_get_incident_progressRead 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_changesList change activities with their number, requester, status, planned dates and change type
topdesk_list_personsList persons (the callers incidents are raised for) with their name, e-mail, branch and department
topdesk_list_operatorsList operators (the staff who work the queue) with their name, e-mail and the operator groups they belong to
topdesk_list_branchesList branches — the sites or client organisations TOPdesk groups people and assets under — with their name, address and client reference num
topdesk_search_assetsSearch the asset management module for configuration items by name or type, returning their id, name, template and status
topdesk_create_incidentOpen a real incident in the live instance

FAQ

Il piano free di ChatGPT funziona con i Connectors MCP custom? No — servono Plus, Pro, Team o Enterprise.

Prossimi passi

Questa guida ti è stata utile?

Your TOPdesk agent is one click away.

Install the connector, paste the key, prompt ChatGPT. Free for 7 days, no credit card.

Guide correlate