New Payhawk offices in Stockholm and Warsaw | Learn more

Troubleshooting the Payhawk MCP

Prev Next

If you run into an issue while connecting your AI Assistant, or run into another issue related to the Payhawk MCP, you can find the suggested solutions in this article.

The connector is not appearing in your AI Assistant

Payhawk is listed in the Claude connector directory and the ChatGPT plugin directory. In the other AI Assistants, you add it with the Payhawk MCP server URL. Check that you completed the setup steps for your AI Assistant in the article about connecting Payhawk to your AI Assistant, and, in Claude on a Team or Enterprise plan, that a Claude Owner enabled the Payhawk connector.

The sign-in fails with a host-not-allowed error

Payhawk accepts sign-ins only from the supported AI Assistants. In any other app, the sign-in fails with an error that mentions host-not-allowed or “The client redirect URI is not allowed.” For the list of supported AI Assistants, see the article about connecting Payhawk to your AI Assistant. To request support for another app, contact Payhawk Support at support@payhawk.com.

Payhawk asks me to sign in again

This is expected. You stay signed in while you use the connection, but you need to sign in again after 7 days without use, and every 30 days at most. Sign in with the same credentials you use for the Payhawk Web Portal.

I connected but I am not seeing results for my company

Make sure you signed in with the same credentials you use for the Payhawk Web Portal. Results are scoped to your login: if your Payhawk role has limited permissions, some data won't be visible.

My colleague gets different results for the same question

This is expected. Results are scoped to each user's Payhawk login and permissions, so two users with different roles may see different data.

ChatGPT blocked an action in the middle of a chat

OpenAI runs its own safety layer over connected apps and can occasionally stop a step, most often in travel, with a message such as "This tool call was blocked by OpenAI's safety checks." The check comes from OpenAI, not from Payhawk. To resolve the issue in most cases, retry the request and state a clear business reason for it.

UI components are not rendering in ChatGPT

Flight, hotel, or approval UI elements can occasionally show as plain text or not appear at all. The text reply of the AI Assistant always contains the same information, so nothing is lost. If the UI components stop appearing after an update, go to Settings > Plugins and re-sync the Payhawk connector to bring them back.

In Claude, the files I attach to the chat are not reaching Payhawk

Claude doesn't pass chat attachments through to connectors. To upload a receipt or an invoice from Claude, use the Payhawk upload UI component the AI Assistant shows you: the UI component uploads the file directly to Payhawk. In ChatGPT, attaching the file to the chat works as expected.

The analysis is taking a long time

Large queries run as background jobs and can take up to 5 minutes. The AI Assistant will notify you when the results are ready.

The assistant asked me to try again in about a minute, or my background analysis did not start

Some larger questions run as background jobs. If several background jobs start at the same time, Payhawk may not begin a new one right away and asks you to try again in about a minute. This limit is shared across all your connected AI clients and conversations for your Payhawk login, so work running in another chat can use up the available capacity for a short time. It clears as the running jobs finish, and can recover on its own even when no job seems to be running, so you can simply resend your request shortly after.

Something else is wrong

Contact Payhawk Support at support@payhawk.com and include which AI Assistant you used (for example, Claude, ChatGPT, or Cursor), the question you asked, and roughly when. This helps trace the issue quickly.