> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Halo MCP to Super Magic

> Connect HaloPSA to Super Magic with Halo MCP: create the Halo API application, add its Client ID in Thread, and see which Halo tools Super Magic can use.

The Halo MCP connector lets Super Magic call HaloPSA's MCP tools from Inbox. Before members can connect, an admin creates an API application in Halo and adds its Client ID to the connector in Thread.

## Before you start

* You need admin access to HaloPSA to create or edit an API application.
* You must be a **Thread Admin** in the workspace.
* Your workspace is on the **AI Pro** plan. For how custom connectors work, see [Add a custom MCP connector to Super Magic](https://docs.getthread.com/super-magic/add-a-custom-mcp-connector-to-super-magic.md).

## Create the API application in Halo

1. In HaloPSA, go to **Configuration → Integrations → Halo API → Applications**.
2. Open an existing application, or click **New**.
3. Fill in the application:
   * **Authentication method:** Authorisation Code (Native Application)
   * **Login redirect URL:** `https://api.chat-genie.com/api/super-agent/mcp/oauth/callback`
   * **Allow Agent Logins:** on
4. On the **Permissions** tab, tick all permissions.
5. Click **Save**.
6. Open the application's **Details** tab and copy the **Client ID**.

If you set **Client Secret** to **Use**, copy the secret as well. Halo shows the secret only once. If you lose it, regenerate it in Halo and update the connector in Thread with the new value.

## Add the Client ID in Thread

1. In Thread, go to **Admin → Super Magic → Connectors**.
2. Open **Halo MCP** and choose **Edit**.
3. Paste the **Client ID**. If your Halo application uses a client secret, paste it in the **Client secret** field.
4. Save.

## Connect as a member

Ask each member to open **Connectors** from the Super Magic panel in Inbox, find **Halo MCP**, and click **Connect**. If a member tried to connect before you saved the Client ID, they need to click **Connect** again.

Each member signs in with their own Halo account, so Super Magic only sees what that account can access in Halo.

## What Super Magic can do with Halo MCP

Super Magic can use whichever tools your Halo MCP endpoint exposes. You control that list in Halo, not in Thread.

### Halo system tools

By default, Halo MCP includes all of Halo's system tools:

| Area | Tools |
| - | - |
| Tickets | Create New Ticket, Get One Ticket, Get Assigned Tickets, Search Tickets, Add Note to Ticket, Assign to Me, Log Time, Use a Quick Action, Apply AI Suggestion |
| Knowledge base | Search Knowledge Base, Get One Article, Get Matching Articles and Tickets for a Ticket |
| Customers and users | Search Customers, Get One Customer, Search Sites, Get One Site, Search Users, Get One User, Get User Info |
| Assets | Search Assets, Get One Asset |
| Service catalogue | Search Service Catalogue |

To expose only some of them, turn off the option to include all system tools in Halo and pick the tools you want.

### Custom tools you build in Halo

Halo also lets you create your own MCP tools, which Super Magic can call alongside the system tools. Options include:

* **Get Report Data**: pull data from a Halo report.
* **Execute a Runbook**: run a Halo runbook, for example to update custom fields or other fields the system tools don't cover.
* **Create New Ticket**: build your own ticket creation workflow.
* **AI Ability**: run an AI Ability you've set up in Halo.
* **Use a Specific Action**: run a specific Halo action.

### Use it in Super Magic

Mention Halo MCP in your request so Super Magic loads its tools:

```text Prompt theme={null}
Use Halo MCP to search the knowledge base for articles about VPN disconnects and summarize the fix.
```

```text Prompt theme={null}
Use Halo MCP to list the assets at Contoso's Denver site.
```

To reuse a request, save it as a Super Magic skill and run it from chat. Halo MCP tools work in Super Magic chat only for now. Support in Agent Builder is coming soon, so agents and Flows can't call them yet.

## Related

* [Add a custom MCP connector to Super Magic](https://docs.getthread.com/super-magic/add-a-custom-mcp-connector-to-super-magic.md)
* [Super Magic admin guide](https://docs.getthread.com/super-magic/super-magic-admin-guide-setup-access-safety.md)


## Related topics

- [Add a custom MCP connector to Super Magic](https://docs.getthread.com/super-magic/add-a-custom-mcp-connector-to-super-magic.md)
- [Add External Tools to Super Magic with Connectors](https://docs.getthread.com/super-magic/add-external-tools-to-super-magic-with-connectors-super-mcp.md)
- [Connect Knowledge Sources to Super Magic](https://docs.getthread.com/super-magic/connect-it-glue-hudu-time-zest-knowledge-sources-to-super-magic.md)