Requiply MCP troubleshooting

Common problems when connecting an assistant to Requiply or working with its tools, and what to do about each. For the setup steps, see Connecting an assistant.

Troubleshooting

Connector won't connect / "Authentication required" (401) The MCP endpoint requires a valid OAuth token. Re-run sign-in from your assistant's connector or plugin settings. Access tokens expire after 30 days, after which you are prompted to sign in again.

"Admin role required" during sign-in Only users with the Admin role in the organization can authorize an MCP connection. Ask an org admin to connect, or have your role upgraded.

Redirected to login and nothing happens You must be signed in to Requiply in the same browser. Complete the Requiply login; the authorization then continues automatically.

The assistant says it cannot change something Ask the assistant to call whoami and read the access matrix. Connections are approved by an Admin, and the Administrators group always has every access permission, so a refusal usually has another cause: the record cannot be changed through the assistant (item groups other than their custom fields, and booking statuses), the feature needs a higher plan, or a Booking creation permission such as Allow booking outside of working hours is switched off for the Administrators group (see Permission groups).

A booking request fails with a working-hours messagebookings_manage requires start and end to fall on working days within the organization's working hours, in the organization's time zone. The preview already flags the problem, for example Booking start falls on a non-working day (Sunday 2026-10-04, timezone Europe/Kyiv). Nearest working day for the pickup: Monday 2026-10-05, 10:00-18:00, so ask for a new preview with another time. A date with no time (e.g. 2026-07-01) is filled in with the opening and closing times. If your permission group has Allow booking outside of working hours (see Permission groups), you can tell the assistant that the time outside the schedule is intended and it will create the request with that time.

"Items already fully booked" / availability errors The booking preview already checks availability and lists shortages as warnings. If the confirmed call still fails, another booking took the units in between; ask for a fresh preview. A booking request does not hold inventory until staff approve it.

A template preview lists unknown macros The template uses a {{macro}} the organization does not provide; it would render as empty text. Ask the assistant to read get_guidance for the template kind and replace the macro with a supported one.

The assistant cannot reply to a conversation Replies are sent in a member's name, so the connection must be signed in as a member, not an organization API key, and the Conversations inbox must be on. The preview also says when the channel's reply window has closed or another member owns the conversation; ask the assistant to take it over only when you mean to.

Tools don't appear after connecting Disconnect and reconnect. Ensure the URL is exactly https://api.requiply.com/api/mcp (HTTPS, no trailing slash).