TVCMall Customer MCP

TVCMall Customer MCP is a remote, read-only MCP service for TVCMall users. Once connected, you can query products, shipping costs, orders, tracking information, points, and balance transaction history directly from Claude Code, Cursor, or Codex.

The service uses remote Streamable HTTP MCP. You do not need to download, install, or run anything from this repository. Just configure the service once in your MCP client.

Before you connect

Temporary integration endpoint:

http://115.175.225.101:38090/mcp

You will also need to obtain <TVCMALL_PAT> - the current user's Personal Access Token (PAT) - from a TVCMall administrator through a secure channel. The token format is tmcp_v1_{tokenId}.{secret}. Replace the PAT placeholder in the examples below, including the angle brackets.

The examples below place <TVCMALL_PAT> directly in each client's Header configuration. After you replace the placeholder, the PAT is stored in plain text in your personal client configuration. Use only your own device and profile, restrict access to the configuration file, and never commit the configuration to Git, copy it to a public location, or share it with anyone else.

Related MCP server: xmit-mcp

Connect with Claude

Claude Code

Claude Code supports custom Headers for remote HTTP MCP servers. Run this command in a terminal:

claude mcp add --transport http --scope user tvcmall 'http://115.175.225.101:38090/mcp' \
  --header 'TVCMALL_API_KEY: <TVCMALL_PAT>'

Before running the command, replace <TVCMALL_PAT> with a real test PAT. The command saves both tvcmall and the PAT to your user-level Claude Code configuration. It may also be recorded in your shell history, so do not run it in a shared terminal or while recording your screen. Then:

1. Restart Claude Code.

2. Enter /mcp.

3. Confirm that tvcmall is shown as connected and that the TVCMall tools are available.

To update the URL or PAT, run claude mcp remove tvcmall, then add the server again.

Limitations in Claude and Claude Desktop

The remote custom connector interface in Claude and Claude Desktop currently supports only a URL and OAuth configuration. It cannot add the custom TVCMALL_API_KEY Header required by this service, so you cannot connect through that interface at this time. Use Claude Code, Cursor, or Codex instead, and do not put the PAT in the URL.

Reference: Official Claude Code MCP documentation.

Connect with Cursor

Cursor can add a custom Header for a remote MCP server through the user-level mcp.json file.

1. Open your user-level configuration file:

   • macOS / Linux: ~/.cursor/mcp.json

   • Windows: %USERPROFILE%\.cursor\mcp.json

2. If the file already contains mcpServers, merge only the tvcmall entry below. Do not overwrite your other servers.

3. Add this configuration:

{
  "mcpServers": {
    "tvcmall": {
      "url": "http://115.175.225.101:38090/mcp",
      "headers": {
        "TVCMALL_API_KEY": "<TVCMALL_PAT>"
      }
    }
  }
}

Save the file, quit Cursor completely, and restart it. Then open Customize > MCP and confirm that tvcmall is enabled. In some versions, this page is named Settings > Tools & Integrations.

Replace <TVCMALL_PAT> with a real test PAT. The value is stored in your user-level configuration file. Do not place a configuration containing a real PAT in a project-level .cursor/mcp.json, and never commit it to Git.

Reference: Official Cursor MCP documentation.

Connect with Codex

Codex CLI and the Codex IDE extension share the MCP configuration in config.toml.

1. Open your user-level configuration file:

   • macOS / Linux: ~/.codex/config.toml

   • Windows: %USERPROFILE%\.codex\config.toml

2. Add the configuration below. If [mcp_servers.tvcmall] already exists, update the existing entry instead of adding a duplicate:

[mcp_servers.tvcmall]
url = "http://115.175.225.101:38090/mcp"
http_headers = { "TVCMALL_API_KEY" = "<TVCMALL_PAT>" }

Replace <TVCMALL_PAT> with a real test PAT. The value is stored in your user-level Codex configuration file. Save the file and restart Codex, then run:

codex mcp list

You can also enter /mcp in the Codex TUI to confirm that tvcmall is connected and its tools are available.

Reference: Official Codex MCP documentation.

Verify the connection

Once your client reports that it is connected, try asking:

Check whether the TVCMall MCP is configured, then show my 10 most recent orders.

The client will usually call tvcmall_auth_status first. A response of configured: true only means the PAT is configured for the current MCP session; it does not mean the PAT has been validated by the TVCMall WebApi. Your credentials and permissions are usable only when a subsequent read-only query succeeds.

The client manages the MCP session automatically. If you restart the client, the connection expires while idle, or the service restarts, simply reconnect. You do not need to save the session ID manually.

What you can query

For tracking or shipping costs on an existing order, provide the order number. For a shipping estimate on products not yet ordered, provide the SKU, quantity, and destination country or region.

All v0.1 capabilities are read-only. The service does not support placing orders, making payments, changing addresses, canceling orders, redeeming points, or exporting files.

Security notes

• Use the complete PAT as the TVCMALL_API_KEY value. Do not add a Bearer prefix.

• Do not configure an inbound Authorization Header for this service or configure both credential types.

• Each user must use their own PAT. Do not share PATs or use server-wide shared credentials.

• Do not use your TVCMall website password, website login token, or OAuth token in place of a PAT.

• The current HTTP endpoint is only for temporary integration testing and must use a revocable test PAT. In production, connect only to the HTTPS MCP URL provided by an administrator.

• The PAT is stored in plain text in your personal client configuration. Restrict access to the configuration file and avoid using shared devices.

• Do not put the PAT in a URL, chat message, log, or screenshot.

• If you suspect that a PAT has been exposed, contact a TVCMall administrator immediately to revoke and reissue it.

Troubleshooting