If you run into an issue while connecting to Claude, ChatGPT, or Codex, 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 Claude, ChatGPT, or Codex
Currently, the Payhawk MCP isn't listed in the app directories, so it has to be added manually using the Payhawk MCP server URL. Check that you completed the manual setup steps, that your Claude plan and workspace allow custom connectors, and that Developer Mode is turned on for ChatGPT and Codex.
Payhawk works in the ChatGPT desktop app but not on chatgpt.com
Currently, this is expected. Manually added MCP servers run in the ChatGPT desktop app only, until Payhawk is published to the OpenAI Apps directory.
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 > Apps 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 suppoprt@payhawk.com and include which AI Assistant you used (Claude, ChatGPT, or Codex), the question you asked, and roughly when. This helps trace the issue quickly.