インストール不要。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 キーを発行 — 完了です。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.
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
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 — アダプターをインストール
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 の Profile → MCP API Keys → New Key で MCP API key を取得。
- ファイルを保存し
geminiを再起動。 - Gemini CLI で
/mcpを実行 —TOPdeskが利用可能として表示されます。 - Vertex AI Studio: 同じ Bearer ヘッダーで
https://cloud.anythingmcp.com/mcpをリクエストのtools配列に渡してください。
利用可能なツール
| 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 ヘッダー付きの httpUrl MCP コネクタを受け入れます。
次のステップ
このガイドは役に立ちましたか?
