Onboarding guide
This guide explains who can use Loomi Connect, what each Bloomreach product needs before you connect, and where to go next. It covers 4 products: Search, Marketing, Data hub, and the Conversational agent.
Loomi Connect has 2 MCP servers:
| Server | Products |
|---|---|
| Loomi Connect MCP server | Search, Marketing, Data hub |
| Conversations server | Conversational agent |
Requirements for Search, Marketing, and Data hub
To use the Loomi Connect MCP server for Search, Data hub, or Marketing, meet the prerequisites in Get started with MCP, plus the following:
| Requirement | Details |
|---|---|
| Unified login | Your organization must use unified login for both Search and Marketing. |
| User roles | You need access to the Search accounts, Marketing projects, or Data hub workspaces the agent uses. Your role decides what the agent can read and change. |
Checklist for Search, Marketing, and Data hub
Search tools run on the same MCP server as Marketing and Data hub, so one connection covers all 3.
Search
Before you let an agent change Search configurations, check the following:
- Write tools, such as ranking rules, redirects, and synonyms, need a role that can make the same change in the dashboard.
- Changes apply to your live Search configuration. Test write actions on a development site or account first.
For what agents can do, see the Search tools pages, starting with Accounts and sites tools.
Marketing
Before you let an agent create Marketing content, check the following:
- Write tools, such as creating campaigns, scenarios, and customer filters, need a role that can make the same change in the dashboard.
- To limit the agent to certain projects, connect with a user who has access only to those projects.
For what agents can do, see the Marketing tools pages, starting with Workspace and project basics tools.
Personal data
To keep personally identifiable information (PII) out of your AI application, connect with a role without PII access. If the user role can view PII in Marketing, the agent receives real customer PII values, such as email addresses and phone numbers, and passes them to your AI application.
For data handling, retention, and your responsibilities, see How Loomi Connect uses AI.
Data hub
Before you let an agent change Data hub configurations, check the following:
- Write tools, such as creating and updating item collections and their configurations, need a role that can make the same change in Data hub.
- Item collections feed the catalogs that Marketing and Search use, so changes can affect both products. Test write actions on a non-production item collection first.
For what agents can do, see the Data hub tools pages, starting with Item collections tools.
Requirements for Conversational agent
The Conversational agent uses a separate MCP server, the Conversations server. It lets your own agent use Bloomreach product discovery, ranking, and conversational intelligence, alongside the standard Bloomreach-hosted Conversational agent.
The Conversations server supports on-site shopping use cases. To manage Conversational agent analytics and configuration, use the Conversational agent dashboard.
Ensure that you have a Conversational agent subscription and use unified login.
-
To evaluate the tools using sample catalog, connect to the shared prototype endpoint. See Connect the Conversations server.
-
To use your own catalog, Bloomreach sets up a customized Conversations server for you. Contact your Bloomreach representative or [email protected].
Connect AI application
Connect with your application, like Microsoft Copilot, Copilot Studio, ChatGPT, Google Gemini, or your own agent. You set up your AI application because the setup depends on the tool you choose and your IT policies.
When you meet the requirements, follow Get started with MCP to add the server, sign in, and verify the connection. Then try the prompts in Test MCP capabilities. For ready-made agent skills, explore the Loomi Connect community repository.
Frequently asked questions
Is there an additional charge for Loomi Connect?
Loomi Connect has no additional charge until the Credit Start Date in the first half of 2027. After that date, Jobs run through Loomi Connect draw from your monthly credit allowance.
Who can't use Loomi Connect?
Organizations that aren't using unified login, including those on a private instance. Complete the unified login upgrade first, then connect. Contact your Bloomreach representative to start the upgrade.
Does each user need a Bloomreach login?
Yes. Each user signs in with their own Bloomreach login.
Can I ask questions that combine Search and Marketing data?
Yes. One connection covers Search, Marketing, and Data hub. For an example, see Customer-aware search analysis.
Can I connect other MCP servers alongside Loomi Connect?
Yes, if your AI application supports more than one MCP server. Each server answers questions about its own data, so information from a tool like Jira comes from that tool's MCP server, not from Loomi Connect. Bloomreach doesn't set up or support third-party MCP servers.
How is Conversations server usage billed?
Conversations server is free to use until further notice.
Troubleshoot issues
Why do some tool calls return a 403 Forbidden error?
Loomi Connect uses only the roles assigned to you in the Administration app. If some calls work and others return 403 Forbidden, your role covers only part of the data in that Search account or Marketing project. Ask your administrator to invite you to the account or project with a role that includes that data.
Why does my AI application say the tool list is out of date?
Loomi Connect adds tools over time. To pick up the latest tools, reload your AI application, or remove the Loomi Connect server and add it again.
Why does sign-in fail with an authentication error?
Sign-in errors are often temporary, so wait a few minutes and try again. If sign-in still fails, see login issues.
Updated 11 days ago

