Troubleshooting

This guide covers common problems with the Altimate Workspaces extension. If it doesn't solve yours, contact support.

Quick checks

Run the diagnostics

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run:

Altimate Workspaces: Run Altimate Diagnostics

It reports your environment and extension version, whether the Altimate API is reachable, the MCP server's status and URL, the selected workspace and its integrations, and your extension settings with where each value comes from.

Read the logs

1. Open the Output panel (View → Output).
2. Choose Datamate from the dropdown. The extension's log channel still uses the old name.
3. For more detail, run Developer: Set Log Level… from the Command Palette, choose Datamate, then Debug or Trace.

Check the settings

Open Settings (Ctrl+, / Cmd+,) and search for altimate.

Installing

The extension isn't in the marketplace search

Search for Altimate Workspaces. Before version 0.10.0 it was called Datamates.

If it still doesn't appear:

• Check that your network doesn't block the marketplace.
• Update VS Code to 1.95.0 or later.

• Install it from the command line:

  code --install-extension altimateai.vscode-altimate-mcp-server
  

Installation fails

• Restart VS Code and try again.
• Check that you have free disk space.
• Install it from a file instead: download the .vsix from the extension's Open VSX page, then run code --install-extension <file>.vsix.

The extension is installed but not working

Symptoms: no Altimate Workspaces: commands in the Command Palette, the Altimate Workspaces panel is empty, or @datamate doesn't appear in chat.

1. Restart VS Code, or run Developer: Restart Extension Host.
2. Check that VS Code is 1.95.0 or later.
3. Check that the extension is signed in and a workspace is selected. The status bar shows the workspace, or Select workspace. See Set up VS Code.

4. If it's stuck, reset its onboarding state in your settings and restart:

   {
     "altimate.onboardedMcpServer": false,
     "altimate.disableMcpServer": false
   }
   

The MCP server isn't working

Symptoms: the diagnostics show the server offline, tools don't appear in your agent, or chat requests time out.

1. Run Altimate Workspaces: Run Altimate Diagnostics and check the server status and URL.
2. Check that altimate.disableMcpServer isn't set to true.
3. Check that VS Code can make network connections. On a corporate network, check your proxy settings.
4. Disable and re-enable the extension, or restart VS Code.

Some tools are missing

1. Open the Altimate Workspaces panel (in VS Code's bottom panel) and check which workspace is selected.
2. In the web app, open that workspace's Integrations tab and check that the integration is added and has the capabilities you expect.
3. Some integrations need software on your machine. See Integrations.

Chat (@datamate)

Symptoms: @datamate doesn't appear when you type @ in chat, or it doesn't respond.

1. Check the extension is active: the Altimate Workspaces: commands appear in the Command Palette.
2. Look for errors in the Datamate output channel.
3. Close your chat windows, restart VS Code, and open a new chat.

Slow responses: break big requests into smaller ones, and start a new conversation instead of continuing a very long one.

Can't connect to a database

1. Check the connection's details (host, port, user, password) in the workspace's integration settings.
2. Check the database is reachable from your machine: firewall rules, VPN, and so on.
3. Try the same query in your usual database client, to rule out permissions.

dbt problems

Symptoms: models aren't detected, compilation fails, or the profile isn't found.

1. Check dbt is installed in the Python environment the integration uses: dbt --version.
2. Check the project path points at the folder with dbt_project.yml, and that your profile and target are set.
3. See the dbt integration settings.

Network checks

Check that your machine can reach the Altimate API:

curl -I https://api.myaltimate.com

If you're on an Enterprise plan with its own URL, check that URL instead. To check a database host, use nc -vz <host> <port>.

Start over

If nothing else works, reinstall the extension:

1. Uninstall it:

   code --uninstall-extension altimateai.vscode-altimate-mcp-server
   

2. Install it again from the marketplace, and sign in again.

Getting help

Before you contact us, note your VS Code version, the extension version, your operating system, the exact error messages and the steps that cause the problem. The diagnostics output covers most of this.

• Support Chat
• Book a Meeting

Remove passwords, tokens and other secrets from anything you send.