Custom MCP Services

Last Updated on : 2025-08-25 03:13:39download

This topic describes how to create and configure a custom MCP server and debug it in an agent.

Create custom MCP server

  1. Log in to the Tuya Developer Platform.

  2. Go to MCP Management > Custom MCP Service, and click Add custom MCP.

    Custom MCP Services

  3. In the Sign up MCP Server dialog, enter the service name and description in Chinese and English, upload an image as the icon, and then click Confirm to save.

    Custom MCP Services

Configure custom MCP server

If your custom MCP service is deployed across multiple data centers, ensure consistent service versions and tool configurations in all data centers to prevent compatibility issues that may disrupt agent orchestration or cause functional failures.

  1. After creating the MCP server, you will automatically be redirected to its Service Details page.

  2. In the section of Service Access Configuration Management > Data Center, click Add Data Center on the right, select a data center as needed, and then click OK.

    Custom MCP Services

  3. Click the selected data center, and you can see the Endpoint, Access ID, and Access Secret. Copy and paste the information to your local device. Please note that these parameters will be used when running the MCP SDK later. For more information, see the README in the GitHub source code.

    Custom MCP Services

Access MCP server via SDK

Download the MCP SDK from GitHub and read the relevant documents.

Custom MCP Services

Run and debug MCP Server

To ensure your custom MCP server operates properly, follow these steps to run and debug it within the agent environment:

Run and debug

  1. In the selected data center, check the service status of the MCP server.

    Custom MCP Services

  2. On the Tool tab, view the available tools for your MCP server.

    Custom MCP Services

  3. Click Test Run to test your desired tool.

    Custom MCP Services
  4. In the Test Run window, click Run. When Commissioning passed appear in the lower left corner, the MCP tool has been debugged successfully.

    Custom MCP Services

Add server to agent

  1. Go to the My Agent page, click Develop in the Operation column.

  2. In the section 01 Model Configuration > Skills Configuration, find MCP Service and click + on the right.

    Custom MCP Services

  3. On the Add MCP service page, click Custom MCP Service and add the desired MCP server to your agent.

    Custom MCP Services

So far, you have completed the development and debugging process of a custom MCP server.