# 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:

   ```bash
   claude plugin marketplace add altertable-ai/skills
   ```

3. Install the plugin:

   ```bash
   claude plugin install altertable@altertable-ai
   ```

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

5. Ask Claude to analyze a real workflow:

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

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:

```text
Use Altertable to list my available catalogs.
```

Claude should call `initialize` first and then inspect the catalogs.

## Tools

Use the router when you are unsure which skill applies:

```text
/altertable:ask <your question>
```

### When to add the CLI

The plugin already provides [Altertable Skills](/docs/agent-setup.md#skills-included) and [Altertable MCP](/docs/query-data/mcp.md). Install the [Altertable CLI](/docs/developer-tooling/cli.md) 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:

```bash
claude plugin marketplace update altertable-ai
```

## 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.