跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 TOPdesk,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
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.
试试这样问
TOPdesk 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → TOPdesk、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
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.
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
TOPDESK_URL, TOPDESK_USERNAME, TOPDESK_APP_PASSWORD
步骤 1 — 获取凭证
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)
步骤 2 — 安装 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
步骤 3 — 在 ChatGPT 中添加连接器
ChatGPT 通过 Connectors 功能 (Plus / Pro / Team / Enterprise 套餐) 支持 MCP 服务器。免费套餐不支持自定义连接器。
- 打开 ChatGPT → Settings → Connectors (或点击 composer 中的 🔧 图标 → Manage connectors)。
- 点击 "Add custom connector"。
- 填入:
- Name:
TOPdesk - MCP server URL:
https://cloud.anythingmcp.com/mcp - Authentication: Bearer token → 粘贴 MCP API key
- Name:
- 点击 Connect。
可用工具
| 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
ChatGPT 免费套餐能用自定义 MCP Connectors 吗? 不能 — 需要 Plus、Pro、Team 或 Enterprise。
下一步
这份指南对你有帮助吗?