Skip to content

Integration · Customer support

Connect Claude & ChatGPT to TOPdesk

Ask your AI which incidents are open for a caller, to log a new one or to hand an incident to another operator group. It can search and read incidents with their request and action trail, create and update incidents, register time, look up and create persons, and plan and update operational activities.

Connect TOPdesk free

Free plan, no credit card. Takes about a minute.

Try asking

  • “What is the status of incident I 2409 123?”

    The AI reads the incident by number with caller, request, status, operator and dates.

  • “Which open incidents does [email protected] have?”

    It searches incidents with a filter on the caller and lists them with status.

  • “Log an incident for [email protected]: her laptop will not start.”

    It creates the incident with caller, brief description and request, and can set category, call type and priority from your lists.

What your AI can do

Incidents

Search incidents with FIQL filters, read them by ID or number with requests and actions, and create and update incidents.

Persons and operators

Search, create and update persons, and look up operators, operator groups and branches.

Planning and time

Register time on incidents, and create, search and update operational activities.

  • “Assign incident I 2409 123 to the network team and add a note.”

    It looks up the operator group and updates the incident with the new group and an action text in the progress trail.

  • “Register 30 minutes on that incident.”

    It registers the time spent on the incident, with optional notes.

  • “Plan the server patch as an operational activity next Tuesday.”

    It creates an operational activity with a brief description, planned start and end dates and operator group.

25 tools for TOPdesk

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

  • create_incidentChanges dataCreate an incident. In `body` set caller (email or id), briefDescription, request, and optionally category, subcategory, callType, priority, operator/operatorGroup and an initial action.
  • create_operational_activityChanges dataCreate an operational activity with a brief description, planned start/end dates, type, category, operator or operator group.
  • create_personChanges dataCreate a person. In `body` set surName, and optionally firstName, email, phoneNumber, jobTitle, branch (by id) and department.
  • get_current_operatorGet the operator account the connection is logged in as.
  • get_incidentGet one incident by its ID (`contact_id` is the incident UUID), with caller, request, status, operator and dates.
  • get_incident_by_numberGet one incident by its incident number (e.g. "I 2409 123").
  • get_operational_activityGet one operational activity by `task_identifier` (ID or number).
  • get_personGet one person by ID (`contact_id` is the person UUID).
  • list_call_typesList incident call types (e.g. question, complaint, disruption).
  • list_categoriesList incident categories.
  • list_incident_actionsList the actions (progress trail entries) of an incident by `id_id` (incident UUID).
  • list_incident_requestsList the request texts of an incident by `id_id` (incident UUID).
  • list_operator_groupsList operator groups, optionally filtered with a FIQL `query`.
  • list_operatorsList operators, optionally filtered with a FIQL `query`, to find an operator ID for assigning incidents.
  • list_prioritiesList incident priorities.
  • list_processing_statusesList incident processing statuses.
  • list_subcategoriesList incident subcategories and the category each belongs to.
  • log_incident_timeChanges dataRegister time spent on an incident (`id_id` is the incident UUID): `time_spent` in minutes, with optional notes, operator and reason.
  • search_branchesSearch branches (sites), optionally with a FIQL `query`; needed for creating persons and incidents.
  • search_incidentsSearch incidents with a FIQL `query` (e.g. status==firstLine;caller.dynamicName=="Jane*"), with `sort`, `page_start` and `limit`. Use this to find incident IDs.
  • search_operational_activitiesSearch operational activities (planned tasks) with a FIQL `query`, sort and paging.
  • search_personsSearch persons (callers) with a FIQL `query` such as email=="[email protected]", with sort and paging.
  • update_incidentChanges dataUpdate an incident by ID (`contact_id` is the incident UUID). In `body` set fields such as status, operator, priority, category, closed/completed, or add an `action` text to the progress trail.
  • update_operational_activityChanges dataUpdate an operational activity by `task_identifier`: status, dates, operator, resolved/skipped and other fields.
  • update_personChanges dataUpdate a person by ID (`contact_id`). In `body` pass only the fields to change.

Set up in three steps

  1. 1

    Pick the app

    Create a free PipMCP account and choose TOPdesk from the app list.

  2. 2

    Paste your key

    Enter your TOPdesk address without https:// (for example acme.topdesk.net), an operator login name and an application token. In TOPdesk open the Operator menu (top right) > My Settings and choose Add in the Application tokens block, name it, press Create and copy the token. It is shown only once. The operator needs API permissions.

  3. 3

    Add the link to your AI

    You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:

    1. Click your name, then Settings › Connectors › Add custom connector.
    2. Paste your link as the Remote MCP server URL.
    3. Switch it on from the + menu in a chat.

Questions

What can the AI do in TOPdesk?

The AI can search and read incidents, their requests and actions, persons, operators, operator groups, branches and operational activities, plus lists of categories, call types, priorities and statuses. It can create and update incidents, persons and operational activities, and register time on incidents.

Does the AI see my TOPdesk application token?

No. Your TOPdesk credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Creating or changing incidents and persons can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own TOPdesk account.

Whose account does the AI work as?

The AI works as the operator whose login name and application token you enter, and it can do what that operator is allowed to do. The operator needs API permissions in TOPdesk. You can ask the AI to show which operator it is logged in as.

Let your AI work in TOPdesk today.

Start free. Your key stays encrypted, and you decide what the AI may do.

Connect TOPdesk free

PipMCP is not affiliated with TOPdesk. Product names are trademarks of their owners.