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

# Troubleshooting

> Fixes for the most common Howly MCP connection issues.

Most MCP issues come down to the configuration, the token, or the connected portal. Here's how to handle the ones that come up most.

## The Howly tools don't appear

If your client doesn't show the Howly tools after setup, the configuration wasn't loaded.

<Steps>
  <Step title="Check the config was saved">
    Reopen your client's MCP settings and confirm the Howly configuration is actually there and saved, not just pasted into an unsaved field.
  </Step>

  <Step title="Restart the client">
    Most clients load MCP servers at startup. Fully quit and reopen the client so it picks up the new server.
  </Step>

  <Step title="Recreate the connection">
    If it still doesn't appear, create a fresh connection in Howly under AI Assistant Access and paste the new configuration. The old token may have been revoked.
  </Step>
</Steps>

## Authentication or permission errors

The token is wrong, expired, or revoked. Create a new connection in Howly, copy the fresh configuration, and replace the old one in your client. Remember the raw token is shown only once, so a token you didn't save can't be recovered, only replaced.

## The tools connect but return nothing

The MCP reads from the HubSpot portal connected to your Howly account. If answers come back empty:

* Make sure a HubSpot portal is connected in Howly.
* If you manage several portals, confirm the right one is active. The MCP reads the connected portal, not whichever you had open last.
* Reconnect HubSpot in Howly if the connection was revoked on the HubSpot side.

## Claude says it can't change anything

That's expected. The Howly MCP is read-only by design. It can read your portal health, issues, and workflow details and recommend what to fix, but every change happens in HubSpot, made by you. This isn't an error.

## Still stuck?

Email [support@howly.io](mailto:support@howly.io) with the client you're using (Claude Desktop, Cursor, and so on) and what happens when you try. That's usually enough to pin down the cause.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.