User Guides
MCP
Quickstart
For End Users

For End Users

This guide walks you through integrating MCP servers and using servers in item mcp or the popular mcp-compatible client like Cursor.

For item MCP

As Item mcp client is hosted online, so it currently only support to add the SSE type server only, for the stdio type, you can use client like Cursor or Claude that support all types.

Step 1: Generate Link from Marketplace

To generate an MCP server link (for SSE type only):

  1. Log in to item MCP using your account credentials.
  2. On the Marketplace page, browse or search for the desired MCP server.
  3. Click Explore Integration to open the server details page.

marketplace

  1. On the server details page, you will see available features of this server.
  2. Click Generate Link. Here takes Shopify as an example:
    • a. Enter the MCP server name and your shopify Shop Domain.
    • b. Click Go to Verify, this will take you to the Shopify authorize page.
    • c. Once authorized, you will be redirected back to item mcp.
    • d. Click Test Connection, if the "Connection Successful" message appears, click Submit.
  3. Copy the link for later use.

For servers such as item ecosystems or third-party channels, specific authorization procedures are necessary.

Step 2: Add an MCP Server (SSE only)

  1. Navigate to MCP Client > Dashboard > Add Server.

add-server

  1. In the pop-up window, fill in the following details:

    • Server Name: A unique name to identify the server.
    • Server Type: Choose SSE (Server-Sent Events).
    • Server URL: Paste the server link generated in Step 1.
    • Status: Set the initial status (default is ON).
    • Description: Briefly describe the server’s functions, supported services, and usage scenarios.

  2. Click Add Server to complete the setup.

server

Once added, the MCP server will be available for use in AI model powered interactions.

Step 3: Use AI Chat to Access MCP Tools

  1. Navigate to Lumi (Online MCP Client).
  2. In the chatbox, enter your request or command like:
    • List the 10 latest update products in my shopify store.
  3. AI will automatically identify the appropriate MCP server and tool based on your input, and return a structured response.

ai-chat

  1. You can also configure prompt templates in the Settings section to streamline repetitive or complex tasks.

For Cursor

MethodDescription
Edit Global Config JSONCursor opens mcp.json. You must manually paste server configuration under the "mcpServers" section.
Marketplace One-Click Install(If available) Install directly from Cursor's built-in MCP server marketplace (for some public servers only).

Prerequisites

  • Node.js 16+
  • Python 3.8+
  • Docker (optional for containerization)

Example: Add a GitHub MCP Server

  1. Navigate to Marketplace > Github > Instructions. Copy the Codes.
  2. Open Cursor and navigate to Settings > MCP > + Add new global mcp server.
  3. Paste the following codes to the cursor settings:
"github": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
  }
}
  1. Refer the official guide and get your personal token here (opens in a new tab).
  2. Replace “your_token_here” with your actual GitHub personal access token to authorize requests.
  3. Back to MCP settings, the mcp server is enabled and displaying the available tools under it.

Use MCP Servers in Chat

  1. Open AI chat and switch to Agent mode.
  2. Test the github server with a simple use case like:
    • List the latest 3 commits in the repository your-org/your-repo.

Call mcp

  1. The MCP agent will call the GitHub tool, retrieve data, and return the commits in the chat window.
  2. You can also run more advanced prompts like:
    • List the last 5 issues labeled bug in your-org/your-repo and suggest fixes.
  3. If setup correctly, you should see live responses powered by your MCP GitHub server, and the tools it provides will be listed under the MCP UI panel.
OverviewFor Developers