{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"MCP Server","api_domain":"MCP"},"seo":{"title":"MCP Server quickstart","description":"Connect Claude, ChatGPT, Copilot Studio, Gemini, Cursor, or VS Code to Sales Layer Catalog and DAM tools over MCP.","siteUrl":"https://docs.api.saleslayer.com/","image":"/assets/sales-layer-horizontal-dark-green.224c048d0bb386d3c2683ba504140512b6233d3c6cbf706ca81e2e3f2f02dbd0.9c1bb791.svg","keywords":["Sales Layer","Sales Layer API","REST API","OpenAPI","PIM API","Product Information Management API","DAM API","Catalog API","product catalog API","product data synchronization","ecommerce integration API","ERP integration","marketplace integration","image management API","digital asset management API","API integration","Model Context Protocol","MCP server","Sales Layer MCP","AI assistant connector","PIM AI assistant"],"lang":"en-US","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Sales Layer REST API Documentation"},{"name":"og:title","content":"Sales Layer REST API Documentation"},{"name":"og:description","content":"Technical REST API docs for Sales Layer PIM, Catalog, DAM, ecommerce, ERP, and marketplace integrations."},{"name":"og:image","content":"/assets/sales-layer-horizontal-dark-green.224c048d0bb386d3c2683ba504140512b6233d3c6cbf706ca81e2e3f2f02dbd0.9c1bb791.svg"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@saleslayer"},{"name":"twitter:title","content":"Sales Layer REST API Documentation"},{"name":"twitter:description","content":"Technical REST API docs for Sales Layer PIM, Catalog, DAM, ecommerce, ERP, and marketplace integrations."},{"name":"twitter:image","content":"/assets/sales-layer-horizontal-dark-green.224c048d0bb386d3c2683ba504140512b6233d3c6cbf706ca81e2e3f2f02dbd0.9c1bb791.svg"}],"llmstxt":{"hide":false,"title":"Sales Layer REST API Documentation","description":"Technical guides and OpenAPI references for Sales Layer DAM and Catalog REST APIs.","sections":[{"title":"Guides","description":"Static API guides for authentication, headers, query parameters, responses, rate limiting, and best practices.","includeFiles":["guides/**/*.md","changelog.md"]},{"title":"API Reference","description":"OpenAPI-based references and API overview pages for Sales Layer REST APIs.","includeFiles":["apis/**/*.md","apis/**/*.yaml"]},{"title":"Postman collections","description":"Importable Postman collection and environment instructions for testing Sales Layer REST APIs.","includeFiles":["postman/**/*.md"]},{"title":"MCP server","description":"Documentation for the Sales Layer MCP Server, its tools, access profiles, and how AI assistants consume the Catalog REST API.","includeFiles":["mcp-server/**/*.md"]}]},"jsonLd":{"@context":"https://schema.org","@type":"WebSite","name":"Sales Layer REST API Documentation","url":"https://docs.api.saleslayer.com/","publisher":{"@type":"Organization","name":"Sales Layer","url":"https://www.saleslayer.com/"}}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-server-quickstart","__idx":0},"children":["MCP Server quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page shows how to connect an MCP client to the Sales Layer MCP Server and confirm that the connection works."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you start, make sure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Sales Layer account with catalog access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Catalog Token. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/authentication"},"children":["Authentication"]}," for how to request one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An MCP client that supports remote MCP servers with OAuth 2.0 and PKCE, or a local MCP setup."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-your-endpoint","__idx":2},"children":["Choose your endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The hosted server runs at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com"]},". The path you enter depends on the client."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Client"},"children":["Client"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Claude Web"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ChatGPT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Microsoft Copilot Studio"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Google Gemini"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cursor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VS Code and GitHub Copilot"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["n8n"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Claude Desktop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Local install. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/local-development"},"children":["Local development"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude Web requires the base URL. Entering ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.saleslayer.com/mcp"]}," in Claude Web is a known cause of connection failure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pinning-the-access-profile-in-the-url","__idx":3},"children":["Pinning the access profile in the URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two additional endpoints fix the access profile in the URL itself, instead of selecting it during authorization:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"https://mcp.saleslayer.com/onlyread/mcp\nhttps://mcp.saleslayer.com/full/mcp\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onlyread"]}," unless the workflow needs to write. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/permissions"},"children":["Access profiles and permissions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-the-client","__idx":4},"children":["Connect the client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exact menu path differs per client, but the sequence is the same."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add a new MCP server or custom connector in your client, using the endpoint from the table above."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start the connection. The client opens the Sales Layer authorization screen in a browser."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the access profile. Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read only"]}," for a first connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste your Catalog Token into the Sales Layer authorization screen and validate it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the detected catalog and access profile, then continue. Leave the browser window open until the redirect finishes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the client and check that the server shows as connected."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not enter the Catalog Token as a bearer token or API key in the client configuration. It is only ever entered in the Sales Layer authorization screen. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/authentication"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"client-setup-guides","__idx":5},"children":["Client setup guides"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Step-by-step instructions with current screenshots for each client are maintained in the Support Center:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000104473"},"children":["MCP Server setup"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105139"},"children":["Claude Web and Claude Desktop"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105143"},"children":["ChatGPT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000104476"},"children":["Microsoft Copilot Studio"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105215"},"children":["Google Gemini"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105144"},"children":["Cursor, VS Code, and GitHub Copilot"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105214"},"children":["Automation platforms"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.saleslayer.com/support/solutions/folders/206000105216"},"children":["Other MCP-compatible clients"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration-examples","__idx":6},"children":["Configuration examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some clients are configured with a file instead of a form."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cursor, connecting directly to the remote server:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"sales-layer\": {\n      \"url\": \"https://mcp.saleslayer.com/mcp\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VS Code and GitHub Copilot, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".vscode/mcp.json"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"servers\": {\n    \"sales-layer\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.saleslayer.com/mcp\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a client cannot start the OAuth flow on its own, a local bridge can run it:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"sales-layer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.saleslayer.com/mcp\"]\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never commit a Catalog Token to any of these files or to a repository."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-connection","__idx":7},"children":["Verify the connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ask the assistant to list what it can do. A working connection discovers the Sales Layer tools;"," ","Read-only omits all writes, while Full access includes the complete 71-tool catalog."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then confirm the token and catalog resolve correctly:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validate my Sales Layer token and tell me which catalog it points to."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This runs the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validate_token"]}," tool. Follow it with a structural question:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["What tables are available in my catalog, and how many records does each one have?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This combines ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_custom_entities"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_entity_counts"]},", and gives you a catalog overview to work from."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no tools appear, or authorization fails, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/troubleshooting"},"children":["Troubleshooting"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":8},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/tools"},"children":["Tool reference"]}," — everything the assistant can call."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/recipes"},"children":["Recipes"]}," — worked conversational examples."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/permissions"},"children":["Access profiles and permissions"]}," — before enabling writes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":9},"children":["Related pages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server"},"children":["MCP Server overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/local-development"},"children":["Local development"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/troubleshooting"},"children":["Troubleshooting"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/catalog"},"children":["Catalog REST API overview"]}]}]}]},"headings":[{"value":"MCP Server quickstart","id":"mcp-server-quickstart","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Choose your endpoint","id":"choose-your-endpoint","depth":2},{"value":"Pinning the access profile in the URL","id":"pinning-the-access-profile-in-the-url","depth":3},{"value":"Connect the client","id":"connect-the-client","depth":2},{"value":"Client setup guides","id":"client-setup-guides","depth":3},{"value":"Configuration examples","id":"configuration-examples","depth":2},{"value":"Verify the connection","id":"verify-the-connection","depth":2},{"value":"Next steps","id":"next-steps","depth":2},{"value":"Related pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"MCP Server quickstart","description":"Connect Claude, ChatGPT, Copilot Studio, Gemini, Cursor, or VS Code to Sales Layer Catalog and DAM tools over MCP."},"keywords":{"includes":["MCP quickstart","MCP endpoint","connect MCP client","Claude connector","ChatGPT connector","Model Context Protocol"]},"metadata":{"redocly_category":"MCP Server","api_domain":"MCP"}},"lastModified":"2026-08-31T15:07:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}