Руководство по коннектору4 мин чтенияMCP-инструментов: 107 языков

Как подключить TOPdesk к Microsoft Copilot — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

HCАвтор: команда HelpCodeОбновлено 4 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

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.

инструментов

10

Регион

NL

Категория

ITSM

Аутентификация

Basic Auth

Требуемые env-vars

TOPDESK_URLTOPDESK_USERNAMETOPDESK_APP_PASSWORD
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Пропустите установку. Заработает меньше чем за 2 минуты.

Начните бесплатный период на cloud.anythingmcp.com, добавьте TOPdesk одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.

Начать бесплатный период

Кратко

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Попробуй спросить

Примеры промптов для TOPdesk

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

TOPdesk · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → TOPdesk, вставьте учётные данные, создайте MCP API key — готово. Без Docker, без git clone, без локального сервера.

TOPdesk + Microsoft Copilot

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TOPDESK_URL, TOPDESK_USERNAME, TOPDESK_APP_PASSWORD

Шаг 1 — Получите учётные данные

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)

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Microsoft Copilot

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

  1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
  2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
  3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
  4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
  5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты TOPdesk.
  6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

Доступные инструменты

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

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

Следующие шаги

Это руководство помогло?

Ваш агент для TOPdesk в одном клике.

Установите коннектор, вставьте ключ, спросите Microsoft Copilot. 7 дней бесплатно, без банковской карты.

Похожие руководства

Коннекторы

Как подключить TOPdesk к Meta Muse — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Коннекторы

Как подключить TOPdesk к ChatGPT — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Коннекторы

Как подключить TOPdesk к Claude — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Коннекторы

Как подключить TOPdesk к Cursor — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Коннекторы

Как подключить TOPdesk к Gemini — через MCP

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.

Коннекторы

TOPdesk в MCP — управляйте TOPdesk из любого AI-агента

TOPdesk для ITSM: инциденты, изменения, активы, операторы, пользователи и филиалы, с языком запросов FIQL от TOPdesk для точной фильтрации. REST API, Basic-аутентификация с паролем приложения.