User Guides
MCP
Developer Guide

Developer Guide


Item MCP supports importing API from Apifox, OpenAPI, and Swagger, which then can be automatically converted into MCP servers via Integrations that can be published as MCP Servers.

API Integration

Below is the flowchart:

Server Integration via item DI

The connector is exposed via the MCP protocol, with each API mapped to a tool. This allows AI agents to interact with it like any other MCP server.


┌────────────┐     API Call     ┌───────────────┐
│ MCP Server │ ───────────────► │   Item DI API │
│ (Tool: getOrder)              │ (GET /orders) │
└────────────┘                  └───────────────┘

  ↓                                ↑
Formatted as Tool           Appears as "Connector" in Item DI

Shopify Integration

This guide focus on how to configure and register an external API in Item DI, and convert it into an MCP-compatible server that can be used in Item MCP.

Prerequisites

  • Item DI Login Account
  • Shopify Client Credentials
  • Shopify API

To obtain the Client ID and Client Secret from Shopify:

  1. Log in to the Shopify Partner Portal (opens in a new tab).
  2. Navigate to Apps > All apps > Create app.

build-mcp

  1. Select Create app manually and give it a name.
  2. Copy the Client ID and Client Secret for later use.

build-mcp

Step 1: Configure Basic Info

  1. Log in to item DI (opens in a new tab).
  2. Navigate to Integrations > Add New Integration.

build-mcp

  1. Fill in the metadata for this integration:
FieldDescriptionExample
NameDisplay name for usersShopify
Code*Unique internal identifierShopify_demo_06_09
LogoOptional icon(optional)
Type*TypeSales Channel
Supported Regions*Markets supportedUS, China, Japan
Help DocumentExternal doc linkhttps://shopify.dev/docs/api (opens in a new tab)
Request Limit*API call limit2
Time Unit*Time unit for rate limitPer second
API EndpointsDev / Stage / Prod URLs*https://$ {ShopDomain}.myshopify.com
Common ParametersShared API variablesShopDomain

build-mcp

  1. Add the ShopDomain field in Common Parameters Schema.
  2. Provide a field description in advanced settings to guide users.

build-mcp

  1. Click Save and Next.

Step 2: Configure Authentication Method

  1. Choose OAuth 2.0 Code as the authentication type.

build-mcp

  1. Fill in the Client ID and Client Secret.
  2. Under Build Auth URL, add:
    • grant_options[]
    • scope
  3. Set token expiration values to -1 (indicates no expiration).

build-mcp

  1. In the Code to Token tab, fill in:
    • Token URL
    • Access/Refresh Token Expiration: -1

build-mcp

  1. Click Save and Next.

Step 3: Test the Configuration

  1. Create a test API using the GET method.
  2. Add the following header:
    • X-Shopify-Access-Token = ${accessToken}
  3. Add an assert expression: httpCode == 200

build-mcp

  1. Leave output type as Normal.
  2. Click Save and Next.
  3. Copy the Redirect URL from the Authentication tab.

build-mcp

  1. In the Shopify App Dashboard, register this Redirect URL.

build-mcp

  1. Click Save and Release in the Shopify developer portal.

Step 4: Create the Connector in Workspace

  1. Go to Workspace, select a merchant, and click + Add Connector.

build-mcp

  1. Choose the Shopify connector created earlier.

build-mcp

  1. Enter the shop domain, e.g., iphone.myshopify.com.
  2. Click Go to Verify to complete authentication.

build-mcp

  1. After a successful redirect, the message "Connection successful" will appear.
  2. Click Test Connection and submit.

build-mcp

  1. The connector will now be listed under Connected Systems.

build-mcp

Step 5: View Logs

  1. Go to Integrations > Connector.

build-mcp

  1. Click View Logs to check connection and request history.

build-mcp

Step 6: Add Supported Features

  1. Click Add New Feature.

build-mcp

  1. Example: Add a "Query Location" feature.
FieldDescription
Feature CodeUnique ID for function
Feature NameDisplay name
Feature DescriptionDetailed purpose and parameters
  1. Under JSON Schema Settings, define:
    • params.limit = ${params.limit}

build-mcp

  1. Import an api.json configuration file.
  2. In Output Processing, choose:
    • Output type: Path
    • JSONPath: $.data
  3. Configure request headers, body, and query parameters.

build-mcp

  1. Run a test — location information should be returned.

build-mcp

  1. The feature will now appear under Supported Features.

build-mcp

Final Step: Test Servers

After completing the Shopify integration in Item DI, it is registered as a connector and can also be automatically published as an MCP server.

build-mcp

You can copy the SSE link and add it to any MCP-compatible client.

build-mcp