摘要
Znuny（维护中的 OTRS 分支，且与 OTOBO 使用相同 API）：通过您自己实例上的 GenericInterface REST web service 搜索和读取工单及其文章、打开工单并添加文章。
引导式设置
2 分钟将 Znuny 连接到 Gemini
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Znuny，再把你的 MCP URL 添加到 Gemini。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Znuny 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Znuny、粘贴凭证、生成 MCP API key — 完成。无 Docker、无
git clone、无本地服务器。
Znuny + Gemini
Znuny（维护中的 OTRS 分支，且与 OTOBO 使用相同 API）：通过您自己实例上的 GenericInterface REST web service 搜索和读取工单及其文章、打开工单并添加文章。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ZNUNY_URL, ZNUNY_WEBSERVICE, ZNUNY_USERNAME, ZNUNY_PASSWORD
步骤 1 — 获取凭证
A Znuny web service has to be created before any of this works. Znuny does not expose a REST API by default; you build one in the admin UI.
- Go to Admin → Web Services → Add web service and import Znuny's sample
GenericTicketConnectorREST.yml(in the Znuny source it isdevelopment/webservices/GenericTicketConnectorREST.yml). That file defines exactly the four operations this adapter calls, and the routes below are its routes:GET /Ticketis TicketSearch,POST /Ticketis TicketCreate,GET /Ticket/:TicketIDis TicketGet andPATCH /Ticket/:TicketIDis TicketUpdate. If you wrote your own web service with different routes, change them here to match.
…(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 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json (Windows: %APPDATA%\gemini\settings.json) 读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 从 AnythingMCP 获取你的 MCP API key。
- 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp—Znuny应显示为可用。 - Vertex AI Studio: 将
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID传入请求的tools数组,使用相同的X-API-Key请求头。
可用工具
| Tool | What it does |
|---|---|
znuny_search_tickets | Search tickets by queue, state, customer or title fragment (TicketSearch) |
znuny_get_ticket | Read one ticket by TicketID (TicketGet) with its queue, state, priority, owner, customer and SLA |
znuny_get_ticket_articles | Read one ticket's full conversation: every article in order with its sender, channel, subject, body and customer visibility |
znuny_create_ticket | Open a real ticket with its first article (TicketCreate) |
znuny_add_article | Add an article to an existing ticket (TicketUpdate) |
znuny_update_ticket | Change a ticket's state, queue, priority or owner (TicketUpdate) — the move that closes a ticket or hands it to another team |
FAQ
Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带自定义请求头的 MCP httpUrl 连接器。
下一步
这份指南对你有帮助吗?
