Skip to content

Setting Up Claude Code with Datamates

Connect Datamates to Claude Code to use your AI assistant with MCP (Model Context Protocol) server capabilities.

Configuration Steps

Tip

You can also install the extension using the Datamates GUI in VSCode or Cursor. If you do, skip to Step 3 on this page to continue the Claude Code setup.

Step 1: Install Extension in IDE

  1. Open Extensions in your IDE (Ctrl+Shift+X or Cmd+Shift+X).
  2. Search for "Datamates".
  3. Find Datamates by Altimate AI.
  4. Click Install.

Step 2: Add Instance Name and API Key

Configure your Altimate credentials in the Datamates extension:

  1. Click Select datamate on the bottom of your IDE screen.
  2. Click on the vertical ellipse on the top right of the Datamate menu.
  3. Select view credentials.
  4. Select your Datamates' plan: Either Community, Pro, or Team Plan or Enterprise Plan.
  5. Enter your Altimate Instance Name (e.g., mycompany).
  6. Enter your Altimate API Key.

Note

To find your API Key and instance name:

  1. Navigate to the Datamates website.
  2. On the sidebar, click settings.
  3. Click API Key.

Step 3: Run Altimate Diagnostics and Copy Server URL

  1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
  2. Run: Datamates: Run Altimate Diagnostics.
  3. Wait for diagnostics to complete successfully.
  4. Copy the server URL from the diagnostics output (it will look like http://localhost:7700/sse).

Note

The port number (7700) may vary depending on your system. Use the exact URL shown in your diagnostics output.

Step 4: Add MCP Server to Claude Code

Add the Datamates MCP server to Claude Code using the command line:

claude mcp add --transport sse datamate http://localhost:7700/sse

Important

Make sure to replace http://localhost:7700/sse with the actual server URL from your diagnostics output if it's different.

Command Breakdown

  • claude mcp add - Adds a new MCP server
  • --transport sse - Specifies Server-Sent Events transport type
  • datamate - The name for this MCP server
  • http://localhost:7700/sse - The server URL from your diagnostics

You can verify the MCP server was added by running:

claude mcp list

Interactive Demo

Configuration Steps

Step 1: Install Nodejs

Install Nodejs if not already installed. You can download it from here.

Step 2: Install MCP CLI

Install the AltimateAI MCP CLI globally using npm: 

npm install -g @altimateai/datamate

Step 3: Setup Configuration

Input your API key and instance name into this JSON and save it as a config file.

{
"connections": [],
"settings": {
    "1": {}
},
"datamate_id": "1",
"altimateUrl": "https://api.myaltimate.com",
"altimateInstanceName": "YOUR_INSTANCE_NAME",
"altimateApiKey": "YOUR_API_KEY"
}

Note

To find your API Key and instance name:

  1. Navigate to the Datamates website.
  2. On the sidebar, click settings.
  3. Click API Key.

Step 4: Start MCP Server

Run the following command in your terminal to start the MCP server:

datamate start --datamate 1 --client claude-code  --config-file <path-to-your-template-file>

Command Breakdown

Argument --config-file is optional and will be needed only if you are setting this datamate for the first time in your machines

Verify Connection

In your Claude Code session, run the following command to verify the connection and datamate mcp server should be listed with connected status.

/mcp

Interactive Demo

Related: Setup Overview