AnythingMCP Cloud è online — 7 giorni di prova gratuita−30% per 3 mesi con START30
AnythingMCP
Guida al connettore4 minuti di lettura10 tool MCP7 lingue

Come collegare TOPdesk a Microsoft Copilot — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

HCA cura del team HelpCodeAggiornato 4 min di lettura Open source su GitHub
Installa TOPdesk su Cloud — prova gratuitaLeggi la guida passo passo

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

In breve

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

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 + Microsoft Copilot

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

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 Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

  1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
  2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
  3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
  4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
  5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di TOPdesk.
  6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

Questa guida ti è stata utile?

Il tuo agente TOPdesk è a un clic di distanza.

Installa il connettore, incolla la chiave, chiedi a Microsoft Copilot. 7 giorni gratis, senza carta di credito.

Inizia gratis su CloudSelf-host con DockerContatta le vendite

Guide correlate

Connettori

Come collegare TOPdesk a Meta Muse — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

Connettori

Come collegare TOPdesk a ChatGPT — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

Connettori

Come collegare TOPdesk a Claude — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

Connettori

Come collegare TOPdesk a Cursor — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

Connettori

Come collegare TOPdesk a Gemini — via MCP

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.

Connettori

TOPdesk su MCP — Pilota TOPdesk da qualsiasi agente AI

TOPdesk ITSM: incidenti, modifiche, asset, operatori, persone e sedi, con il linguaggio di query FIQL di TOPdesk per un filtraggio preciso. REST API, autenticazione Basic con una password applicativa.