跳过安装。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 + Gemini
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 — 在 Gemini 中添加连接器
Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
}
}
}
- 从 AnythingMCP 获取你的 MCP API key。
- 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp—TOPdesk应显示为可用。 - Vertex AI Studio: 将
https://cloud.anythingmcp.com/mcp传入请求的tools数组,使用相同的 Bearer 头。
可用工具
| 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
Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带 Bearer 头的 MCP httpUrl 连接器。
下一步
这份指南对你有帮助吗?
