User Guides
MCP
MCP Server Developer Guide

MCP Server Developer Guide


This guide walks third-party developers and service providers through the process of registering, deploying, configuring, and launching an MCP server on the item MCP platform.

Build an MCP Server

Currently, the platform supports building an MCP server by submitting your repository link and uploading the required documentation and tutorial video.

Step 1: Provide Basic Server Info

build-mcp

  1. Log in to item MCP with your account credentials.
  2. Click Build MCP from the header to open the server setup page.
  3. Fill in the required service information:
    • Service Name
    • Service Provider
    • Tags
    • Logo
    • Description
  4. Click Next to continue.

Step 2: Enter MCP Server URL

  1. Select the service type:
    • STDIO (JSON-based configuration)
    • SSE (Server-Sent Events connection)
  2. Enter the service URL.
  3. Click Next.

service-type

Step 3: Upload Markdown File

  1. Upload a Markdown (.md) file that provides a detailed introduction and documentation for your MCP server.
  2. Click Next.

upload-md

Step 4: Upload Video Tutorial

  1. Upload a video tutorial that demonstrates how to deploy and use your MCP server.
  2. Click Submit to complete the registration process.

Troubleshooting with item MCP Playground

The MCP Playground allows you to test your server before official integration. You can:

  • Call service tools in real-time
  • Input parameters
  • Execute test requests
  • View structured results

This module is essential for function verification and issue troubleshooting.

To verify the MCP server:

  1. Click Playground from the header menu.

playground

  1. In the MCP Inspector section:

    • Choose the MCP Server type: STDIO or SSE
    • Enter the service URL and click Connect
    • If successful, the status will turn green and show Connected
  2. Under the Tools section, click List Tools to view all available tools defined in your API.

run-tool

  1. Select and run individual tools by clicking Run Tool
  2. Input the required parameters.
  3. View the execution response in the History section.