Connect an AI Agent

Tabsdata's agentic workflow uses an MCP server so a coding agent builds and runs your workflows for you. Install it into your agent before continuing to QuickStart. Claude Code and Codex are currently supported.

Step 1Install the Tabsdata MCP package

The MCP server needs tabsdata-agent package. Ensure to install this package into a virtual environment containing the tabsdata[all] package from Install Tabsdata.

uv

uv pip install tabsdata-agent

pip

pip install tabsdata-agent

Step 1Install the MCP server

Start the agent from a shell whose virtual environment has Tabsdata installed.

Claude Code

claude mcp add tabsdata -- python -m tabsdatak.ag.mcp -

Codex

Linux / macOS

codex mcp add tabsdata -- "$(python -c 'import sys; print(sys.executable)')" -m tabsdatak.ag.mcp -

Windows PowerShell

codex mcp add tabsdata -- (python -c "import sys; print(sys.executable)") -m tabsdatak.ag.mcp -

Windows cmd.exe

for /f "delims=" %i in ('python -c "import sys; print(sys.executable)"') do codex mcp add tabsdata -- "%i" -m tabsdatak.ag.mcp -

Step 2Using the agent

You need an active session with the Tabsdata server before starting your agent. Log in, then start it from the same terminal:

Claude Code

tdk login --server localhost --user admin --password tabsdata
claude

Codex

tdk login --server localhost --user admin --password tabsdata
codex

The agent authenticates through your session, so it can only do what you're authorized to do.

Next: Run Your First Data Integration