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. If actions such as creating, updating, or publishing content items are unavailable when you manage content in Prepr directly, then your Prepr user role doesn’t have the related write permissions. For example, if the Delete permission is disabled for your role, the agent cannot delete content items, even if you ask it to.

Check out the user role management guide for more details.

Can I use the MCP server to manage a schema?

Not yet. The current MCP server supports content operations — reading, creating, updating, and publishing content items. Schema management is on the roadmap and will allow AI assistants to inspect and manage content models through the MCP server in a future release.