Connect an AI Agent

Before you begin

Install Tabsdata

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 deploying a server. Claude Code and Codex are currently supported.

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

Temporary, for 2.0.0

The MCP server needs tabsdata-agent, which ships as its own package and is not yet pulled in by tabsdata[all]. For 2.0.0 it also has to be installed from the Tabsdata package index with the version pinned.

Set the index first. This is needed whichever installer you use:

export PIP_EXTRA_INDEX_URL=https://pypi.tabsdata.com/simple/
export UV_INDEX=https://pypi.tabsdata.com/simple/
export UV_INDEX_STRATEGY=unsafe-best-match

Then install the Tabsdata agent if you have not done so yet:

uv

uv pip install tabsdata-agent==2.0.0

pip

pip install tabsdata-agent==2.0.0

Install Tabsdata covers this as part of the full install, so skip this if you followed that page. These additional steps will not be required once Tabsdata 2.0.0 is on PyPI.

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 -