Using with Claude Desktop

October 6, 2025 · View on GitHub

📍 Navigation: Documentation Home | Server Guide | Getting started | Architecture | Installation | Configuration | Security | Customization | Client Guide

Claude Desktop Instructions

Modify your claude desktop configuration file - claude_desktop_config.json config file:

Based on the transport mode of your server (Streamable-http, Stdio or SSE) you will pick on of the corresponding configuration approach:

Option 1 - Remote server with streamable-http communication (Default)

If you have a Teradata MCP Server instance running and available via http (1), you can connect to it using the mcp-remote npx package (2).

Example can be found in claude_desktop_http_config

Note: The Claude Desktop example assumes a server running locally on port 8001 - modify as needed.

Note (1): See UV or Docker options in the Getting Started guide to start the MCP server process with http-streamable.

Note (2): You need Node installed on your system. Use HomeBrew on mac (ie. brew install nps)

Option 2 - Embedded server with stdio communication

The simplest option is to start the mcp server with Claude and enable communication over stdio

Example can be found in claude_desktop_stdio_config

Note: you will need to modify the directory path in the args for your system, this needs to be a complete path. You may also need to have a complete path to uv in the command as well.

Note: this requires that uv is available to Claude in your system path or installed globally on your system (eg. uv installed with brew for Mac OS users).

Note: The PROFILE variable is optional, you can change its value to instantiate servers with different profiles (ie. pre-defined collections of tools, prompts and resources). See default profiles in profiles config file

Warning: We are not actively maintaining and testing the SSE functionality.

Example can be found in claude_desktop_SSE_config

Note: you may need to modify the host in the args.