Guía de conector5 minutos de lectura10 herramientas MCP7 idiomas

Cómo conectar TOPdesk a Microsoft Copilot — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

HCPor el equipo de HelpCodeActualizado 5 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

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.

herramientas

10

Región

NL

Categoría

Gestión de servicios TI

Autenticación

Basic Auth

Env vars requeridas

TOPDESK_URLTOPDESK_USERNAMETOPDESK_APP_PASSWORD
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Sáltate la instalación. Funcionando en menos de 2 minutos.

Inicia una prueba gratuita en cloud.anythingmcp.com, añade TOPdesk con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.

Empezar prueba gratis

Resumen

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Prueba a pedir

Prompts de ejemplo para TOPdesk

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

TOPdesk · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → TOPdesk, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

TOPdesk + Microsoft Copilot

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TOPDESK_URL, TOPDESK_USERNAME, TOPDESK_APP_PASSWORD

Paso 1 — Obtener credenciales

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)

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

  1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
  2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
  3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
  4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
  5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de TOPdesk.
  6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

¿Te ha sido útil esta guía?

Tu agente de TOPdesk está a un clic.

Instala el conector, pega la clave y pregunta a Microsoft Copilot. 7 días gratis, sin tarjeta de crédito.

Guías relacionadas

Conectores

Cómo conectar TOPdesk a Meta Muse — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Conectores

Cómo conectar TOPdesk a ChatGPT — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Conectores

Cómo conectar TOPdesk a Claude — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Conectores

Cómo conectar TOPdesk a Cursor — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Conectores

Cómo conectar TOPdesk a Gemini — via MCP

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.

Conectores

TOPdesk a MCP — Pilota TOPdesk desde cualquier agente IA

TOPdesk ITSM: incidentes, cambios, activos, operadores, personas y sucursales, con el lenguaje de consultas FIQL de TOPdesk para un filtrado preciso. REST API, autenticación Basic con una contraseña de aplicación.