Common troubleshooting questions and answers

Find answers to common questions and issues when connecting to and using the Prepr MCP server.

My AI client doesn’t support OAuth. How do I connect?

If your client does not support OAuth for remote MCP connections, you need an MCP token instead. Contact Prepr support and specify your environment. Once you have your token, add the following authorization header when connecting:

Authorization: Bearer YOUR_ACCESS_TOKEN

Check out the MCP server Authorization guide for more details.

I get a connection error with the MCP server URL.

Make sure you’re connecting to the MCP server URL: https://mcp.prepr.io in your client configuration. The old path https://mcp.prepr.io/mcp path is deprecated.

How do I reference a specific content item without its ID?

You can paste the Prepr URL of a content item or asset directly into your agent prompt. The MCP server resolves the URL automatically, so you do not need to copy the item ID separately.

What is the difference between update_item and patch_items?

• update_item replaces the full localized content item payload. Use it when you want to overwrite all fields in a locale.

• patch_items only modifies supported root-level fields on an existing item without touching the rest of the payload. Use it for targeted changes such as updating a workflow stage or reassigning an item.

Check out the Available tools and actions for more details.

Why is the AI returning content in the wrong locale?

The MCP server respects the locale you specify in your prompt.

If the AI is returning items in an unexpected locale, ask it to run list_locales first to confirm the exact locale codes available in your environment, then specify the target locale in your prompt using the correct code.

Why can’t the AI perform write operations?

Write access is tied to your Prepr user role and the MCP server permissions of the environment you’re connected to.

• User role permissions - If you can’t perform write actions like deleting content items when you manage content in Prepr directly, then your user role doesn’t have the related write permissions. Check out the user role management guide for more details.
• MCP server permissions - If you can perform an action in Prepr directly, but not through the MCP server, then the action is likely disabled for MCP server requests in this environment. Check out the MCP server permissions for more details.

Can I use the MCP server to manage a schema?

Yes. The MCP server includes schema management tools to inspect and change models, components, enumerations, and fields. To change the schema, your user role needs the Schema write permission and Schema → Write access must be enabled in the MCP server permissions of the environment.