{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Development","owner":"MB"},"seo":{"title":"AI - Norce Backend MCP Servers — Cursor Setup","description":"How to connect the Norce Backend MCP Servers to Cursor — including global and project-level config, authentication headers, and verifying the connection.","keywords":"MCP, Cursor, setup, configuration, mcp.json, developer"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"connecting-to-norce-via-cursor"},"children":["Connecting to Norce via Cursor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide covers connecting the Norce Backend MCP Servers to Cursor. The setup is straightforward — Cursor has built-in MCP support and connects to the Norce servers directly over HTTP, with no additional tooling required."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites"},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cursor installed (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://cursor.com"},"children":["cursor.com"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Norce OAuth2 client with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClientId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClientSecret"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AccountId"]}," — see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/norce-backend-mcp-security"},"children":["Security and access"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your Norce application ID for the environment you are working with"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--choose-global-or-project-config"},"children":["Step 1 — Choose global or project config"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cursor supports MCP configuration at two levels:"]},{"$$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":"Location"},"children":["Location"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"File"},"children":["File"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Global"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.cursor/mcp.json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All projects on this machine"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Project"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]}," in project root"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This project only"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["project-level config"]}," when the Norce environment is specific to one codebase — for example, a client integration project. Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["global config"]}," if you regularly connect to the same Norce environment across multiple projects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the file at the location you choose. If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor"]}," directory does not exist, create it."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--add-the-server-configuration"},"children":["Step 2 — Add the server configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The config format is identical whether you are using global or project-level config. Add the servers you need and replace the placeholder values with your credentials, customer slug, and environment — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR-ENVIRONMENT"]}," is the environment part of the hostname, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["playground"]},", the same as in that environment's other Norce API URLs."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"norce-config\": {\n      \"type\": \"http\",\n      \"url\": \"https://YOUR-CUSTOMER-SLUG.api-se.YOUR-ENVIRONMENT.norce.tech/mcp/config/v1\",\n      \"headers\": {\n        \"ClientId\": \"your-client-id-here\",\n        \"ClientSecret\": \"your-client-secret-here\",\n        \"AccountId\": \"your-account-id-here\"\n      }\n    },\n    \"norce-product\": {\n      \"type\": \"http\",\n      \"url\": \"https://YOUR-CUSTOMER-SLUG.api-se.YOUR-ENVIRONMENT.norce.tech/mcp/product/v1\",\n      \"headers\": {\n        \"ClientId\": \"your-client-id-here\",\n        \"ClientSecret\": \"your-client-secret-here\",\n        \"AccountId\": \"your-account-id-here\"\n      }\n    },\n    \"norce-pricing\": {\n      \"type\": \"http\",\n      \"url\": \"https://YOUR-CUSTOMER-SLUG.api-se.YOUR-ENVIRONMENT.norce.tech/mcp/pricing/v1\",\n      \"headers\": {\n        \"ClientId\": \"your-client-id-here\",\n        \"ClientSecret\": \"your-client-secret-here\",\n        \"AccountId\": \"your-account-id-here\"\n      }\n    },\n    \"norce-inventory\": {\n      \"type\": \"http\",\n      \"url\": \"https://YOUR-CUSTOMER-SLUG.api-se.YOUR-ENVIRONMENT.norce.tech/mcp/inventory/v1\",\n      \"headers\": {\n        \"ClientId\": \"your-client-id-here\",\n        \"ClientSecret\": \"your-client-secret-here\",\n        \"AccountId\": \"your-account-id-here\"\n      }\n    },\n    \"norce-supplier\": {\n      \"type\": \"http\",\n      \"url\": \"https://YOUR-CUSTOMER-SLUG.api-se.YOUR-ENVIRONMENT.norce.tech/mcp/supplier/v1\",\n      \"headers\": {\n        \"ClientId\": \"your-client-id-here\",\n        \"ClientSecret\": \"your-client-secret-here\",\n        \"AccountId\": \"your-account-id-here\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The five available server paths are: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["config/v1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product/v1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pricing/v1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inventory/v1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier/v1"]},". Add or remove entries based on what you need."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project config and version control:"]}," If you use project-level config, add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursor/mcp.json"]}," to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gitignore"]}," to avoid committing credentials."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--restart-cursor-and-verify"},"children":["Step 3 — Restart Cursor and verify"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cursor reads the MCP config at startup. If Cursor is already open, close and reopen it to pick up the new configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After restarting, open the Cursor chat panel and check the MCP tools available. Your Norce tools should appear listed under their server names. You can also ask directly:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Which Norce MCP tools do you have access to?\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If tools are missing, verify that the JSON is valid, credentials are correct, and the customer slug and environment in the URLs are right. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/norce-backend-mcp-troubleshooting"},"children":["Troubleshooting and FAQ"]}," for common problems."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4--add-your-instructions"},"children":["Step 4 — Add your instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cursorrules"]}," file (or use Cursor's system prompt settings) to give the AI context about your Norce environment:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"You have access to the Norce Backend MCP Servers for [client name].\n\nApplication IDs:\n- [Storefront name] (stage): [application ID]\n- [Storefront name] (production): [application ID]\n\nUse stage by default. Never write to production without explicit confirmation.\nWhen tasks span multiple domains, coordinate the servers automatically.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may also want to connect the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Norce Assistant MCP"]}," alongside the Backend servers — it knows the full Norce API reference and is useful for understanding unfamiliar fields or constructing OData filters. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/norce-backend-mcp-working-across-servers"},"children":["Working across MCP servers"]}," for how to combine it with the Backend servers and what to add to your instructions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full starting-point instruction block covering all five servers, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/using-the-norce-backend-mcp-servers#suggested-llm-instructions"},"children":["Suggested LLM instructions"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"you-are-ready"},"children":["You are ready"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Try a first prompt:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Give me a full overview of this Norce environment — applications, active price lists, and warehouse codes.\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of developer workflows, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/norce-backend-mcp-developer"},"children":["Norce Backend MCP Servers for Developers and Solution Architects"]},"."]}]},"headings":[{"value":"Connecting to Norce via Cursor","id":"connecting-to-norce-via-cursor","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1 — Choose global or project config","id":"step-1--choose-global-or-project-config","depth":2},{"value":"Step 2 — Add the server configuration","id":"step-2--add-the-server-configuration","depth":2},{"value":"Step 3 — Restart Cursor and verify","id":"step-3--restart-cursor-and-verify","depth":2},{"value":"Step 4 — Add your instructions","id":"step-4--add-your-instructions","depth":2},{"value":"You are ready","id":"you-are-ready","depth":2}],"frontmatter":{"seo":{"title":"AI - Norce Backend MCP Servers — Cursor Setup","description":"How to connect the Norce Backend MCP Servers to Cursor — including global and project-level config, authentication headers, and verifying the connection.","keywords":"MCP, Cursor, setup, configuration, mcp.json, developer"},"metadata":{"redocly_category":"Development","owner":"MB"}},"lastModified":"2026-09-16T06:55:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai/norce-backend-mcp-cursor","userData":{"isAuthenticated":false,"teams":["anonymous"]}}