> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artifacta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Install as a Claude Code Plugin

> Install Artifacta as a Claude Code plugin — the hosted MCP connection plus the persisting-outputs and capture-transcript skills, wired up with two commands.

The **Claude Code plugin** is the recommended path for Claude Code users. It
adds Artifacta's hosted MCP server the same way as the
[hosted endpoint](/mcp/install/claude-code-hosted) — one URL, OAuth, no API
key — and bundles two skills that teach Claude Code when and how to persist
run outputs to Artifacta and capture a session transcript, so you get the
behavior without writing the prompt yourself.

<Note>
  The plugin and the plain [hosted MCP connection](/mcp/install/claude-code-hosted)
  expose the **same Artifacta tools** over the same OAuth flow. The plugin adds
  two things on top: the `persisting-outputs` and `capture-transcript` skills.
  If you already connected via `claude mcp add --transport http artifacta …` you
  do not need the plugin too — install it only if you want the skills. For CI,
  restricted networks, or explicit credential control, use the local stdio
  package instead: see [Install in Claude Code (stdio)](/mcp/install/claude-code).
  Codex users should follow the separate [Codex plugin guide](/mcp/install/codex-plugin).
</Note>

## Prerequisites

* **Claude Code** installed (`claude --version`).
* **A free Artifacta account.** Sign up at
  [app.artifacta.io/signup](https://app.artifacta.io/signup) — you log in with
  this account during the OAuth step below.

Nothing else. There is no package to install and no API key to create.

## Install — two commands

Inside a Claude Code session (these are Claude Code slash commands, not shell
commands), add the marketplace, then install the plugin from it:

```text theme={null}
/plugin marketplace add SagaPeak/artifacta-mcp
/plugin install artifacta@artifacta
```

The first command registers `SagaPeak/artifacta-mcp` as a plugin marketplace
(marketplace ID `artifacta`). The second installs the `artifacta` plugin from
that marketplace, which wires up the hosted MCP server
(`https://mcp.artifacta.io/mcp`) and both skills in one step — no manual
`.mcp.json` edits.

## What you get

* **The full hosted Artifacta MCP tool surface** — `whoami`, `store_artifact`,
  `list_artifacts`, `create_download_link`, and the rest, gated by the same
  read / write / destroy consent tiers as the plain hosted connection (see
  [Permissions](/mcp/install/claude-code-hosted#permissions)).
* **The `persisting-outputs` skill** (`plugin/skills/persisting-outputs/SKILL.md`
  in the plugin). Invoke it explicitly with `/artifacta:persisting-outputs`, or
  let it auto-trigger — Claude Code reaches for it whenever a session produces
  outputs (files, reports, datasets, build results) worth saving, and it drives
  the `store_artifact` / `request_upload_url` + `complete_upload` tools for
  you.
* **The `capture-transcript` skill** (`plugin/skills/capture-transcript/SKILL.md`
  in the plugin). Ask in natural language — e.g. *"use artifacta to upload this
  session's transcript"* — and it locates and verifies the live Claude Code
  session transcript, pushes a snapshot, and can offer to set up automatic
  SessionEnd capture. See the
  [session transcript guide](/guides/transcripts) for the underlying recipe.

Both skills stamp model provenance: `persisting-outputs` instructs the agent
to always pass `model` (a declared producer claim), and `capture-transcript`
stamps `metadata.model` from the session transcript itself with
`metadata.model_source=transcript` (a captured producer claim) — see
[model capture](/guides/transcripts#model-capture).

## Authenticate

Installing the plugin does not log you in — like the plain hosted connection,
Artifacta needs a one-time browser OAuth login before its tools are usable.

<Steps>
  <Step title="Run /mcp">
    In a Claude Code session, type `/mcp`, select **artifacta** from the list,
    and choose **Authenticate**.
  </Step>

  <Step title="Log in and consent">
    Claude Code opens your browser to Artifacta. Sign in with your account,
    then on the **consent screen** tick the permissions you want to grant
    (read / write / destroy) and click **Authorize**.
  </Step>

  <Step title="Done">
    The browser redirects to a local loopback callback — a brief "you may
    close this tab" page is expected. Return to Claude Code; `/mcp` shows
    **artifacta** as connected, and the granted tools plus the
    `persisting-outputs` and `capture-transcript` skills are available in the
    session.
  </Step>
</Steps>

Confirm the connection with a smoke prompt:

> "What's my Artifacta plan?"

Claude Code calls the `whoami` tool (available at every permission tier) and
reports your tenant, plan, and usage.

## Updating

Marketplace metadata is cached locally. Pull the latest plugin version with:

```text theme={null}
/plugin marketplace update artifacta
```

The plugin manifest uses semantic versions. The current release is `1.1.0`;
updating the marketplace pulls the latest published manifest and package.

## Uninstalling

```text theme={null}
/plugin uninstall artifacta@artifacta
```

This removes the plugin, its MCP server registration, and the
`persisting-outputs` and `capture-transcript` skills from Claude Code. It does
not revoke the OAuth grant on Artifacta's side — do that from
[app.artifacta.io](https://app.artifacta.io) if you're removing access
entirely, or run `claude mcp logout artifacta` first if you plan to
reconnect without the plugin.

## What's next

* **[Install in Claude Code (Hosted)](/mcp/install/claude-code-hosted)** — the
  same hosted OAuth connection without the plugin wrapper or skills, if you
  want to manage the MCP server entry yourself.
* **[Install in Claude Code (stdio)](/mcp/install/claude-code)** — the local
  package with an `ak_live_` API key, for CI, restricted networks, and
  explicit credential control.
* **[Install as a Codex plugin](/mcp/install/codex-plugin)** — the same hosted
  OAuth MCP connection and skills, with verified Codex transcript capture.
* **[MCP overview](/mcp/overview)** — the full tool and resource surface,
  shared by hosted, stdio, and the plugin.