Connect an AI assistant (MCP)
Let an AI assistant manage your catalog and store settings through a secure connection.
MCP (Model Context Protocol) is a standard way for AI assistants, such as Claude, to work with other systems. The Storely24 MCP server lets an assistant that supports MCP read your stores and catalog, import products and change store settings. It can only do what the API key you give it is allowed to do.
Set up the connection
- 1Open "Company" from the left-hand menu, then "API keys", and click "Add API key".
- 2Name the key after the assistant, and select the permissions it needs. To let it import a catalog, select the permissions for "Catalog Imports".
- 3Save, copy the key and store it somewhere safe.
- 4In your assistant's settings, add a remote MCP server that uses "Streamable HTTP".
- 5As the address, enter your API address followed by /api/v1/mcp. You find the API address on the "API Docs" page.
- 6Send the key in the Authorization header, written as "Bearer" followed by a space and the key.
Add the server to your assistant
Pick your assistant. In every example, replace YOUR_API_KEY with the key you copied.
Run this command in your terminal:
claude mcp add --transport http store-admin https://api.storely24.com/api/v1/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Or add the server to the .mcp.json file in your project, then run /mcp to check that it is connected:
{
"mcpServers": {
"store-admin": {
"type": "http",
"url": "https://api.storely24.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add this to ~/.codex/config.toml. The key is read from an environment variable, so it is not stored in the file:
[mcp_servers.store-admin]
url = "https://api.storely24.com/api/v1/mcp"
bearer_token_env_var = "STORE_ADMIN_API_KEY"Then set the variable before you start Codex:
export STORE_ADMIN_API_KEY="YOUR_API_KEY"Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for all projects:
{
"mcpServers": {
"store-admin": {
"url": "https://api.storely24.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add this to .vscode/mcp.json in your project. It works with GitHub Copilot in agent mode:
{
"servers": {
"store-admin": {
"type": "http",
"url": "https://api.storely24.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add this to ~/.gemini/settings.json:
{
"mcpServers": {
"store-admin": {
"httpUrl": "https://api.storely24.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add this to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"store-admin": {
"serverUrl": "https://api.storely24.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Assistants that only let you sign in with OAuth, or that cannot send an Authorization header, cannot connect to this server. This includes the connector settings in Claude on the web and ChatGPT. Use one of the assistants above instead.
The assistant can do everything its key allows. Create a separate key with only the permissions it needs, and delete the key when you stop using the assistant.
What the assistant can do
- Read your data
- List your stores, categories, options and products, and search for a product.
- Import a catalog
- Read the import format, check a catalog and import it. See the "Catalog import" article.
- Store settings
- View and change store details, working hours, the theme and store images.
- Email and payment
- View the email and payment setup. The payment setup is read only.
- Migrate a catalog
- A built-in guide that helps move a catalog from another system into your store.
Imports never delete anything, and each import is all or nothing.
Ask the assistant to validate a catalog and show you the result before it imports.
Requests are limited in number. If the assistant is told to slow down, wait a moment and try again.
Continue reading
Still need help?
Can't find what you are looking for? Our support team is happy to help.
Contact support