Set up Claude Code

The Altertable Claude plugin installs Altertable Skills and registers the hosted MCP server.

Quick start

1. Open Claude Code from the root of the project where you want to use Altertable.

2. Add the Altertable marketplace:

   Copy
   claude plugin marketplace add altertable-ai/skills

3. Install the plugin:

   Copy
   claude plugin install altertable@altertable-skills

4. Start a new Claude Code session so it discovers the plugin.

5. Ask Claude to analyze a real workflow:

   /altertable:ask analyze my signup funnel from landing page to account creation
   Copy

The first Altertable tool call opens OAuth authorization in your browser. Choose the organization and environment Claude should access, then return to Claude Code.

Verify

Open /plugin and confirm that Altertable is installed. Its entry includes the installed plugin version. Open /mcp to list configured servers, connect to Altertable, or inspect connection errors. Then ask:

Use Altertable to list my available catalogs.
Copy

Claude should call initialize first and then inspect the catalogs.

Tools

Use the router when you are unsure which skill applies:

/altertable:ask <your question>
Copy

When to add the CLI

The plugin already provides Altertable Skills and Altertable MCP. Install the Altertable CLI only when Claude needs to run Altertable from the shell, such as in CI, ingestion workflows, or scripts that consume JSON. Claude can use the CLI alongside MCP.

Update

Each plugin release is versioned. Check the installed version with /plugin, then refresh the marketplace when a new Altertable Skills release is available:

Copy
claude plugin marketplace update altertable-skills

Troubleshooting

• Plugin is missing: open /plugin, confirm that the Altertable marketplace is present, then reinstall the plugin.
• Skills do not appear: start a new Claude Code session after installation or update.
• MCP tools do not appear: open /mcp to inspect or reconnect the Altertable server, or run claude mcp list from the shell. Reinstall the plugin if the server is missing.
• Authorization does not finish: complete the browser flow opened by Claude and choose an organization and environment.
• Wrong environment is connected: disconnect the MCP server and authorize it again with the correct environment.
• Claude Code has broader installation problems: run /doctor for general diagnostics.